Skip to content

Open-source platform for 3D AI agents. Turn text or a photo into a rigged, animated GLB avatar, give it an LLM brain, memory and a wallet, and embed it anywhere with one web component. Remote MCP server, x402 payments, Three.js, browser-native.

5.0 KB
Raw Blame
import { KtxDecoder } from "./ktx";

export class KTXTools{
    constructor(){
        this.ktxEncoder = null;
        this.libktx = null;
        this.unavailableReason = null;
        // Kept as a promise so compress() can await the encoder instead of
        // racing it, and so a missing libktx never becomes an unhandled
        // rejection at import time.
        this.ready = this.init();
    }

    async init() {
        const canvasWebgl = document.createElement('canvas');
        const gl = canvasWebgl.getContext('webgl'); // WebGL context is needed for KTX operations
        if (!gl) {
            this.unavailableReason = 'no WebGL context available for the KTX encoder';
            return false;
        }
        if (typeof window.LIBKTX !== 'function') {
            this.unavailableReason = 'libktx.js did not load (expected the LIBKTX global from /avatar-studio/ktx2/libktx.js)';
            return false;
        }
        try {
            const ktxEncoder = new KtxDecoder(gl, window.LIBKTX);
            await ktxEncoder.init(gl, window.LIBKTX);
            this.ktxEncoder = ktxEncoder;
            this.libktx = ktxEncoder.libktx;
            return true;
        } catch (err) {
            this.unavailableReason = `libktx failed to initialize: ${err?.message || err}`;
            return false;
        }
    }

    async compress(raw_data, width, height, comps, options = {}){
        if (!(await this.ready)) {
            throw new Error(`KTX2 compression is unavailable: ${this.unavailableReason}. Export again with KTX compression turned off.`);
        }
        const basisu_options = await new this.libktx.ktxBasisParams();
        const userBasisuOptions = options;

        basisu_options.uastc = userBasisuOptions.uastc !== undefined ? userBasisuOptions.uastc : false;
        basisu_options.noSSE = userBasisuOptions.noSSE !== undefined ? userBasisuOptions.noSSE : false;
        basisu_options.verbose = userBasisuOptions.verbose !== undefined ? userBasisuOptions.verbose :  false;
        basisu_options.normalMap = userBasisuOptions.normalMap !== undefined ? userBasisuOptions.normalMap :  false;

        basisu_options.compressionLevel = userBasisuOptions.compressionLevel !== undefined ? userBasisuOptions.compressionLevel : 1;
        basisu_options.qualityLevel = userBasisuOptions.qualityLevel !== undefined ? userBasisuOptions.qualityLevel : 60;
        

        //== ETC1S ==
        basisu_options.maxEndpoints = userBasisuOptions.ETC1SmaxEndpoints !== undefined ?userBasisuOptions.ETC1SmaxEndpoints : 0;
        basisu_options.endpointRDOThreshold = userBasisuOptions.ETC1SEndpointRdoThreshold !== undefined ? userBasisuOptions.ETC1SEndpointRdoThreshold : 1.25;
        basisu_options.maxSelectors = userBasisuOptions.ETC1SMaxSelectors !== undefined ? userBasisuOptions.ETC1SMaxSelectors : 0;
        basisu_options.selectorRDOThreshold = userBasisuOptions.ETC1SSelectorRdoThreshold !== undefined ? userBasisuOptions.ETC1SSelectorRdoThreshold : 1.25;
        // basisu_options.normalMap = targetKTX2_ETC1S_normalMap;
        // basisu_options.preSwizzle = false;
        basisu_options.noEndpointRDO = userBasisuOptions.ETC1SNoEndpointRdo !== undefined ? userBasisuOptions.ETC1SNoEndpointRdo : false;
        basisu_options.noSelectorRDO = userBasisuOptions.ETC1SNoSelectorRdo !== undefined ? userBasisuOptions.ETC1SNoSelectorRdo : false;


        //== UASTC ==
        basisu_options.uastcFlags = this.ktxEncoder.stringToUastcFlags(userBasisuOptions.uastcFlags);
        basisu_options.uastcRDO = basisu_options.uastcRDO !== undefined ? basisu_options.uastcRDO : false;
        basisu_options.uastcRDOQualityScalar = userBasisuOptions.uastcRDOQualityScalar !== undefined ? userBasisuOptions.uastcRDOQualityScalar : 1.0;
        basisu_options.uastcRDODictSize = userBasisuOptions.uastcRDODictSize !== undefined ? userBasisuOptions.uastcRDOQualityScalar : 4096;
        basisu_options.uastcRDOMaxSmoothBlockErrorScale = userBasisuOptions.uastcRDOMaxSmoothBlockErrorScale !== undefined? userBasisuOptions.uastcRDOMaxSmoothBlockErrorScale : 10.0;
        basisu_options.uastcRDOMaxSmoothBlockStdDev = userBasisuOptions.uastcRDOMaxSmoothBlockStdDev !== undefined? userBasisuOptions.uastcRDOMaxSmoothBlockStdDev : 18.0;
        basisu_options.uastcRDODontFavorSimplerModes = userBasisuOptions.uastcRDODontFavorSimplerModes !== undefined ? userBasisuOptions.uastcRDODontFavorSimplerModes : false;
                
        // missing
        //userBasisuOptions.ETC1SQualityLevel
        options.basisu_options = basisu_options;

        // supercmp_scheme
        if (!Object.prototype.hasOwnProperty.call(options, 'supercmp_scheme')){
            options.supercmp_scheme = this.libktx.SupercmpScheme.NONE;
        }
        else{
            options.supercmp_scheme = this.ktxEncoder.stringToSupercmpScheme(options.supercmp_scheme);
        }

        // if (!options.hasOwnProperty('compression_level')) {
        //     options.compression_level = 18;
        // }
        return await this.ktxEncoder.compress(raw_data, width, height, comps, options);
    }
}