ImageBitmapLoader.html 3.5 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106
  1. <!DOCTYPE html>
  2. <html lang="en">
  3. <head>
  4. <meta charset="utf-8" />
  5. <base href="../../../" />
  6. <script src="list.js"></script>
  7. <script src="page.js"></script>
  8. <link type="text/css" rel="stylesheet" href="page.css" />
  9. </head>
  10. <body>
  11. <h1>[name]</h1>
  12. <p class="desc">
  13. 一个把[page:Image]加载为[link:https://developer.mozilla.org/de/docs/Web/API/ImageBitmap ImageBitmap]的加载器。
  14. ImageBitmap提供了一种异步且有效的资源的途径,用于在WebGL中渲染的纹理。<br/>
  15. 不像[page:FileLoader], [name]无需避免对同一的URL进行多次请求。
  16. </p>
  17. <h2>例子</h2>
  18. <p>
  19. [example:webgl_loader_imagebitmap WebGL / loader / ImageBitmap]
  20. </p>
  21. <code>
  22. // 初始化一个加载器
  23. var loader = new THREE.ImageBitmapLoader();
  24. // 加载一个图片资源
  25. loader.load(
  26. // 资源的URL
  27. 'textures/skyboxsun25degtest.png',
  28. // onLoad回调
  29. function ( imageBitmap ) {
  30. var texture = new THREE.CanvasTexture( imageBitmap );
  31. var material = new THREE.MeshBasicMaterial( { map: texture } );
  32. },
  33. // 目前暂不支持onProgress的回调
  34. undefined,
  35. // onError回调
  36. function ( err ) {
  37. console.log( 'An error happened' );
  38. }
  39. );
  40. </code>
  41. <h2>构造函数</h2>
  42. <h3>[name]( [param:LoadingManager manager] )</h3>
  43. <p>
  44. [page:LoadingManager manager] — 加载器使用的[page:LoadingManager loadingManager],默认为[page:LoadingManager THREE.DefaultLoadingManager].<br /><br />
  45. 创建一个新的[name].
  46. </p>
  47. <h2>属性</h2>
  48. <h3>[property:LoadingManager manager]</h3>
  49. <p>
  50. 加载器正在使用的[page:LoadingManager loadingManager] ,默认为[page:DefaultLoadingManager].
  51. </p>
  52. <h3>[property:String options]</h3>
  53. <p>一个可选对象,用来设置内部使用的[link:https://developer.mozilla.org/en-US/docs/Web/API/WindowOrWorkerGlobalScope/createImageBitmap createImageBitmap]工厂方法,
  54. 默认为*undefined*.</p>
  55. <h3>[property:String path]</h3>
  56. <p>所要加载文件的基本路径。 请参考[page:.setPath],默认为*undefined*。</p>
  57. <h2>方法</h2>
  58. <h3>[method:null load]( [param:String url], [param:Function onLoad], [param:Function onProgress], [param:Function onError] )</h3>
  59. <p>
  60. [page:String url] — 文件的URL或者路径,也可以为
  61. [link:https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/Data_URIs Data URI].<br />
  62. [page:Function onLoad] — 加载完成时将调用。回调参数为将要加载的[page:Image image].<br />
  63. [page:Function onProgress] — 此回调函数暂时不支持<br />
  64. [page:Function onError] — 在加载错误时被调用。<br />
  65. </p>
  66. <p>
  67. 从URL中进行加载,并返回将包含数据的[page:ImageBitmap image]对象。
  68. </p>
  69. <h3>[method:ImageBitmapLoader setCrossOrigin]()</h3>
  70. <p>此方法出于兼容性原因而存在,并且不实现逻辑。它确保[name]具有[page:ImageLoader]的类似接口。</p>
  71. <h3>[method:ImageBitmapLoader setOptions]( [param:Object options] )</h3>
  72. <p>
  73. 设置[link:https://developer.mozilla.org/en-US/docs/Web/API/WindowOrWorkerGlobalScope/createImageBitmap createImageBitmap]的选项对象。
  74. </p>
  75. <h3>[method:ImageBitmapLoader setPath]( [param:String path] )</h3>
  76. <p>
  77. 设置加载文件的基本路径或URL。当加载同一目录中下的许多图片时,此方法将很有用。
  78. </p>
  79. <h2>源</h2>
  80. [link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
  81. </body>
  82. </html>