Cesium3DTilesVoxelProvider

new Cesium.Cesium3DTilesVoxelProvider(options)

一个从 3D Tiles 切片集获取体素数据的 VoxelProvider

实现了 VoxelProvider 接口。

此对象通常不直接实例化,请使用 Cesium3DTilesVoxelProvider.fromUrl
Name Type Description
options Cesium3DTilesVoxelProvider.ConstructorOptions 描述初始化选项的对象
Experimental

此功能尚未最终确定,可能会在不适用 Cesium 标准弃用策略的情况下发生变更。

See:

Extends

Members

readonly availableLevels : number|undefined

切片集中包含可用切片的细节层次数量。
此切片集的元数据类。
获取元数据组件类型。
获取每个切片每维的体素数量。数据集中所有切片的此值相同。
从局部空间到全局空间的变换。
Default Value: Matrix4.IDENTITY
获取最大边界。 如果为 undefined,则改用形状的默认最大边界。

readonly maximumTileCount : number|undefined

此提供程序存在的最大切片数量。 此值作为提示提供给体素渲染器,以分配适当数量的 GPU 内存。 如果此值未知,可以为 undefined。

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

获取元数据最大值。
获取最小边界。 如果为 undefined,则改用形状的默认最小边界。

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

获取元数据最小值。
获取元数据名称。
获取切片之后的填充体素数量。这可以提高采样切片边缘时的渲染质量,但会增加内存使用量。
Default Value: Cartesian3.ZERO
获取切片之前的填充体素数量。这可以提高采样切片边缘时的渲染质量,但会增加内存使用量。
Default Value: Cartesian3.ZERO
从形状空间到局部空间的变换。
Default Value: Matrix4.IDENTITY
获取元数据类型。

Methods

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

创建一个从 3D Tiles 切片集获取体素数据的 Cesium3DTilesVoxelProvider
Name Type Description
url Resource | string 切片集 JSON 文件的 URL
Returns:
创建的提供程序
Throws:
  • RuntimeException : 根节点必须包含内容
  • RuntimeException : 根切片内容必须具有 3DTILES_content_voxels 扩展
  • RuntimeException : 根切片必须具有隐式切片
  • RuntimeException : 切片集必须具有元数据模式
  • RuntimeException : Cesium3DTilesVoxelProvider 中仅支持 box、region 和 3DTILES_bounding_volume_cylinder
Example:
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}`);
}
See:

requestData(options)Promise.<VoxelContent>|undefined

请求给定切片的数据。
Name Type Description
options object optional 具有以下属性的对象:
Name Type Default Description
tileLevel number 0 optional 切片的层级。
tileX number 0 optional 切片的 X 坐标。
tileY number 0 optional 切片的 Y 坐标。
tileZ number 0 optional 切片的 Z 坐标。
Returns:
一个解析为包含切片数据的 VoxelContent 的 Promise,如果该请求无法在当前帧调度则为 undefined。

Type Definitions

Cesium.Cesium3DTilesVoxelProvider.ConstructorOptions

Cesium3DTilesVoxelProvider 构造函数的初始化选项
Properties:
Name Type Attributes Default Description
className string 切片集模式中描述体素元数据的类。
names Array.<string> 元数据名称。
types Array.<MetadataType> 元数据类型。
componentTypes Array.<MetadataComponentType> 元数据组件类型。
shape VoxelShapeType VoxelShapeType
dimensions Cartesian3 每个切片每维的体素数量。数据集中所有切片的此值相同。
paddingBefore Cartesian3 <optional>
Cartesian3.ZERO 切片之前的填充体素数量。这可以提高采样切片边缘时的渲染质量,但会增加内存使用量。
paddingAfter Cartesian3 <optional>
Cartesian3.ZERO 切片之后的填充体素数量。这可以提高采样切片边缘时的渲染质量,但会增加内存使用量。
globalTransform Matrix4 <optional>
Matrix4.IDENTITY 从局部空间到全局空间的变换。
shapeTransform Matrix4 <optional>
Matrix4.IDENTITY 从形状空间到局部空间的变换。
minBounds Cartesian3 <optional>
最小边界。
maxBounds Cartesian3 <optional>
最大边界。
minimumValues Array.<Array.<number>> <optional>
元数据最小值。
maximumValues Array.<Array.<number>> <optional>
元数据最大值。
maximumTileCount number <optional>
此提供程序存在的最大切片数量。此值作为提示提供给体素渲染器,以分配适当数量的 GPU 内存。如果此值未知,可以为 undefined。
需要帮助?获取答案的最快方式是在 Cesium 论坛 上向社区和团队提问。