BufferPolylineCollection
BufferPolylineCollection is a high-performance collection of buffer polyline primitives (experimental).
It can have BufferPolyline components as children.
This is a low-level primitive API for rendering large numbers of polylines efficiently. Note: This API is experimental and subject to change without standard deprecation.
- Cesium element: BufferPolylineCollection
- Example: BufferPolylineCollection
Availability
Section titled âAvailabilityâInside Viewer or CesiumWidget component. A BufferPolylineCollection object will be attached to the PrimitiveCollection of the Viewer or CesiumWidget.
Properties
Section titled âPropertiesâCesium properties
Section titled âCesium propertiesâ| Property | Type | Description |
|---|---|---|
| show | boolean | |
| debugShowBoundingVolume | boolean |
Cesium read-only properties
Section titled âCesium read-only propertiesâ| Property | Type | Description |
|---|---|---|
| primitiveCountMax | number | undefined | The maximum number of polylines this collection can hold. Fixed at creation time. |
| vertexCountMax | number | undefined | The maximum number of vertices across all polylines in this collection. Fixed at creation time. |
| modelMatrix | Matrix4 | undefined | Model-to-world transform applied to every polyline. Fixed at creation time â Cesium 1.141 made the property readonly post-construction. To animate, hold a ref and mutate the Matrix4 in place via Matrix4.clone(next, current). |
| boundingVolume | BoundingSphere | undefined | Precomputed bounding volume. Interpreted in world space (Cesium 1.142+); apply the same modelMatrix to the bounding volume that you apply to the polylines. Fixed at creation time. |
| blendOption | BlendOption | undefined | Blending mode for the collection. Pair with an alpha-aware BufferPrimitiveMaterial to render translucent polylines. Fixed at creation time. |
| heightReference | HeightReference | undefined | When set to a clamping value, the whole collection is draped onto terrain and/or 3D Tiles (Cesium 1.145+) instead of being drawn as geometry of its own. CLAMP_TO_TERRAIN drapes onto terrain, CLAMP_TO_3D_TILE onto 3D Tiles, and CLAMP_TO_GROUND onto both. Fixed at creation time. |
| widthUnits | âpixelsâ | âmetersâ | undefined | Unit for BufferPolyline widths in this collection (Cesium 1.145+): "pixels" on screen (the default), or "meters" in world space. Under a clamped heightReference those meters are measured on the ellipsoid surface, so elevation and terrain slope stretch the drawn width. Fixed at creation time. |
Cesium events
Section titled âCesium eventsâN/A
Other properties
Section titled âOther propertiesâ| Property | Type | Description |
|---|---|---|
| children | ReactNode |