2
0

How-to-update-things.html 8.0 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223
  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. <h1>Come aggiornare le cose ([name])</h1>
  11. <div>
  12. <p>Tutti gli oggetti di default, automaticamente aggiornano le loro matrici se vengono aggiunti alla scena seguendo il codice qui sotto:</p>
  13. <code>
  14. const object = new THREE.Object3D();
  15. scene.add( object );
  16. </code>
  17. o se sono figli di un altro oggetto che è stato aggiunto alla scena:
  18. <code>
  19. const object1 = new THREE.Object3D();
  20. const object2 = new THREE.Object3D();
  21. object1.add( object2 );
  22. scene.add( object1 ); // object1 e object2 aggiorneranno automaticamente le loro matrici
  23. </code>
  24. </div>
  25. <p>Comunque, se sai che l'oggetto sarà statico, puoi disabilitare questo automatismo e aggiornare manualmente la matrice di trasformazione, solo quando necessario.</p>
  26. <code>
  27. object.matrixAutoUpdate = false;
  28. object.updateMatrix();
  29. </code>
  30. <h2>BufferGeometry</h2>
  31. <div>
  32. <p>
  33. Le BufferGeometry memorizzano le informazioni (come le posizioni dei vertici, gli indici delle facce, le normali, i colori,
  34. le coordinate UV, e qualsiasi attributo personalizzato) nel [page:BufferAttribute buffer] - cioè in
  35. [link:https://developer.mozilla.org/en-US/docs/Web/JavaScript/Typed_arrays array tipizzati].
  36. Ciò le rende generalmente più veloci delle Geometry standard, al costo di essere un po' più difficili da lavorare.
  37. </p>
  38. <p>
  39. Per quanto riguarda l'aggiornamento delle BufferGeometry, la cosa più importante da capire è che
  40. il buffer non può essere ridimensionato (questo è molto costoso e basicamente equivalente a creare una nuova geometria).
  41. Indipendetemente da questo il contenuto dei buffer può essere comunque aggiornato.
  42. </p>
  43. <p>
  44. Questo significa che se sai che un attributo della BufferGeometry crescerà, ad esempio il numero di vertici,
  45. è necessario preallocare un buffer sufficientemente grande per contenere i nuovi vertici che potrebbero essere creati.
  46. Ovviamente, questo significa anche che ci sarà una dimensione massima per la tua BufferGeometry - non è possibile
  47. creare una BufferGeometry che possa essere estesa in modo efficiente indefinitamente.
  48. </p>
  49. <p>
  50. Useremo l'esempio di una linea che viene estesa al momento del rendering. Allocheremo spazio nel buffer per contenere 500 vertici
  51. ma all'inizio ne disegneremo soltanto due, usando [page:BufferGeometry.drawRange].
  52. </p>
  53. <code>
  54. const MAX_POINTS = 500;
  55. // geometry
  56. const geometry = new THREE.BufferGeometry();
  57. // attributes
  58. const positions = new Float32Array( MAX_POINTS * 3 ); // 3 vertices per point
  59. geometry.setAttribute( 'position', new THREE.BufferAttribute( positions, 3 ) );
  60. // draw range
  61. const drawCount = 2; // draw the first 2 points, only
  62. geometry.setDrawRange( 0, drawCount );
  63. // material
  64. const material = new THREE.LineBasicMaterial( { color: 0xff0000 } );
  65. // line
  66. const line = new THREE.Line( geometry, material );
  67. scene.add( line );
  68. </code>
  69. <p>
  70. Quindi, aggiungeremo punti alla linea in maniera random usando un pattern come questo:
  71. </p>
  72. <code>
  73. const positions = line.geometry.attributes.position.array;
  74. let x, y, z, index;
  75. x = y = z = index = 0;
  76. for ( let i = 0, l = MAX_POINTS; i < l; i ++ ) {
  77. positions[ index ++ ] = x;
  78. positions[ index ++ ] = y;
  79. positions[ index ++ ] = z;
  80. x += ( Math.random() - 0.5 ) * 30;
  81. y += ( Math.random() - 0.5 ) * 30;
  82. z += ( Math.random() - 0.5 ) * 30;
  83. }
  84. </code>
  85. <p>
  86. Se vuoi cambiare il <em>numero di punti</em> visualizzati dopo il primo render, procedi come segue;
  87. </p>
  88. <code>
  89. line.geometry.setDrawRange( 0, newValue );
  90. </code>
  91. <p>
  92. Se vuoi cambiare i valori dei dati di posizione dopo il primo render, è necessario
  93. impostare il flag di needsUpdate come segue:
  94. </p>
  95. <code>
  96. line.geometry.attributes.position.needsUpdate = true; // required after the first render
  97. </code>
  98. <p>
  99. Se vuoi modificare i valori dei dati di posizione dopo il rendering iniziale, è necessario
  100. ricalcolare i volumi di delimitazione (bounding volumes) in modo che altre funzionalità dell'engine
  101. come l'eliminazione del frustum di visualizzazione o gli helpers possano funzionare correttamente.
  102. </p>
  103. <code>
  104. line.geometry.computeBoundingBox();
  105. line.geometry.computeBoundingSphere();
  106. </code>
  107. <p>
  108. [link:https://jsfiddle.net/t4m85pLr/1/ Qui un fiddle] che mostra una linea animata che può essere adattata al tuo caso d'uso.
  109. </p>
  110. <h3>Esempi</h3>
  111. <p>
  112. [example:webgl_custom_attributes WebGL / custom / attributes]<br />
  113. [example:webgl_buffergeometry_custom_attributes_particles WebGL / buffergeometry / custom / attributes / particles]
  114. </p>
  115. </div>
  116. <h2>Materiali</h2>
  117. <div>
  118. <p>Tutti i valori costanti possono essere cambiati liberamente (come i colori, le texture, l'opacità, etc), valori che vengono inviati allo shader ad ogni frame.</p>
  119. <p>Anche i parametri relativi a GLstate possono essere cambiati in qualsiasi momento (depthTest, blending, polygonOffset, etc).</p>
  120. <p>Invece, le proprietà seguenti non possono essere modificare facilmente in fase di esecuzione (una volta che il materiale è stato renderizzato almeno una volta):</p>
  121. <ul>
  122. <li>numero e tipi di costanti</li>
  123. <li>presenza oppure no di
  124. <ul>
  125. <li>texture</li>
  126. <li>fog</li>
  127. <li>vertex colors</li>
  128. <li>morphing</li>
  129. <li>shadow map</li>
  130. <li>alpha test</li>
  131. <li>transparent</li>
  132. </ul>
  133. </li>
  134. </ul>
  135. <p>Le modifiche di questi richiedono la creazione di un nuovo programma di shader. Dovrai impostare:</p>
  136. <code>material.needsUpdate = true</code>
  137. <p>Tieni presente che questa operazione potrebbe essere piuttosto lenta e causare scatti nel framerate (specialmente su Windows, poiché la compilazione degli shader è più lenta in DirectX che in OpenGL).</p>
  138. <p>Per creare un'esperienza più fluida puoi emulare in una certa misura le modifiche a queste funzionalità avendo valori "fittizi" come luci ad intensità zero, texture bianche, o fog a zero densità.</p>
  139. <p>È possibile cambiare liberamente il materiale utilizzato per i blocchi di geometria, tuttavia non è possibile modificare il modo in cui un oggetto è diviso in blocchi (in base ai materiali della faccia).</p>
  140. <h3>Se è necessario disporre di diverse configurazioni dei materiali durante l'esecuzione:</h3>
  141. <p>Se il numero di materiali / blocchi è piccolo, puoi dividere l'oggetto in anticipo (per esempio capelli / faccia / corpo / vestiti superiori / pantaloni per un umano / davanti / dietro / parte superiore / occhiali / pneumatico / interni di una macchina). </p>
  142. <p>Se, invece, il numero è grande (per esempio, ogni faccia potrebbe essere potenzialmente diversa), considera una soluzione divera, come usare attributi / texture per ottenere un aspetto diverso per faccia.</p>
  143. <h3>Esempi</h3>
  144. <p>
  145. [example:webgl_materials_car WebGL / materials / car]<br />
  146. [example:webgl_postprocessing_dof WebGL / webgl_postprocessing / dof]
  147. </p>
  148. </div>
  149. <h2>Texture</h2>
  150. <div>
  151. <p>Se immagini, canvas, video e texture vengono modificate devono avere il flag <em>needsUpdate</em> impostato come segue:</p>
  152. <code>
  153. texture.needsUpdate = true;
  154. </code>
  155. <p>Le destinazioni di rendering si aggiornano automaticamente.</p>
  156. <h3>Esempi</h3>
  157. <p>
  158. [example:webgl_materials_video WebGL / materials / video]<br />
  159. [example:webgl_rtt WebGL / rtt]
  160. </p>
  161. </div>
  162. <h2>Telecamere</h2>
  163. <div>
  164. <p>La posizione e il target di una camera vengono aggiornati automaticamente. Se hai bisogno di cambiare</p>
  165. <ul>
  166. <li>
  167. fov
  168. </li>
  169. <li>
  170. aspect
  171. </li>
  172. <li>
  173. near
  174. </li>
  175. <li>
  176. far
  177. </li>
  178. </ul>
  179. <p>
  180. dovrai ricalcolare la matrice di proiezione:
  181. </p>
  182. <code>
  183. camera.aspect = window.innerWidth / window.innerHeight;
  184. camera.updateProjectionMatrix();
  185. </code>
  186. </div>
  187. </body>
  188. </html>