2
0

InstancedMesh.html 5.7 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157
  1. <!DOCTYPE html>
  2. <html lang="it">
  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:Mesh] &rarr;
  11. <h1>[name]</h1>
  12. <p class="desc">
  13. Una versione speciale di [page:Mesh] con il supporto per il rendering istanziato. Utilizza [name]
  14. se devi renderizzare un grande numero di oggetti con la stessa geometria e materiale ma con
  15. diverse trasformazioni world. L'utilizzo di [name] ti aiuterà a ridurre il numero di
  16. chiamate di disegno e quindi migliorare le prestazioni complessive del rendering nell'applicazione.
  17. </p>
  18. <h2>Esempi</h2>
  19. <p>
  20. [example:webgl_instancing_dynamic WebGL / instancing / dynamic]<br />
  21. [example:webgl_instancing_performance WebGL / instancing / performance]<br />
  22. [example:webgl_instancing_scatter WebGL / instancing / scatter]<br />
  23. [example:webgl_instancing_raycast WebGL / instancing / raycast]
  24. </p>
  25. <h2>Costruttore</h2>
  26. <h3>[name]( [param:BufferGeometry geometry], [param:Material material], [param:Integer count] )</h3>
  27. <p>
  28. [page:BufferGeometry geometry] - un'istanza di [page:BufferGeometry].<br />
  29. [page:Material material] - un'istanza di [page:Material]. Il valore di default è un nuovo [page:MeshBasicMaterial].<br />
  30. [page:Integer count] - il numero di istanze.<br />
  31. </p>
  32. <h2>Proprietà</h2>
  33. <p>Vedi la classe base [page:Mesh] per le proprietà comuni.</p>
  34. <h3>[property:Box3 boundingBox]</h3>
  35. <p>
  36. Bounding box per la [name], che può essere calcolato con [page:.computeBoundingBox](). Il valore predefinito è `null`.
  37. </p>
  38. <h3>[property:Sphere boundingSphere]</h3>
  39. <p>
  40. Bounding sphere per la [name], che può essere calcolato con [page:.computeBoundingSphere](). Il valore predefinito è `null`.
  41. </p>
  42. <h3>[property:Integer count]</h3>
  43. <p>
  44. Il numero di istanze. Il valore `count` passato nel costruttore rappresenta il numero
  45. massimo di istanze di questa mesh. Puoi modificare il numero di istanze in fase di esecuzione ad un valore intero
  46. nell'intervallo [0, count].
  47. </p>
  48. <p>
  49. Se hai bisogno di più istanze del valore count originale, devi creare una nuova [name].
  50. </p>
  51. <h3>[property:InstancedBufferAttribute instanceColor]</h3>
  52. <p>
  53. Rappresenta i colori di tutte le istanze. Il valore predefinito è `null`.
  54. È necessario impostare il suo flag [page:BufferAttribute.needsUpdate needsUpdate]
  55. a true se si modificano i dati di istanza tramite [page:.setColorAt]().
  56. </p>
  57. <h3>[property:InstancedBufferAttribute instanceMatrix]</h3>
  58. <p>
  59. Rappresenta la trasformazione locale di tutte le istanze.
  60. È necessario impostare il suo flag [page:BufferAttribute.needsUpdate needsUpdate]
  61. a true se si modificano i dati di istanza tramite [page:.setMatrixAt]().
  62. </p>
  63. <h3>[property:Boolean isInstancedMesh]</h3>
  64. <p>
  65. Flag di sola lettura per verificare se l'oggetto dato è di tipo [name].
  66. </p>
  67. <h2>Metodi</h2>
  68. <p>Vedi la classe base [page:Mesh] per i metodi comuni.</p>
  69. <h3>[method:undefined computeBoundingBox]()</h3>
  70. <p>
  71. Calcola il bounding box, aggiornando l'attributo [page:.boundingBox]. <br />
  72. I Bounding box non sono calcolati per impostazione predefinita. Devono essere calcolati esplicitamente,
  73. altrimenti sono `null`.
  74. </p>
  75. <h3>[method:undefined computeBoundingSphere]()</h3>
  76. <p>
  77. Calcola il bounding sphere, aggiornando l'attributo [page:.boundingSphere]. <br />
  78. I Bounding sphere non sono calcolati per impostazione predefinita. Devono essere calcolati esplicitamente,
  79. altrimenti sono `null`.
  80. </p>
  81. <h3>[method:undefined dispose]()</h3>
  82. <p>
  83. Libera le risorse relative alla GPU allocate da questa istanza.
  84. Chiama questo metodo ogni volta che questa istanza non è più utilizzata nella tua applicazione.
  85. </p>
  86. <h3>[method:undefined getColorAt]( [param:Integer index], [param:Color color] )</h3>
  87. <p>
  88. [page:Integer index]: L'indice di un'istanza. I valori devono essere nell'intervallo [0, count].
  89. </p>
  90. <p>
  91. [page:Color color]: Il colore dell'oggetto sarà impostato al colore dell'istanza definita.
  92. </p>
  93. <p>
  94. Ottieni il colore dell'istanza definita.
  95. </p>
  96. <h3>[method:undefined getMatrixAt]( [param:Integer index], [param:Matrix4 matrix] )</h3>
  97. <p>
  98. [page:Integer index]: L'indice di un'istanza. I valori devono essere nell'intervallo [0, count].
  99. </p>
  100. <p>
  101. [page:Matrix4 matrix]: Questa matrice 4x4 sarà impostata alla matrice trasformazione locale dell'istanza definita.
  102. </p>
  103. <p>
  104. Ottieni la matrice trasformazione locale dell'istanza definita.
  105. </p>
  106. <h3>[method:undefined setColorAt]( [param:Integer index], [param:Color color] )</h3>
  107. <p>
  108. [page:Integer index]: L'indice di un'istanza. I valori devono essere nell'intervallo [0, count].
  109. </p>
  110. <p>
  111. [page:Color color]: Il colore di una singola istanza.
  112. </p>
  113. <p>
  114. Imposta il colore dato all'istanza definita.
  115. Assicurati di impostare [page:.instanceColor][page:BufferAttribute.needsUpdate .needsUpdate]
  116. a true dopo l'aggiornamento di tutti i colori.
  117. </p>
  118. <h3>[method:undefined setMatrixAt]( [param:Integer index], [param:Matrix4 matrix] )</h3>
  119. <p>
  120. [page:Integer index]: L'indice di un'istanza. I valori devono essere nell'intervallo [0, count].
  121. </p>
  122. <p>
  123. [page:Matrix4 matrix]: Una matrice 4x4 che rappresenta la trasformazione locale di una singola istanza.
  124. </p>
  125. <p>
  126. Imposta la matrice trasformazione locale data all'istanza definita.
  127. Assicurati di impostare [page:.instanceColor][page:BufferAttribute.needsUpdate .needsUpdate]
  128. a true dopo l'aggiornamento di tutte le matrici.
  129. </p>
  130. <h2>Source</h2>
  131. <p>
  132. [link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
  133. </p>
  134. </body>
  135. </html>