cesiumjs-primitives

Batch render thousands of geometries in CesiumJS by grouping multiple GeometryInstance objects into a single Primitive collection. This approach reduces draw calls and optimizes scene-wide performance compared to using high-level Entity APIs for large datasets.

Use CesiumJS Primitives instead of Entity APIs when you need low-level rendering control and scene-wide performance optimization. Primitives provide fine-grained management over GeometryInstance arrays and Appearance, making them ideal for rendering large numbers of static shapes efficiently.

Render terrain-draped geometry in CesiumJS by utilizing ground primitives within your Primitive collection. This approach allows custom shapes to conform to the underlying terrain while maintaining the batching benefits of GeometryInstance arrays for performance-critical scenes.

CesiumJS Primitive supports custom geometry types alongside built-in geometries through GeometryInstance configurations. You can attach appropriate Appearance objects to define the visual presentation, achieving fine-grained control over both the shape structure and its rendering pipeline.

Primitive collections in CesiumJS are optimized for static shapes and performance-critical scenes, which limits dynamic object updates. Because batching relies on grouping GeometryInstance arrays for deterministic draw calls, frequently modifying individual geometries within a Primitive lacks the flexibility of high-level Entity APIs.