DriftEngine

Renderer · interface

InstancedHandle

A mesh made drawable many times over, held by a consumer and handed back.

Explained in Hello world.

interface InstancedHandle
import type { InstancedHandle } from '@driftengine/core';

In depth

Opaque for the reason ScatterHandle is, and distinct from it because what it batches is different: a scatter owns its own base geometry, and this one is attached to a mesh the consumer already uploaded. A car body is tens of megabytes and a second copy of it to draw it thirty times would defeat the point.

A consumer gets one from createInstanced and passes it to uploadInstanced, drawInstanced and drawTranslucentInstanced.