InstancedMesh.html 4.8 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133
  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:Integer count]</h3>
  35. <p>
  36. Il numero di istanze. Il valore `count` passato nel costruttore rappresenta il numero
  37. massimo di istanze di questa mesh. Puoi modificare il numero di istanze in fase di esecuzione ad un valore intero
  38. nell'intervallo [0, count].
  39. </p>
  40. <p>
  41. Se hai bisogno di più istanze del valore count originale, devi creare una nuova [name].
  42. </p>
  43. <h3>[property:InstancedBufferAttribute instanceColor]</h3>
  44. <p>
  45. Rappresenta i colori di tutte le istanze. Il valore predefinito è `null`.
  46. È necessario impostare il suo flag [page:BufferAttribute.needsUpdate needsUpdate]
  47. a true se si modificano i dati di istanza tramite [page:.setColorAt]().
  48. </p>
  49. <h3>[property:InstancedBufferAttribute instanceMatrix]</h3>
  50. <p>
  51. Rappresenta la trasformazione locale di tutte le istanze.
  52. È necessario impostare il suo flag [page:BufferAttribute.needsUpdate needsUpdate]
  53. a true se si modificano i dati di istanza tramite [page:.setMatrixAt]().
  54. </p>
  55. <h3>[property:Boolean isInstancedMesh]</h3>
  56. <p>
  57. Flag di sola lettura per verificare se l'oggetto dato è di tipo [name].
  58. </p>
  59. <h2>Metodi</h2>
  60. <p>Vedi la classe base [page:Mesh] per i metodi comuni.</p>
  61. <h3>[method:undefined dispose]()</h3>
  62. <p>
  63. Libera le risorse relative alla GPU allocate da questa istanza.
  64. Chiama questo metodo ogni volta che questa istanza non è più utilizzata nella tua applicazione.
  65. </p>
  66. <h3>[method:undefined getColorAt]( [param:Integer index], [param:Color color] )</h3>
  67. <p>
  68. [page:Integer index]: L'indice di un'istanza. I valori devono essere nell'intervallo [0, count].
  69. </p>
  70. <p>
  71. [page:Color color]: Il colore dell'oggetto sarà impostato al colore dell'istanza definita.
  72. </p>
  73. <p>
  74. Ottieni il colore dell'istanza definita.
  75. </p>
  76. <h3>[method:undefined getMatrixAt]( [param:Integer index], [param:Matrix4 matrix] )</h3>
  77. <p>
  78. [page:Integer index]: L'indice di un'istanza. I valori devono essere nell'intervallo [0, count].
  79. </p>
  80. <p>
  81. [page:Matrix4 matrix]: Questa matrice 4x4 sarà impostata alla matrice trasformazione locale dell'istanza definita.
  82. </p>
  83. <p>
  84. Ottieni la matrice trasformazione locale dell'istanza definita.
  85. </p>
  86. <h3>[method:undefined setColorAt]( [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 di una singola istanza.
  92. </p>
  93. <p>
  94. Imposta il colore dato all'istanza definita.
  95. Assicurati di impostare [page:.instanceColor][page:BufferAttribute.needsUpdate .needsUpdate]
  96. a true dopo l'aggiornamento di tutti i colori.
  97. </p>
  98. <h3>[method:undefined setMatrixAt]( [param:Integer index], [param:Matrix4 matrix] )</h3>
  99. <p>
  100. [page:Integer index]: L'indice di un'istanza. I valori devono essere nell'intervallo [0, count].
  101. </p>
  102. <p>
  103. [page:Matrix4 matrix]: Una matrice 4x4 che rappresenta la trasformazione locale di una singola istanza.
  104. </p>
  105. <p>
  106. Imposta la matrice trasformazione locale data all'istanza definita.
  107. Assicurati di impostare [page:.instanceColor][page:BufferAttribute.needsUpdate .needsUpdate]
  108. a true dopo l'aggiornamento di tutte le matrici.
  109. </p>
  110. <h2>Source</h2>
  111. <p>
  112. [link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
  113. </p>
  114. </body>
  115. </html>