123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141 |
- <!DOCTYPE html>
- <html lang="zh">
- <head>
- <meta charset="utf-8" />
- <base href="../../../" />
- <script src="page.js"></script>
- <link type="text/css" rel="stylesheet" href="page.css" />
- </head>
- <body>
- [page:Loader] →
- <h1>KTX2加载器([name])</h1>
- <p class="desc">
- KTX 2.0 GPU 纹理容器的加载程序。<br><br>
- [link:http://github.khronos.org/KTX-Specification/ KTX 2.0] 是各种 GPU 纹理格式的容器格式。该加载器支持 Basis Universal GPU
- 纹理,可以快速转码为多种 GPU 纹理压缩格式。虽然 KTX 2.0 还允许其他特定于硬件的格式,但此加载程序尚未解析它们。
- </p>
- <p>
- 该加载程序解析 KTX 2.0 容器并将其转码为受支持的 GPU 压缩纹理格式。所需的 WASM 转码器和 JS 包装器可从
- [link:https://github.com/mrdoob/three.js/tree/dev/examples/jsm/libs/basis examples/jsm/libs/basis] 目录中获取。
- </p>
- <h2>导入</h2>
- <p>
- [name] 是一个附加组件,必须显式导入。请参阅 [link:#manual/introduction/Installation Installation / Addons]。
- </p>
- <code>
- import { KTX2Loader } from 'three/addons/loaders/KTX2Loader.js';
- </code>
- <h2>代码示例</h2>
- <code>
- 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 );
- } );
- </code>
- <h2>例子</h2>
- <p>
- [example:webgl_loader_texture_ktx2]
- </p>
- <h2>浏览器兼容性</h2>
- <p>
- 该加载器依赖于旧版浏览器不支持的 Web Assembly。
- </p>
- <br>
- <hr>
- <h2>构造函数</h2>
- <h3>[name]( [param:LoadingManager manager] )</h3>
- <p>
- [page:LoadingManager manager] — 供加载器使用的 [page:LoadingManager] 。默认值为 [page:LoadingManager
- THREE.DefaultLoadingManager]。
- </p>
- <p>
- 创建一个新的 [name]。
- </p>
- <h2>属性</h2>
- <p>有关常用属性,请参阅 [page:Loader] 基类</p>
- <h2>Methods</h2>
- <p>有关常用方法,请参阅 [page:Loader] 基类</p>
- <h3>[method:CompressedTexture load]( [param:String url], [param:Function onLoad], [param:Function onProgress],
- [param:Function onError] )</h3>
- <p>
- [page:String url] — 包含 `.ktx2` 文件路径/URL 的字符串。<br />
- [page:Function onLoad] — 加载成功完成后调用的函数。<br />
- [page:Function onProgress] — (可选)加载过程中调用的函数。参数将是 XMLHttpRequest 实例,其中包含 .[page:Integer total] 和 .[page:Integer
- loaded] 字节。如果服务器没有设置 Content-Length,.[page:Integer total] 将为 0。<br />
- [page:Function onError] — (可选)加载期间发生错误时调用的函数。该函数接收错误作为参数。<br />
- </p>
- <p>
- 从 url 加载并在转码后 [page:CompressedTexture] 调用 `onLoad` 函数。
- </p>
- <h3>[method:this detectSupport]( [param:WebGLRenderer renderer] )</h3>
- <p>
- [page:WebGLRenderer renderer] — 渲染器实例。
- </p>
- <p>
- 检测可用压缩纹理格式的硬件支持,以确定转码器的输出格式。必须在加载纹理之前调用。
- </p>
- <h3>[method:this setTranscoderPath]( [param:String path] )</h3>
- <p>
- [page:String path] — 包含 WASM 转码器和 JS 包装器的文件夹路径。
- </p>
- <p>
- WASM 转码器和 JS 包装器可从 [link:https://github.com/mrdoob/three.js/tree/dev/examples/jsm/libs/basis
- examples/jsm/libs/basis] 目录中获取。
- </p>
- <h3>[method:this setWorkerLimit]( [param:Number limit] )</h3>
- <p>
- [page:Number limit] — 最大 worker 数量。默认值为 '4'。
- </p>
- <p>
- 设置此实例要分配的最大 Web Worker 数量。
- </p>
- <h3>[method:this dispose]()</h3>
- <p>
- 处置加载器对象,取消分配创建的所有 Web Worker。
- </p>
- <h2>源代码</h2>
- <p>
- [link:https://github.com/mrdoob/three.js/blob/master/examples/jsm/loaders/KTX2Loader.js examples/jsm/loaders/KTX2Loader.js]
- </p>
- </body>
- </html>
|