[page:Mesh] →

# [name]

Una versione speciale di [page:Mesh] con il supporto per il rendering istanziato. Utilizza [name] se devi renderizzare un grande numero di oggetti con la stessa geometria e materiale ma con diverse trasformazioni world. L'utilizzo di [name] ti aiuterà a ridurre il numero di chiamate di disegno e quindi migliorare le prestazioni complessive del rendering nell'applicazione.

## Esempi

[example:webgl_instancing_dynamic WebGL / instancing / dynamic]
[example:webgl_instancing_performance WebGL / instancing / performance]
[example:webgl_instancing_scatter WebGL / instancing / scatter]
[example:webgl_instancing_raycast WebGL / instancing / raycast]

## Costruttore

### [name]( [param:BufferGeometry geometry], [param:Material material], [param:Integer count] )

[page:BufferGeometry geometry] - un'istanza di [page:BufferGeometry].
[page:Material material] - un'istanza di [page:Material]. Il valore di default è un nuovo [page:MeshBasicMaterial].
[page:Integer count] - il numero di istanze.

## Proprietà

Vedi la classe base [page:Mesh] per le proprietà comuni.

### [property:Box3 boundingBox]

Bounding box per la [name], che può essere calcolato con [page:.computeBoundingBox](). Il valore predefinito è `null`.

### [property:Sphere boundingSphere]

Bounding sphere per la [name], che può essere calcolato con [page:.computeBoundingSphere](). Il valore predefinito è `null`.

### [property:Integer count]

Il numero di istanze. Il valore `count` passato nel costruttore rappresenta il numero massimo di istanze di questa mesh. Puoi modificare il numero di istanze in fase di esecuzione ad un valore intero nell'intervallo [0, count].

Se hai bisogno di più istanze del valore count originale, devi creare una nuova [name].

### [property:InstancedBufferAttribute instanceColor]

Rappresenta i colori di tutte le istanze. Il valore predefinito è `null`. È necessario impostare il suo flag [page:BufferAttribute.needsUpdate needsUpdate] a true se si modificano i dati di istanza tramite [page:.setColorAt]().

### [property:InstancedBufferAttribute instanceMatrix]

Rappresenta la trasformazione locale di tutte le istanze. È necessario impostare il suo flag [page:BufferAttribute.needsUpdate needsUpdate] a true se si modificano i dati di istanza tramite [page:.setMatrixAt]().

### [property:Boolean isInstancedMesh]

Flag di sola lettura per verificare se l'oggetto dato è di tipo [name].

## Metodi

Vedi la classe base [page:Mesh] per i metodi comuni.

### [method:undefined computeBoundingBox]()

Calcola il bounding box, aggiornando l'attributo [page:.boundingBox].
I Bounding box non sono calcolati per impostazione predefinita. Devono essere calcolati esplicitamente, altrimenti sono `null`.

### [method:undefined computeBoundingSphere]()

Calcola il bounding sphere, aggiornando l'attributo [page:.boundingSphere].
I Bounding sphere non sono calcolati per impostazione predefinita. Devono essere calcolati esplicitamente, altrimenti sono `null`.

### [method:undefined dispose]()

Libera le risorse relative alla GPU allocate da questa istanza. Chiama questo metodo ogni volta che questa istanza non è più utilizzata nella tua applicazione.

### [method:undefined getColorAt]( [param:Integer index], [param:Color color] )

[page:Integer index]: L'indice di un'istanza. I valori devono essere nell'intervallo [0, count].

[page:Color color]: Il colore dell'oggetto sarà impostato al colore dell'istanza definita.

Ottieni il colore dell'istanza definita.

### [method:undefined getMatrixAt]( [param:Integer index], [param:Matrix4 matrix] )

[page:Integer index]: L'indice di un'istanza. I valori devono essere nell'intervallo [0, count].

[page:Matrix4 matrix]: Questa matrice 4x4 sarà impostata alla matrice trasformazione locale dell'istanza definita.

Ottieni la matrice trasformazione locale dell'istanza definita.

### [method:undefined setColorAt]( [param:Integer index], [param:Color color] )

[page:Integer index]: L'indice di un'istanza. I valori devono essere nell'intervallo [0, count].

[page:Color color]: Il colore di una singola istanza.

Imposta il colore dato all'istanza definita. Assicurati di impostare [page:.instanceColor][page:BufferAttribute.needsUpdate .needsUpdate] a true dopo l'aggiornamento di tutti i colori.

### [method:undefined setMatrixAt]( [param:Integer index], [param:Matrix4 matrix] )

[page:Integer index]: L'indice di un'istanza. I valori devono essere nell'intervallo [0, count].

[page:Matrix4 matrix]: Una matrice 4x4 che rappresenta la trasformazione locale di una singola istanza.

Imposta la matrice trasformazione locale data all'istanza definita. Assicurati di impostare [page:.instanceColor][page:BufferAttribute.needsUpdate .needsUpdate] a true dopo l'aggiornamento di tutte le matrici.

## Source

[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]