[page:Loader] →

# KTX2加载器([name])

KTX 2.0 GPU 纹理容器的加载程序。
[link:http://github.khronos.org/KTX-Specification/ KTX 2.0] 是各种 GPU 纹理格式的容器格式。该加载器支持 Basis Universal GPU 纹理，可以快速转码为多种 GPU 纹理压缩格式。虽然 KTX 2.0 还允许其他特定于硬件的格式，但此加载程序尚未解析它们。

该加载程序解析 KTX 2.0 容器并将其转码为受支持的 GPU 压缩纹理格式。所需的 WASM 转码器和 JS 包装器可从 [link:https://github.com/mrdoob/three.js/tree/dev/examples/jsm/libs/basis examples/jsm/libs/basis] 目录中获取。

## 引入

[name] 是一个附加组件，必须显式导入。请参阅 [link:#manual/introduction/Installation Installation / Addons]。

`import { KTX2Loader } from 'three/addons/loaders/KTX2Loader.js';`

## 代码示例

`var ktx2Loader = new KTX2Loader(); ktx2Loader.setTranscoderPath( 'examples/jsm/libs/basis/' ); ktx2Loader.detectSupport( renderer ); ktx2Loader.load( 'diffuse.ktx2', function ( texture ) { var material = new THREE.MeshStandardMaterial( { map: texture } ); }, function () { console.log( 'onProgress' ); }, function ( e ) { console.error( e ); } );`

## 例子

[example:webgl_loader_texture_ktx2]

## 浏览器兼容性

该加载器依赖于旧版浏览器不支持的 Web Assembly。

## 构造函数

### [name]( [param:LoadingManager manager] )

[page:LoadingManager manager] — 供加载器使用的 [page:LoadingManager] 。默认值为 [page:LoadingManager THREE.DefaultLoadingManager]。

创建一个新的 [name]。

## 属性

有关常用属性，请参阅 [page:Loader] 基类

## Methods

有关常用方法，请参阅 [page:Loader] 基类

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

[page:String url] — 包含 `.ktx2` 文件路径/URL 的字符串。
[page:Function onLoad] — 加载成功完成后调用的函数。
[page:Function onProgress] — （可选）加载过程中调用的函数。参数将是 XMLHttpRequest 实例，其中包含 .[page:Integer total] 和 .[page:Integer loaded] 字节。如果服务器没有设置 Content-Length，.[page:Integer total] 将为 0。
[page:Function onError] — （可选）加载期间发生错误时调用的函数。该函数接收错误作为参数。

从 url 加载并在转码后 [page:CompressedTexture] 调用 `onLoad` 函数。

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

[page:WebGLRenderer renderer] — 渲染器实例。

检测可用压缩纹理格式的硬件支持，以确定转码器的输出格式。必须在加载纹理之前调用。

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

[page:String path] — 包含 WASM 转码器和 JS 包装器的文件夹路径。

WASM 转码器和 JS 包装器可从 [link:https://github.com/mrdoob/three.js/tree/dev/examples/jsm/libs/basis examples/jsm/libs/basis] 目录中获取。

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

[page:Number limit] — 最大 worker 数量。默认值为 '4'。

设置此实例要分配的最大 Web Worker 数量。

### [method:this dispose]()

处置加载器对象，取消分配创建的所有 Web Worker。

## 源代码

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