1
0

TGALoader.html 2.8 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103
  1. <!DOCTYPE html>
  2. <html lang="zh">
  3. <head>
  4. <meta charset="utf-8" />
  5. <base href="../../../" />
  6. <script src="page.js"></script>
  7. <link type="text/css" rel="stylesheet" href="page.css" />
  8. </head>
  9. <body>
  10. [page:Loader] &rarr;
  11. <h1>[name]</h1>
  12. <p class="desc">用于加载`.tga`资源的加载器。<br />
  13. [link:https://en.wikipedia.org/wiki/Truevision_TGA TGA]是光栅图形,图形文件格式。
  14. </p>
  15. <h2>导入</h2>
  16. <p>
  17. [name]是附加项,必须显示的引用。请参考[link:#manual/introduction/Installation Installation / Addons]。
  18. </p>
  19. <code>
  20. import { TGALoader } from 'three/addons/loaders/TGALoader.js';
  21. </code>
  22. <h2>代码示例</h2>
  23. <code>
  24. // instantiate a loader
  25. const loader = new TGALoader();
  26. // load a resource
  27. const texture = loader.load(
  28. // resource URL
  29. 'textures/crate_grey8.tga'
  30. // called when loading is completed
  31. function ( texture ) {
  32. console.log( 'Texture is loaded' );
  33. },
  34. // called when the loading is in progresses
  35. function ( xhr ) {
  36. console.log( ( xhr.loaded / xhr.total * 100 ) + '% loaded' );
  37. },
  38. // called when the loading fails
  39. function ( error ) {
  40. console.log( 'An error happened' );
  41. }
  42. );
  43. const material = new THREE.MeshPhongMaterial( {
  44. color: 0xffffff,
  45. map: texture
  46. } );
  47. </code>
  48. <h2>示例</h2>
  49. <p>
  50. [example:webgl_loader_texture_tga]
  51. </p>
  52. <h2>构造函数</h2>
  53. <h3>[name]( [param:LoadingManager manager] )</h3>
  54. <p>
  55. [page:LoadingManager manager] — 加载器使用的[page:LoadingManager loadingManager]。默认值为[page:LoadingManager THREE.DefaultLoadingManager]。
  56. </p>
  57. <p>
  58. 创建新的[name].
  59. </p>
  60. <h2>属性</h2>
  61. <p>查看公共属性请参考基类[page:Loader]。</p>
  62. <h2>方法</h2>
  63. <p>查看公共方法请参考基类[page:Loader]。</p>
  64. <h3>[method:DataTexture load]( [param:String url], [param:Function onLoad], [param:Function onProgress], [param:Function onError] )</h3>
  65. <p>
  66. [page:String url] — 一个`.tga`文件的路径或者网络地址。<br />
  67. [page:Function onLoad] — (可选的)加载成功之后调用的函数。该函数以[page:DataTexture]为参数。<br />
  68. [page:Function onProgress] — (可选的)正在加载时调用的函数。参数为XMLHttpRequest实例,包含[page:Integer total]和[page:Integer loaded]。
  69. 如果服务没有设置Content-Length头,.[page:Integer total]的值为0。<br />
  70. [page:Function onError] — (可选的)加载出现错误时调用的函数。该函将错误信息作为参数。<br />
  71. </p>
  72. <p>
  73. 开始加载[page:DataTexture texture]并传递给onLoad。即时引用会将[page:DataTexture texture]直接返回(不一定加载完成)。
  74. </p>
  75. <h2>源代码</h2>
  76. <p>
  77. [link:https://github.com/mrdoob/three.js/blob/master/examples/jsm/loaders/TGALoader.js examples/jsm/loaders/TGALoader.js]
  78. </p>
  79. </body>
  80. </html>