BasisTextureLoader
Loader for Basis Universal GPU Texture Codec.
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 examples/js/libs/basis directory.
代码示例
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.
Constructor
BasisTextureLoader( manager : LoadingManager )
manager — The LoadingManager for the loader to use. Default is THREE.DefaultLoadingManager.
Creates a new BasisTextureLoader.
Properties
See the base Loader class for common properties.
Methods
See the base Loader class for common methods.
.load ( url : String, onLoad : Function, onProgress : Function, onError : Function ) : null
url — A string containing the path/URL of the .basis file.
onLoad — A function to be called after the loading is successfully completed.
onProgress — (optional) A function to be called while the loading is in progress. The argument will be the XMLHttpRequest instance, that contains .total and .loaded bytes.
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 CompressedTexture.
.detectSupport ( renderer : WebGLRenderer ) : this
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.
.setTranscoderPath ( path : String ) : this
path — Path to folder containing the WASM transcoder and JS wrapper.
The WASM transcoder and JS wrapper are available from the examples/js/libs/basis directory.
.setWorkerLimit ( limit : Number ) : this
limit — Maximum number of workers. Default is '4'.
Sets the maximum number of web workers to be allocated by this instance.
.dispose () : this
Disposes the loader object, de-allocating any Web Workers created.