VoxelPrimitive

new Cesium.VoxelPrimitive(options)

A primitive that renders voxel data from a VoxelProvider.
Name Type Description
options object optional Object with the following properties:
Name Type Default Description
provider VoxelProvider optional The voxel provider that supplies the primitive with tile data.
modelMatrix Matrix4 Matrix4.IDENTITY optional The model matrix used to transform the primitive.
customShader CustomShader optional The custom shader used to style the primitive.
clock Clock optional The clock used to control time dynamic behavior.
Experimental

This feature is not final and is subject to change without Cesium's standard deprecation policy.

See:

Members

Gets the bounding sphere.
The ClippingPlaneCollection used to selectively disable rendering the primitive.
Gets or sets the custom shader. If undefined, VoxelPrimitive.DefaultCustomShader is set.

readonly customShaderCompilationEvent : Event

Gets an event that is raised whenever a custom shader is compiled.
Gets or sets whether or not to render debug visualizations.
Gets or sets whether or not to test against depth when rendering.
Gets the voxel dimensions.
Gets or sets whether or not the primitive should update when the view changes.
Gets or sets whether or not to jitter the view ray during the raymarch. This reduces stair-step artifacts but introduces noise.
Gets or sets the maximum bounds in the shape's local coordinate system. Voxel data is stretched or squashed to fit the bounds.
Gets or sets the maximum clipping location in the shape's local coordinate system. Any voxel content outside the range is clipped.

readonly maximumValues : Array.<Array.<number>>

Gets the maximum value per channel of the voxel data.
Gets or sets the minimum bounds in the shape's local coordinate system. Voxel data is stretched or squashed to fit the bounds.
Gets or sets the minimum clipping location in the shape's local coordinate system. Any voxel content outside the range is clipped.

readonly minimumValues : Array.<Array.<number>>

Gets the minimum value per channel of the voxel data.
Gets the model matrix.

nearestSampling : boolean

Gets or sets the nearest sampling.
Gets the oriented bounding box.
Gets the VoxelProvider associated with this primitive.
Gets a value indicating whether or not the primitive is ready for use.

readonly deprecated readyPromise : Promise.<VoxelPrimitive>

Gets the promise that will be resolved when the primitive is ready for use.

Deprecated: true

screenSpaceError : number

Gets or sets the screen space error in pixels. If the screen space size of a voxel is greater than the screen space error, the tile is subdivided. Lower screen space error corresponds with higher detail rendering, but could result in worse performance and higher memory consumption.
Gets the shape type.
Gets or sets whether or not this primitive should be displayed.
Gets or sets the step size multiplier used during raymarching. The lower the value, the higher the rendering quality, but also the worse the performance.

Methods

Destroys the WebGL resources held by this object. Destroying an object allows for deterministic release of WebGL resources, instead of relying on the garbage collector to destroy this object.

Once an object is destroyed, it should not be used; calling any function other than isDestroyed will result in a DeveloperError exception. Therefore, assign the return value (undefined) to the object as done in the example.
Throws:
  • DeveloperError : This object was destroyed, i.e., destroy() was called.
Example:
voxelPrimitive = voxelPrimitive && voxelPrimitive.destroy();
See:

isDestroyed()boolean

Returns true if this object was destroyed; otherwise, false.

If this object was destroyed, it should not be used; calling any function other than isDestroyed will result in a DeveloperError exception.
Returns:
true if this object was destroyed; otherwise, false.
See:
Need help? The fastest way to get answers is from the community and team on the Cesium Forum.