MaterialLoader.html 2.4 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687
  1. <!DOCTYPE html>
  2. <html lang="en">
  3. <head>
  4. <meta charset="utf-8" />
  5. <script src="../../list.js"></script>
  6. <script src="../../page.js"></script>
  7. <link type="text/css" rel="stylesheet" href="../../page.css" />
  8. </head>
  9. <body>
  10. <h1>[name]</h1>
  11. <div class="desc">A loader for loading a [page:Material] in JSON format.</div>
  12. <h2>Constructor</h2>
  13. <h3>[name]( [page:LoadingManager manager] )</h3>
  14. <div>
  15. [page:LoadingManager manager] — The [page:LoadingManager loadingManager] for the loader to use. Default is [page:LoadingManager THREE.DefaultLoadingManager].
  16. </div>
  17. <div>
  18. Creates a new [name].
  19. </div>
  20. <h2>Methods</h2>
  21. <h3>[method:null load]( [page:String url], [page:Function onLoad], [page:Function onProgress], [page:Function onError] )</h3>
  22. <div>
  23. [page:String url] — required<br />
  24. [page:Function onLoad] — Will be called when load completes. The argument will be the loaded [page:Material].<br />
  25. [page:Function onProgress] — Will be called while load progresses. The argument will be the progress event.<br />
  26. [page:Function onError] — Will be called when load errors.<br />
  27. </div>
  28. <div>
  29. Begin loading from url and return the [page:Material] object that will contain the data.
  30. </div>
  31. <h3>[method:null setCrossOrigin]( [page:String value] )</h3>
  32. <div>
  33. [page:String value] — The crossOrigin string.
  34. </div>
  35. <div>
  36. The crossOrigin string to implement CORS for loading the url from a different domain that allows CORS.
  37. </div>
  38. <h3>[method:Material parse]( [page:Object json] )</h3>
  39. <div>
  40. [page:Object json] — The json object containing the parameters of the Material.
  41. </div>
  42. <div>
  43. Parse a <em>JSON</em> structure and create a new [page:Material] of the type [page:String json.type] with parameters defined in the json object.
  44. </div>
  45. <h2>Example</h2>
  46. <code>
  47. // instantiate a loader
  48. var loader = new THREE.MaterialLoader();
  49. // load a resource
  50. loader.load(
  51. // resource URL
  52. 'path/to/material.json',
  53. // Function when resource is loaded
  54. function ( material ) {
  55. object.material = material;
  56. },
  57. // Function called when download progresses
  58. function ( xhr ) {
  59. console.log( (xhr.loaded / xhr.total * 100) + '% loaded' );
  60. },
  61. // Function called when download errors
  62. function ( xhr ) {
  63. console.log( 'An error happened' );
  64. }
  65. );
  66. </code>
  67. <h2>Source</h2>
  68. [link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
  69. </body>
  70. </html>