Cesium3DTilesVoxelProvider

new Cesium.Cesium3DTilesVoxelProvider(options)

A VoxelProvider that fetches voxel data from a 3D Tiles tileset.

Implements the VoxelProvider interface.

This object is normally not instantiated directly, use Cesium3DTilesVoxelProvider.fromUrl.
参数名称 类型 描述信息
options Cesium3DTilesVoxelProvider.ConstructorOptions An object describing initialization options
Experimental

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

参考:

继承

成员(属性)

readonly availableLevels : number|undefined

The number of levels of detail containing available tiles in the tileset.
The metadata class for this tileset.
Gets the metadata component types.
Gets the number of voxels per dimension of a tile. This is the same for all tiles in the dataset.
A transform from local space to global space.
默认值: Matrix4.IDENTITY
Gets the maximum bounds. If undefined, the shape's default maximum bounds will be used instead.

readonly maximumTileCount : number|undefined

The maximum number of tiles that exist for this provider. This value is used as a hint to the voxel renderer to allocate an appropriate amount of GPU memory. If this value is not known it can be undefined.

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

Gets the metadata maximum values.
Gets the ordering of the metadata in the buffers.
Gets the minimum bounds. If undefined, the shape's default minimum bounds will be used instead.

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

Gets the metadata minimum values.
Gets the metadata names.
Gets the number of padding voxels after the tile. This improves rendering quality when sampling the edge of a tile, but it increases memory usage.
默认值: Cartesian3.ZERO
Gets the number of padding voxels before the tile. This improves rendering quality when sampling the edge of a tile, but it increases memory usage.
默认值: Cartesian3.ZERO
Gets the VoxelShapeType
A transform from shape space to local space.
默认值: Matrix4.IDENTITY
Gets the metadata types.

方法

static Cesium.Cesium3DTilesVoxelProvider.fromUrl(url)Promise.<Cesium3DTilesVoxelProvider>

Creates a Cesium3DTilesVoxelProvider that fetches voxel data from a 3D Tiles tileset.
参数名称 类型 描述信息
url Resource | string The URL to a tileset JSON file
返回值:
The created provider
Throws:
  • RuntimeException : Root must have content
  • RuntimeException : Root tile content must have 3DTILES_content_voxels extension
  • RuntimeException : Root tile must have implicit tiling
  • RuntimeException : Tileset must have a metadata schema
  • RuntimeException : Only box, region and 3DTILES_bounding_volume_cylinder are supported in Cesium3DTilesVoxelProvider
使用示例:
try {
  const voxelProvider = await Cesium3DTilesVoxelProvider.fromUrl(
    "http://localhost:8002/tilesets/voxel/tileset.json"
  );
  const voxelPrimitive = new VoxelPrimitive({
    provider: voxelProvider,
    customShader: customShader,
  });
  scene.primitives.add(voxelPrimitive);
} catch (error) {
  console.error(`Error creating voxel primitive: ${error}`);
}
参考:

requestData(options)Promise.<VoxelContent>|undefined

Requests the data for a given tile.
参数名称 类型 描述信息
options object 可选 Object with the following properties:
参数名称 类型 默认值 描述信息
tileLevel number 0 可选 The tile's level.
tileX number 0 可选 The tile's X coordinate.
tileY number 0 可选 The tile's Y coordinate.
tileZ number 0 可选 The tile's Z coordinate.
返回值:
A promise resolving to a VoxelContent containing the data for the tile, or undefined if the request could not be scheduled this frame.

定义的类型

Cesium.Cesium3DTilesVoxelProvider.ConstructorOptions

Initialization options for the Cesium3DTilesVoxelProvider constructor
属性:
属性名称 类型 可选 默认值 描述信息
className string The class in the tileset schema describing voxel metadata.
names Array.<string> The metadata names.
types Array.<MetadataType> The metadata types.
componentTypes Array.<MetadataComponentType> The metadata component types.
shape VoxelShapeType The VoxelShapeType.
dimensions Cartesian3 The number of voxels per dimension of a tile. This is the same for all tiles in the dataset.
paddingBefore Cartesian3 <可选>
Cartesian3.ZERO The number of padding voxels before the tile. This improves rendering quality when sampling the edge of a tile, but it increases memory usage.
paddingAfter Cartesian3 <可选>
Cartesian3.ZERO The number of padding voxels after the tile. This improves rendering quality when sampling the edge of a tile, but it increases memory usage.
globalTransform Matrix4 <可选>
Matrix4.IDENTITY A transform from local space to global space.
shapeTransform Matrix4 <可选>
Matrix4.IDENTITY A transform from shape space to local space.
minBounds Cartesian3 <可选>
The minimum bounds.
maxBounds Cartesian3 <可选>
The maximum bounds.
minimumValues Array.<Array.<number>> <可选>
The metadata minimum values.
maximumValues Array.<Array.<number>> <可选>
The metadata maximum values.
maximumTileCount number <可选>
The maximum number of tiles that exist for this provider. This value is used as a hint to the voxel renderer to allocate an appropriate amount of GPU memory. If this value is not known it can be undefined.