[page:Loader] →


Loader for Basis Universal GPU Texture Codec.

[link:https://github.com/BinomialLLC/basis_universal/ Basis Universal] is a "supercompressed" GPU texture and texture video compression system that outputs a highly compressed intermediate file format (.basis) that can be quickly transcoded to a wide variety of GPU texture compression formats.

This loader parallelizes the transcoding process across a configurable number of web workers, before transferring the transcoded compressed texture back to the main thread. The required WASM transcoder and JS wrapper are available from the [link:https://github.com/mrdoob/three.js/tree/dev/examples/js/libs/basis examples/js/libs/basis] directory.

Code Example

const basisLoader = new BasisTextureLoader(); basisLoader.setTranscoderPath( 'examples/js/libs/basis/' ); basisLoader.detectSupport( renderer ); basisLoader.load( 'diffuse.basis', function ( texture ) { const material = new THREE.MeshStandardMaterial( { map: texture } ); }, function () { console.log( 'onProgress' ); }, function ( e ) { console.error( e ); } );



Browser compatibility

BasisTextureLoader transcodes input textures in '.basis' format to an appropriate compressed texture format for the target device, where possible. This allows the same source texture to be served across desktop, Android, and iOS devices, and transcoded into ASTC, DXT, ETC1, or PVRTC1. Other output formats may be supported in the future.

Transcoding to PVRTC1 (for iOS) requires square power-of-two textures.

This loader relies on ES6 Promises and Web Assembly, which are not supported in IE11.


[name]( [param:LoadingManager manager] )

[page:LoadingManager manager] — The [page:LoadingManager] for the loader to use. Default is [page:LoadingManager THREE.DefaultLoadingManager].

Creates a new [name].


See the base [page:Loader] class for common properties.


See the base [page:Loader] class for common methods.

[method:null load]( [param:String url], [param:Function onLoad], [param:Function onProgress], [param:Function onError] )

[page:String url] — A string containing the path/URL of the .basis file.
[page:Function onLoad] — A function to be called after the loading is successfully completed.
[page:Function onProgress] — (optional) A function to be called while the loading is in progress. The argument will be the XMLHttpRequest instance, that contains .[page:Integer total] and .[page:Integer loaded] bytes.
[page:Function onError] — (optional) A function to be called if an error occurs during loading. The function receives error as an argument.

Load from url and call the onLoad function with the transcoded [page:CompressedTexture].

[method:this detectSupport]( [param:WebGLRenderer renderer] )

[page:WebGLRenderer renderer] — A renderer instance.

Detects hardware support for available compressed texture formats, to determine the output format for the transcoder. Must be called before loading a texture.

[method:this setTranscoderPath]( [param:String path] )

[page:String path] — Path to folder containing the WASM transcoder and JS wrapper.

The WASM transcoder and JS wrapper are available from the [link:https://github.com/mrdoob/three.js/tree/dev/examples/js/libs/basis examples/js/libs/basis] directory.

[method:this setWorkerLimit]( [param:Number limit] )

[page:Number limit] — Maximum number of workers. Default is '4'.

Sets the maximum number of web workers to be allocated by this instance.

[method:this dispose]()

Disposes the loader object, de-allocating any Web Workers created.


[link:https://github.com/mrdoob/three.js/blob/master/examples/jsm/loaders/BasisTextureLoader.js examples/jsm/loaders/BasisTextureLoader.js]