CubeTextureLoader.html 3.7 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102
  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:CubeTexture CubeTexture]的一个类。
  14. 内部使用[page:ImageLoader]来加载文件。
  15. </p>
  16. <h2>例子</h2>
  17. <p>
  18. [example:webgl_materials_cubemap materials / cubemap]<br />
  19. [example:webgl_materials_cubemap_balls_reflection materials / cubemap / balls / reflection]<br />
  20. [example:webgl_materials_cubemap_balls_refraction materials / cubemap / balls / refraction]<br />
  21. [example:webgl_materials_cubemap_dynamic materials / cubemap / dynamic]<br />
  22. [example:webgl_materials_cubemap_dynamic2 materials / cubemap / dynamic2]<br />
  23. [example:webgl_materials_cubemap_refraction materials / cubemap / refraction]
  24. </p>
  25. <code>
  26. var scene = new THREE.Scene();
  27. scene.background = new THREE.CubeTextureLoader()
  28. .setPath( 'textures/cubeMaps/' )
  29. .load( [
  30. 'px.png',
  31. 'nx.png',
  32. 'py.png',
  33. 'ny.png',
  34. 'pz.png',
  35. 'nz.png'
  36. ] );
  37. </code>
  38. <h2>构造函数</h2>
  39. <h3>[name]( [param:LoadingManager manager] )</h3>
  40. <p>
  41. [page:LoadingManager manager] — 加载器使用的[page:LoadingManager loadingManager]。默认为[page:LoadingManager THREE.DefaultLoadingManager].<br /><br />
  42. 创建一个新的[name].
  43. </p>
  44. <h2>属性</h2>
  45. <h3>[property:String crossOrigin]</h3>
  46. <p>
  47. 如果设置了,在开始加载前, 将为图片分配 [link:https://developer.mozilla.org/en-US/docs/Web/HTML/CORS_settings_attributes crossOrigin]
  48. 属性,其值为 *crossOrigin*, 默认为"anonymous"。
  49. </p>
  50. <h3>[property:LoadingManager manager]</h3>
  51. <p>
  52. 加载器正在使用的[page:LoadingManager loadingManager]。默认为[page:DefaultLoadingManager]。
  53. </p>
  54. <h3>[property:String path]</h3>
  55. <p>加载加载的文件的基本路径。 请参考[page:.setPath]。默认为*undefined*.</p>
  56. <h2>方法</h2>
  57. <h3>[method:null load]( [param:String urls], [param:Function onLoad], [param:Function onProgress], [param:Function onError] )</h3>
  58. <p>
  59. [page:String urls] — 数组长度为6的图像数组,数组内容为URL,每一个URL用于CubeTexture的每一侧。
  60. 这些URL将被指定顺序: pos-x, neg-x, pos-y, neg-y, pos-z, neg-z.
  61. 数组内容也可以为 [link:https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/Data_URIs Data URIs].<br />
  62. 请注意,一般来说,在立方体贴图坐标系中,当查找positive-z轴时,positive-x表示右侧
  63. - 换句话说,此坐标系使用左手坐标系。
  64. 由于three.js使用右手坐标系, 环境贴图将在three.js进行pos-x和neg-x进行交互.<br />
  65. [page:Function onLoad] — 加载完成时将调用。回调参数是已被加载的[page:Texture texture].<br />
  66. [page:Function onProgress] — 将在加载过程中进行调用。参数为XMLHttpRequest实例,
  67. 其中包含 [page:Integer total] 和 [page:Integer loaded] 字节。<br />
  68. [page:Function onError] — 在加载错误时被调用。<br />
  69. </p>
  70. <p>
  71. 从URL中进行加载,并将被加载的[page:Texture texture]传递给onLoad。
  72. </p>
  73. <h3>[method:null setCrossOrigin]( [param:String value] )</h3>
  74. <p> 设置[page:.crossOrigin]的属性。</p>
  75. <h3>[method:FileLoader 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>