InstancedMesh
new InstancedMesh(geometry?, material?, count?)
Renders multiple instances of the same geometry/material pair with per-instance transforms and optional per-instance colors. Each instance becomes a separate draw call, so use for entities/particles (100s of shared models), not per-face terrain (use merged Geometry instead).
Properties
| Name | Type | Description |
|---|---|---|
count | number | Number of instances to render. |
instanceMatrix | Float32Array | Flat buffer of 16 floats per instance (column-major matrices). Read-only. |
instanceColor | Float32Array|undefined | Flat buffer of 3 floats per instance (RGB). Set via setColorAt. |
Methods
| Method | Description |
|---|---|
getMatrixAt(index: number, matrix: Matrix4): void | Reads the transform matrix for instance at index into the target matrix. |
setMatrixAt(index: number, matrix: Matrix4): void | Writes a transform matrix for instance at index. |
getColorAt(index: number, color: Color): void | Reads the color for instance at index into the target color. |
setColorAt(index: number, color: Color): void | Writes a color for instance at index. Allocates instanceColor on first call. |
dispose(): void | Releases instance buffers. |