Skip to content

KTX2Loader: Use relative file urls by default. #33603

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
gkjohnson merged 3 commits into from
May 19, 2026
Merged

KTX2Loader: Use relative file urls by default. #33603

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
ee6ba9d
Update KTX2 urls
gkjohnson May 19, 2026
1116ae3
KTX2Loader: Make decoder path optional
gkjohnson May 19, 2026
9d0a155
Remove empty line
gkjohnson May 19, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 0 additions & 1 deletion examples/jsm/libs/basis/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -24,7 +24,6 @@ Both are dependencies of `KTX2Loader`:

```js
const ktx2Loader = new KTX2Loader();
ktx2Loader.setTranscoderPath( 'examples/jsm/libs/basis/' );
ktx2Loader.detectSupport( renderer );
ktx2Loader.load( 'diffuse.ktx2', function ( texture ) {

Expand Down
33 changes: 24 additions & 9 deletions examples/jsm/loaders/KTX2Loader.js
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -103,6 +103,9 @@ import {
import { ZSTDDecoder } from '../libs/zstddec.module.js';
import { DisplayP3ColorSpace, LinearDisplayP3ColorSpace } from '../math/ColorSpaces.js';

const WASM_BIN_URL = new URL( '../libs/basis/basis_transcoder.wasm', import.meta.url ).toString();
const WASM_JS_URL = new URL( '../libs/basis/basis_transcoder.js', import.meta.url ).toString();

const _taskCache = new WeakMap();

let _activeLoaders = 0;
Expand Down Expand Up @@ -169,9 +172,9 @@ class KTX2Loader extends Loader {
}

/**
* Sets the transcoder path.
* Sets the transcoder path to optionally set the decoder load path from a CDN.
*
* The WASM transcoder and JS wrapper are available from the `examples/jsm/libs/basis` directory.
* By default The WASM transcoder and JS wrapper are loaded from the `examples/jsm/libs/basis` directory.
*
* @param {string} path - The transcoder path to set.
* @return {KTX2Loader} A reference to this loader.
Expand Down Expand Up @@ -280,18 +283,30 @@ class KTX2Loader extends Loader {

if ( ! this.transcoderPending ) {

// Load transcoder wrapper.
const jsLoader = new FileLoader( this.manager );
jsLoader.setPath( this.transcoderPath );
jsLoader.setWithCredentials( this.withCredentials );
const jsContent = jsLoader.loadAsync( 'basis_transcoder.js' );

// Load transcoder WASM binary.
const binaryLoader = new FileLoader( this.manager );
binaryLoader.setPath( this.transcoderPath );
binaryLoader.setResponseType( 'arraybuffer' );
binaryLoader.setWithCredentials( this.withCredentials );
const binaryContent = binaryLoader.loadAsync( 'basis_transcoder.wasm' );
binaryLoader.setResponseType( 'arraybuffer' );

let jsContent, binaryContent;
if ( this.transcoderPath === '' ) {

jsContent = jsLoader.loadAsync( WASM_JS_URL );
binaryContent = binaryLoader.loadAsync( WASM_BIN_URL );

} else {

// Load transcoder wrapper.
jsLoader.setPath( this.transcoderPath );
jsContent = jsLoader.loadAsync( 'basis_transcoder.js' );

// Load transcoder WASM binary.
binaryLoader.setPath( this.transcoderPath );
binaryContent = binaryLoader.loadAsync( 'basis_transcoder.wasm' );

}

this.transcoderPending = Promise.all( [ jsContent, binaryContent ] )
.then( ( [ jsContent, binaryContent ] ) => {
Expand Down
1 change: 0 additions & 1 deletion examples/misc_exporter_gltf.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -489,7 +489,6 @@
// Exporting compressed textures and meshes (KTX2 / Draco / Meshopt)
// ---------------------------------------------------------------------
const ktx2Loader = new KTX2Loader()
.setTranscoderPath( 'jsm/libs/basis/' )
.detectSupport( renderer );

const gltfLoader = new GLTFLoader().setPath( 'models/gltf/' );
Expand Down
2 changes: 1 addition & 1 deletion examples/misc_exporter_usdz.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -90,7 +90,7 @@
scene.background = new THREE.Color( 0xf0f0f0 );
scene.environment = pmremGenerator.fromScene( new RoomEnvironment(), 0.04 ).texture;

const ktx2loader = new KTX2Loader().setTranscoderPath( 'jsm/libs/basis/' ).detectSupport( renderer );
const ktx2loader = new KTX2Loader().detectSupport( renderer );
const dracoLoader = new DRACOLoader().setDecoderPath( 'jsm/libs/draco/' );
const gltfLoader = new GLTFLoader();

Expand Down
1 change: 0 additions & 1 deletion examples/webgl_loader_gltf_animation_pointer.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -88,7 +88,6 @@


const ktx2Loader = new KTX2Loader()
.setTranscoderPath( 'jsm/libs/basis/' )
.detectSupport( renderer );

const loader = new GLTFLoader();
Expand Down
1 change: 0 additions & 1 deletion examples/webgl_loader_gltf_compressed.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -73,7 +73,6 @@
scene.add( grid );

const ktx2Loader = new KTX2Loader()
.setTranscoderPath( 'jsm/libs/basis/' )
.detectSupport( renderer );

const loader = new GLTFLoader().setPath( 'models/gltf/' );
Expand Down
1 change: 0 additions & 1 deletion examples/webgl_loader_texture_ktx2.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -150,7 +150,6 @@
renderer.setPixelRatio( window.devicePixelRatio );

const loader = new KTX2Loader()
.setTranscoderPath( 'jsm/libs/basis/' )
.setPath( 'textures/ktx2/' )
.detectSupport( renderer );

Expand Down
1 change: 0 additions & 1 deletion examples/webgl_materials_envmaps_fasthdr.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -109,7 +109,6 @@
scene.add( sphere05 );

const loader = new KTX2Loader()
.setTranscoderPath( 'jsm/libs/basis/' )
.detectSupport( renderer );

function loadTexture( url ) {
Expand Down
1 change: 0 additions & 1 deletion examples/webgl_morphtargets_face.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -73,7 +73,6 @@
container.appendChild( renderer.domElement );

const ktx2Loader = new KTX2Loader()
.setTranscoderPath( 'jsm/libs/basis/' )
.detectSupport( renderer );

new GLTFLoader()
Expand Down
1 change: 0 additions & 1 deletion examples/webgl_morphtargets_webcam.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -130,7 +130,6 @@
const eyeRotationLimit = THREE.MathUtils.degToRad( 30 );

const ktx2Loader = new KTX2Loader()
.setTranscoderPath( 'jsm/libs/basis/' )
.detectSupport( renderer );

new GLTFLoader()
Expand Down
1 change: 0 additions & 1 deletion examples/webgl_texture2darray_compressed.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -101,7 +101,6 @@
//

const ktx2Loader = new KTX2Loader();
ktx2Loader.setTranscoderPath( 'jsm/libs/basis/' );
ktx2Loader.detectSupport( renderer );

ktx2Loader.load( 'textures/spiritedaway.ktx2', function ( texturearray ) {
Expand Down
1 change: 0 additions & 1 deletion examples/webgl_texture2darray_layerupdate.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -98,7 +98,6 @@
// Configure the KTX2 loader.

const ktx2Loader = new KTX2Loader();
ktx2Loader.setTranscoderPath( 'jsm/libs/basis/' );
ktx2Loader.detectSupport( renderer );

// Load several KTX2 textures which will later be used to modify
Expand Down
1 change: 0 additions & 1 deletion examples/webgpu_loader_gltf_compressed.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -82,7 +82,6 @@
controls.update();

const ktx2Loader = await new KTX2Loader()
.setTranscoderPath( 'jsm/libs/basis/' )
.detectSupport( renderer );

const loader = new GLTFLoader();
Expand Down
1 change: 0 additions & 1 deletion examples/webgpu_loader_texture_ktx2.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -152,7 +152,6 @@
await renderer.init();

const loader = new KTX2Loader()
.setTranscoderPath( 'jsm/libs/basis/' )
.setPath( 'textures/ktx2/' )
.detectSupport( renderer );

Expand Down
1 change: 0 additions & 1 deletion examples/webgpu_morphtargets_face.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -77,7 +77,6 @@
scene.environment = pmremGenerator.fromScene( environment, 0.04 ).texture;

const ktx2Loader = await new KTX2Loader()
.setTranscoderPath( 'jsm/libs/basis/' )
.detectSupport( renderer );

new GLTFLoader()
Expand Down
1 change: 0 additions & 1 deletion examples/webgpu_sandbox.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -79,7 +79,6 @@
textureDisplace.wrapT = THREE.RepeatWrapping;

const ktxLoader = await new KTX2Loader()
.setTranscoderPath( 'jsm/libs/basis/' )
.detectSupport( renderer );

const ktxTexture = await ktxLoader.loadAsync( './textures/ktx2/2d_uastc.ktx2' );
Expand Down
1 change: 0 additions & 1 deletion examples/webgpu_textures_2d-array_compressed.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -83,7 +83,6 @@
//

const ktx2Loader = new KTX2Loader();
ktx2Loader.setTranscoderPath( 'jsm/libs/basis/' );
ktx2Loader.detectSupport( renderer );

ktx2Loader.load( 'textures/spiritedaway.ktx2', function ( texturearray ) {
Expand Down