ObjectLoader.html 6.1 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223
  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. A loader for loading a JSON resource in the [link:https://github.com/mrdoob/three.js/wiki/JSON-Object-Scene-format-4 JSON Object/Scene format].<br /><br />
  14. 此加载器内部使用[page:FileLoader]进行加载文件。
  15. </p>
  16. <h2>例子</h2>
  17. <p>
  18. [example:webgl_loader_json_claraio WebGL / loader / json / claraio]<br />
  19. [example:webgl_materials_lightmap WebGL / materials / lightmap]
  20. </p>
  21. <code>
  22. var loader = new THREE.ObjectLoader();
  23. loader.load(
  24. // 资源的URL
  25. "models/json/example.json",
  26. // onLoad回调
  27. // Here the loaded data is assumed to be an object
  28. function ( obj ) {
  29. // Add the loaded object to the scene
  30. scene.add( obj );
  31. },
  32. // onProgress回调
  33. function ( xhr ) {
  34. console.log( (xhr.loaded / xhr.total * 100) + '% loaded' );
  35. },
  36. // onError回调
  37. function ( err ) {
  38. console.error( 'An error happened' );
  39. }
  40. );
  41. // 或者,解析先前加载的JSON结构
  42. var object = loader.parse( a_json_object );
  43. scene.add( object );
  44. </code>
  45. <h2>构造函数</h2>
  46. <h3>[name]( [param:LoadingManager manager] )</h3>
  47. <p>
  48. [page:LoadingManager manager] — 加载器所使用的[page:LoadingManager loadingManager],默认值为[page:LoadingManager THREE.DefaultLoadingManager].<br /><br />
  49. 创建一个新的[name].
  50. </p>
  51. <h2>属性</h2>
  52. <h3>[property:String crossOrigin]</h3>
  53. <p>
  54. 如果设置了,在开始加载前, 将为图片分配 [link:https://developer.mozilla.org/en-US/docs/Web/HTML/CORS_settings_attributes crossOrigin]
  55. 属性,其值为 *crossOrigin*, 默认为"anonymous"。
  56. </p>
  57. <h3>[property:LoadingManager manager]</h3>
  58. <p>
  59. 加载器正在使用的[page:LoadingManager loadingManager],默认值为[page:DefaultLoadingManager]。
  60. </p>
  61. <h3>[property:String texturePath]</h3>
  62. <p>
  63. 将要被加载的纹理的路径或者URL,详情请参考[page:.setTexturePath]。
  64. 默认值为空字符串。
  65. </p>
  66. <h2>方法</h2>
  67. <h3>[method:null load]( [param:String url], [param:Function onLoad], [param:Function onProgress], [param:Function onError] )</h3>
  68. <p>
  69. [page:String url] — 文件的URL或者路径,也可以为
  70. [link:https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/Data_URIs Data URI].<br />
  71. [page:Function onLoad] — 加载完成时将调用。回调参数为将要加载的[page:Object3D object].<br />
  72. [page:Function onProgress] — 将在加载过程中进行调用。参数为XMLHttpRequest实例,实例包含[page:Integer total]和[page:Integer loaded]字节。<br />
  73. [page:Function onError] — 在加载错误时被调用。<br />
  74. </p>
  75. <p>
  76. 从URL中进行加载,并将被解析的响应内容传递给onLoad。
  77. </p>
  78. <h3>[method:Object3D parse]( [param:Object json], [param:Function onLoad] )</h3>
  79. <p>
  80. [page:Object json] — 必选参数,需要被解析的JSON源。<br /><br />
  81. [page:Function onLoad] — 当解析完成时被调用,其中参数被解析为[page:Object3D object].<br /><br />
  82. 解析一个<em>JSON</em>结构,并返回一个threejs对象.
  83. 内部使用[page:.load]进行加载, 但也可以直接用于解析先前加载的JSON结构。
  84. </p>
  85. <h3>[method:Object3D parseGeometries]( [param:Object json] )</h3>
  86. <p>
  87. [page:Object json] — 必选参数,需要被解析的JSON源。<br /><br />
  88. 此函数以JSON结构,用[page:.parse]去解析[page:Geometry geometries]或[page:BufferGeometry buffer geometries]。
  89. </p>
  90. <h3>[method:Object3D parseMaterials]( [param:Object json] )</h3>
  91. <p>
  92. [page:Object json] — 必选参数,需要被解析的JSON源。<br /><br />
  93. 此函数通过[page:.parse]来使用[page:MaterialLoader],以解析JSON结构中任意材质。
  94. </p>
  95. <h3>[method:Object3D parseAnimations]( [param:Object json] )</h3>
  96. <p>
  97. [page:Object json] — 必选参数,需要被解析的JSON源。<br /><br />
  98. 此函数通过[page:.parse]来使用[page:AnimationClip.parse], 以解析JSON结构中任意动画。
  99. </p>
  100. <h3>[method:Object3D parseImages]( [param:Object json] )</h3>
  101. <p>
  102. [page:Object json] — 必选参数,需要被解析的JSON源。<br /><br />
  103. 此函数通过[page:.parse]来使用[page:ImageLoader], 以解析JSON结构中任意图片。
  104. </p>
  105. <h3>[method:Object3D parseTextures]( [param:Object json] )</h3>
  106. <p>
  107. [page:Object json] — 必选参数,需要被解析的JSON源。<br /><br />
  108. 此函数通过[page:.parse]来解析JSON结构中任意纹理。
  109. </p>
  110. <h3>[method:Object3D parseObject]( [param:Object json] )</h3>
  111. <p>
  112. [page:Object json] — 必选参数,需要被解析的JSON源。<br /><br />
  113. 此函数通过[page:.parse]来解析JSON结构中任意对象。
  114. 对象可以为如下类型:
  115. <ul>
  116. <li>
  117. [page:Scene]
  118. </li>
  119. <li>
  120. [page:PerspectiveCamera]
  121. </li>
  122. <li>
  123. [page:OrthographicCamera]
  124. </li>
  125. <li>
  126. [page:AmbientLight]
  127. </li>
  128. <li>
  129. [page:DirectionalLight]
  130. </li>
  131. <li>
  132. [page:PointLight]
  133. </li>
  134. <li>
  135. [page:SpotLight]
  136. </li>
  137. <li>
  138. [page:HemisphereLight]
  139. </li>
  140. <li>
  141. [page:Mesh]
  142. </li>
  143. <li>
  144. [page:LOD]
  145. </li>
  146. <li>
  147. [page:Line]
  148. </li>
  149. <li>
  150. [page:LineSegments]
  151. </li>
  152. <li>
  153. [page:Points]
  154. </li>
  155. <li>
  156. [page:Sprite]
  157. </li>
  158. <li>
  159. [page:Group]
  160. </li>
  161. <li>
  162. [page:Object3D]
  163. </li>
  164. </ul>
  165. </p>
  166. <h3>[method:ObjectLoader setCrossOrigin]( [param:String value] )</h3>
  167. <p>
  168. [page:String value] — 在允许CROS时,跨域字段通过实现CORS来加载不同域下的URL。
  169. </p>
  170. <h3>[method:ObjectLoader setTexturePath]( [param:String value] )</h3>
  171. <p>
  172. [page:String value] — 设置将要加载为纹理的路径或者URL<br /><br />
  173. </p>
  174. <h2>源</h2>
  175. [link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
  176. </body>
  177. </html>