Interface: Primitive<TData>

Experimental

A GPU drawing building block. Implementations must:

• render all items with a constant number of draw calls (independent of item count),
• upload only the buffers affected by an update when possible (plan §E16.3),
• release every acquired resource in dispose.

Type Parameters

Type Parameter
TData

Properties

Property	Modifier	Type	Description
object	readonly	Object3D	Experimental Root object to add to a viewport's scene.

Methods

dispose()

dispose(): void;

Experimental

Release GPU resources. The primitive must not be used afterwards.

Returns

void

---

setTransform()

setTransform(transform): void;

Experimental

Set the data → world transform (cheap: uniforms only, no buffer uploads).

Parameters

Parameter	Type
transform	DataTransform

Returns

void

---

setViewport()

setViewport(size): void;

Experimental

Update viewport-dependent uniforms (resolution, pixel ratio).

Parameters

Parameter	Type
size	ViewportSize

Returns

void

---

update()

update(data): void;

Experimental

Replace or patch the primitive's data. Omitted fields keep their previous values.

Parameters

Parameter	Type
data	Partial<TData>

Returns

void