InstancedMesh.html 3.0 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091
  1. <!DOCTYPE html>
  2. <html lang="zh">
  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. [page:Mesh] &rarr;
  12. <h1>实例化网格([name])</h1>
  13. <p class="desc">
  14. 一种具有实例化渲染支持的特殊版本的[page:Mesh]。你可以使用 [name] 来渲染大量具有相同几何体与材质、但具有不同世界变换的物体。
  15. 使用 [name] 将帮助你减少 draw call 的数量,从而提升你应用程序的整体渲染性能。
  16. </p>
  17. <p>
  18. 当前的实现需要[name]和其它3D物体间不共享材质。
  19. </p>
  20. <h2>示例</h2>
  21. <p>
  22. [example:webgl_instancing_dynamic WebGL / instancing / dynamic]<br />
  23. [example:webgl_instancing_modified WebGL / instancing / modified]<br />
  24. [example:webgl_instancing_performance WebGL / instancing / performance]<br />
  25. [example:webgl_instancing_scatter WebGL / instancing / scatter]<br />
  26. [example:webgl_instancing_raycast WebGL / instancing / raycast]
  27. </p>
  28. <h2>构造函数</h2>
  29. <h3>[name]( [param:BufferGeometry geometry], [param:Material material], [param:Integer count] )</h3>
  30. <p>
  31. [page:Geometry geometry] - 一个 [page:BufferGeometry] 的实例。<br />
  32. [page:Material material] - 一个 [page:Material] 的实例。默认为一个新的 [page:MeshBasicMaterial] 。<br />
  33. [page:Integer count] - 实例的数量<br />
  34. </p>
  35. <h2>属性</h2>
  36. <p>See the base [page:Mesh] class for common properties.</p>
  37. <h3>[property:Integer count]</h3>
  38. <p>
  39. 实例的数量。被传入到构造函数中的*count*表示mesh实例数量的最大值。
  40. 你可以在运行时改变这个数值到 [0, count] 区间的一个整数。
  41. </p>
  42. <p>
  43. 如果你需要比原先的数量更多的实例数量,你需要创建一个新的[name]。
  44. </p>
  45. <h3>[property:BufferAttribute instanceMatrix]</h3>
  46. <p>
  47. 表示所有实例的本地变换。
  48. 如果你要通过 [page:.setMatrixAt]() 来修改实例数据,你必须将它的 [page:BufferAttribute.needsUpdate needsUpdate] 标识为 true 。
  49. </p>
  50. <h2>方法</h2>
  51. <p>See the base [page:Mesh] class for common methods.</p>
  52. <h3>[method:null getMatrixAt]( [param:Integer index], [param:Matrix4 matrix] )</h3>
  53. <p>
  54. [page:Integer index]: 实例的索引。值必须在 [0, count] 区间。
  55. </p>
  56. <p>
  57. [page:Matrix4 matrix]: 该4x4矩阵将会被设为已定义实例的本地变换矩阵。
  58. </p>
  59. <p>
  60. 获得已定义实例的本地变换矩阵。
  61. </p>
  62. <h3>[method:null setMatrixAt]( [param:Integer index], [param:Matrix4 matrix] )</h3>
  63. <p>
  64. [page:Integer index]: 实例的索引。值必须在 [0, count] 区间。
  65. </p>
  66. <p>
  67. [page:Matrix4 matrix]: 一个4x4矩阵,表示单个实例本地变换。
  68. </p>
  69. <p>
  70. 设置给定的本地变换矩阵到已定义的实例。
  71. </p>
  72. <h2>源代码</h2>
  73. <p>
  74. [link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
  75. </p>
  76. </body>
  77. </html>