javascript
/
three.js
spegling av https://github.com/tazdij/three.js.git


			
							123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224
							<!DOCTYPE html>
<html lang="it">
	<head>
		<meta charset="utf-8" />
		<base href="../../../" />
		<script src="page.js"></script>
		<link type="text/css" rel="stylesheet" href="page.css" />
	</head>
	<body>
		<h1>[name]</h1>

		<p class="desc">
      Questa classe memorizza i dati per un attributo (come le posizioni dei vertici, gli indici delle facce, le normali,
      i colori, le coordinate UV e alcuni attributi personalizzati) associato ad una [page:BufferGeometry],
      che consente un passaggio più efficiente dei dati alla GPU. Consulta questa pagina per i dettagli ed un esempo di
      utilizzo. Quando si lavora con dati di tipo vettoriale, i metodi helper <i>.fromBufferAttribute( attribute, index )</i>
      sulle classi [page:Vector2.fromBufferAttribute Vector2],
      [page:Vector3.fromBufferAttribute Vector3],
      [page:Vector4.fromBufferAttribute Vector4] e [page:Color.fromBufferAttribute Color] possono essere utili.
		</p>

		<h2>Costruttore</h2>
		<h3>[name]( [param:TypedArray array], [param:Integer itemSize], [param:Boolean normalized] )</h3>
		<p>
		  [page:TypedArray array] -- Deve essere un [link:https://developer.mozilla.org/en/docs/Web/JavaScript/Reference/Global_Objects/TypedArray TypedArray].
		  Utilizzato per istanziare il buffer. <br />
      Questo array dovrebbe avere gli elementi <code>itemSize * numVertices</code>
      dove numVertices è il numero di vertici della [page:BufferGeometry BufferGeometry] associata.<br /><br />

      [page:Integer itemSize] -- il numero di valori dell'array che deve essere associato ad un particolare vertice.
      Per esempio, se questo atttibuto memorizza un vettore a 3 componenti (come posizione, normale o colore), 
      itemSize dovrebbe essere 3.<br /><br />

      [page:Boolean normalized] -- (opzionale) Si applica solo ai dati interi. Indica il modo in cui i dati sottostanti 
      del buffer si adattano ai valori del codice GLSL. Ad esempio, se l'[page:TypedArray array] è un'istanza di UInt16Array,
      e [page:Boolean normalized] è a true, i valori `0 - +65535` nei dati dell'array saranno mappati su 0.0f - +1.0f nell'attributo GLSL.
      Un Int16Array (con segno) sarà mappato da -32768 - +32767 a -1.0f - +1.0f. Se [page:Boolean normalized] è a false, i valori 
      verranno convertiti in float non modificati, p.e. 32767 diventa 32767.0f.
		</p>

		<h2>Proprietà</h2>

		<h3>[property:TypedArray array]</h3>
		<p>
      L'[page:TypedArray array] contente i dati memorizzati nel buffer.
		</p>

		<h3>[property:Integer count]</h3>
		<p>
      Memorizza la lunghezza dell'[page:BufferAttribute.array array] divisa per [page:BufferAttribute.itemSize itemSize].<br /><br />

      Se il buffer memorizza un vettore a 3 componenti (come una posizione, una normale o un colore),
      questo conterà il numero dei vettori memorizzati.
		</p>

		<h3>[property:Boolean isBufferAttribute]</h3>
		<p>
      Flag di sola lettura per verificare se un dato oggetto è di tipo [name].
		</p>

		<h3>[property:Integer itemSize]</h3>
		<p>
      La lunghezza dei vettori che vengono memorizzati nell'[page:BufferAttribute.array array].
    </p>

		<h3>[property:String name]</h3>
		<p>
      Un nome opzionale per questa istanza dell'attributo. Il valore predefinito è una stringa vuota.
		</p>

		<h3>[property:Boolean needsUpdate]</h3>
		<p>
      Flag che indica che questo attributo è stato modificato e deve essere rinviato alla GPU.
      Impostalo a true quando modifichi il valore dell'array.<br /><br />

      Impostando questa proprietà a true incrementa, inoltre, la [page:BufferAttribute.version versione].
		</p>

		<h3>[property:Boolean normalized]</h3>
		<p>
      Indica il modo in cui i dati sottostanti del buffer si adattano ai valori del codice shader GLSL.
      Vedi il costruttore sopra per i dettagli.
		</p>

		<h3>[property:Function onUploadCallback]</h3>
		<p>
      Una funzione di callback che viene eseguita dopo che il Renderer ha trasferito i dati dell'array dell'attributo
      alla GPU. 
		</p>

		<h3>[property:Object updateRange]</h3>
		<p>Oggetto contenente:<br />
			[page:Integer offset]: Il valore predefinito è `0`. Posizione da cui inizia l'aggiornamento.<br />
			[page:Integer count]: Il valore predefinito è `-1`, il che significa non utilizzare intervalli di aggiornamento. <br /><br />

      Può essere utilizzato solo per aggiornare alcuni componenti dei vettori memorizzati (per esempio, solo
      il componente relativo al colore).
		</p>

		<h3>[property:Usage usage]</h3>
		<p>
      Definisce il modello di utilizzo previsto per l'archivio dati a fini di ottimizzazione. Corrisponde al paramentro `usage`
      di [link:https://developer.mozilla.org/en-US/docs/Web/API/WebGLRenderingContext/bufferData WebGLRenderingContext.bufferData]().
      Il valore predefinito è [page:BufferAttributeUsage StaticDrawUsage]. Vedi le [page:BufferAttributeUsage costanti] di utilizzo 
      per tutti i valori possibili. <br /><br />

      Nota: Dopo l'utilizzo iniziale di un buffer, il suo utilizzo non può essere modificato. Invece, istanziane uno nuovo e imposta
      l'utilizzo desiderato prima del rendering successivo.
		</p>

		<h3>[property:Integer version]</h3>
		<p>
      Un numero di versione, incrementato ogni volta che la proprietà [page:BufferAttribute.needsUpdate needsUpdate] viene impostata a true.
    </p>

		<h2>Metodi</h2>

		<h3>[method:this applyMatrix3]( [param:Matrix3 m] )</h3>
		<p>
      Applica la matrice [page:Matrix3 m] ad ogni elemento Vector3 di questo BufferAttribute.
    </p>

		<h3>[method:this applyMatrix4]( [param:Matrix4 m] )</h3>
		<p>
      Applica la matrice [page:Matrix4 m] ad ogni elemento Vector3 di questo BufferAttribute.  
    </p>

		<h3>[method:this applyNormalMatrix]( [param:Matrix3 m] )</h3>
		<p>
      Applica la matrice normale [page:Matrix3 m] ad ogni elemento Vector3 di questo BufferAttribute.
    </p>

		<h3>[method:this transformDirection]( [param:Matrix4 m] )</h3>
		<p>
      Applica la matrice [page:Matrix4 m] ad ogni elemento Vector3 di questo BufferAttribute, interpretando gli elementi come vettori direzionali.
    </p>

		<h3>[method:BufferAttribute clone]() </h3>
		<p>Restituisce una copia di questo bufferAttribute.</p>

		<h3>[method:this copy]( [param:BufferAttribute bufferAttribute] )</h3>
		<p>Copia un altro BufferAttribute in questo BufferAttribute.</p>

		<h3>[method:this copyArray]( array ) </h3>
		<p>
      Copia l'array fornito qui (il quale può essere un normale array o un array tipizzato)
      nell'[page:BufferAttribute.array array].<br /><br />

      Vedi [link:https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/TypedArray/set TypedArray.set]
      per le note sui requisiti se si copia un TypedArray.
		</p>

		<h3>[method:this copyAt] ( [param:Integer index1], [param:BufferAttribute bufferAttribute], [param:Integer index2] ) </h3>
		<p>Copia un vettore da bufferAttribute[index2] a [page:BufferAttribute.array array][index1].</p>

		<h3>[method:Number getX]( [param:Integer index] ) </h3>
		<p>Restituisce il componente x del vettore in corrispondenza dell'indice specificato.</p>

		<h3>[method:Number getY]( [param:Integer index] ) </h3>
		<p>Restituisce il componente y del vettore in corrispondenza dell'indice specificato.</p>

		<h3>[method:Number getZ]( [param:Integer index] ) </h3>
		<p>Restituisce il componente z del vettore in corrispondenza dell'indice specificato.</p>

		<h3>[method:Number getW]( [param:Integer index] ) </h3>
		<p>Restituisce il componente w del vettore in corrispondenza dell'indice specificato.</p>

		<h3>[method:this onUpload]( [param:Function callback] ) </h3>
		<p>
      Imposta il valore della proprietà onUploadCallback.<br /><br />
      Nel [example:webgl_buffergeometry WebGL / Buffergeometry] questo metodo viene utilizzato per 
      liberare memoria dopo che il buffer è stato trasferito alla GPU.
		</p>

		<h3>[method:this set] ( [param:Array value], [param:Integer offset] ) </h3>
		<p>
		  value -- un [page:Array] o [page:TypedArray] dal quale copiare i valori. <br />
		  offset -- (opzionale) indice dell'[page:BufferAttribute.array array] da cui iniziare la copia.<br /><br />

      Chiama [link:https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/TypedArray/set TypedArray.set]( [page:Array value], [page:Integer offset] )
      sull'[page:BufferAttribute.array array].<br /><br />

      In particolare, si veda questa pagina per i requisiti sul [page:Array value]
      che deve essere un [page:TypedArray].
		</p>

		<h3>[method:this setUsage] ( [param:Usage value] ) </h3>
		<p>
      Imposta [page:BufferAttribute.usage usage] a value. Vedi le [page:BufferAttributeUsage costanti] di utilizzo per tutti i possibili valori di input.<br /><br />

      Nota: Dopo l'utilizzo iniziale di un buffer, il suo utilizzo non può cambiare. Invece, istanziane uno nuovo e 
      imposta l'utilizzo desiderato prima del rendering successivo.
		</p>

		<h3>[method:this setX]( [param:Integer index], [param:Float x] ) </h3>
		<p>Imposta il componente x del vettore in corrispondenza dell'indice specificato.</p>

		<h3>[method:this setY]( [param:Integer index], [param:Float y] ) </h3>
		<p>Imposta il componente y del vettore in corrispondenza dell'indice specificato.</p>

		<h3>[method:this setZ]( [param:Integer index], [param:Float z] ) </h3>
		<p>Imposta il componente z del vettore in corrispondenza dell'indice specificato.</p>

		<h3>[method:this setW]( [param:Integer index], [param:Float w] ) </h3>
		<p>Imposta il componente w del vettore in corrispondenza dell'indice specificato.</p>

		<h3>[method:this setXY]( [param:Integer index], [param:Float x], [param:Float y] ) </h3>
		<p>Imposta i componenti x e y del vettore in corrispondenza dell'indice specificato.</p>

		<h3>[method:this setXYZ]( [param:Integer index], [param:Float x], [param:Float y], [param:Float z] ) </h3>
		<p>Imposta i componenti x, y e z del vettore in corrispondenza dell'indice specificato.</p>

		<h3>[method:this setXYZW]( [param:Integer index], [param:Float x], [param:Float y], [param:Float z], [param:Float w] ) </h3>
		<p>Imposta i componenti x, y, z e w del vettore in corrispondenza dell'indice specificato.</p>


		<h2>Source</h2>

		<p>
			[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
		</p>
	</body>
</html>