Cesium API - DistanceDisplayConditionGeometryInstanceAttribute 中文文档

本文介绍下Cesium中 DistanceDisplayConditionGeometryInstanceAttribute API的详细使用说明。

DistanceDisplayConditionGeometryInstanceAttribute API 调用方法

new Cesium.DistanceDisplayConditionGeometryInstanceAttribute(near, far)

Core/DistanceDisplayConditionGeometryInstanceAttribute.js 65

每个实例的几何属性的值和类型信息，其确定几何实例是否具有距离显示条件。

Name	Type	Default	Description
`near`	Number	`0.0`	optional 近距离。
`far`	Number	`Number.MAX_VALUE`	optional 远距离。

异常情况：

DeveloperError : far 必须大于 near。

示例：

var instance = new Cesium.GeometryInstance({
  geometry : new Cesium.BoxGeometry({
    vertexFormat : Cesium.VertexFormat.POSITION_AND_NORMAL,
    minimum : new Cesium.Cartesian3(-250000.0, -250000.0, -250000.0),
    maximum : new Cesium.Cartesian3(250000.0, 250000.0, 250000.0)
  }),
  modelMatrix : Cesium.Matrix4.multiplyByTranslation(Cesium.Transforms.eastNorthUpToFixedFrame(
    Cesium.Cartesian3.fromDegrees(-75.59777, 40.03883)), new Cesium.Cartesian3(0.0, 0.0, 1000000.0), new Cesium.Matrix4()),
  id : 'box',
  attributes : {
    distanceDisplayCondition : new Cesium.DistanceDisplayConditionGeometryInstanceAttribute(100.0, 10000.0)
  }
});

参考：

成员变量

readonlycomponentDatatype : ComponentDatatype

Core/DistanceDisplayConditionGeometryInstanceAttribute.js 97

属性中每个分量数据类型，例如，其中的单个元素。 DistanceDisplayConditionGeometryInstanceAttribute#value.

Default Value: ComponentDatatype.FLOAT

readonlycomponentsPerAttribute : Number

Core/DistanceDisplayConditionGeometryInstanceAttribute.js 113

属性中分量的数量，即DistanceDisplayConditionGeometryInstanceAttribute#value。

Default Value: 3

readonlynormalize : Boolean

Core/DistanceDisplayConditionGeometryInstanceAttribute.js 130

当true 和 componentDatatype为整数格式时，表示当以浮点方式访问分量以进行渲染时，应将其映射到范围[0,1](无符号)或[- 1,1](有符号)。

Default Value: false

value : Float32Array

Core/DistanceDisplayConditionGeometryInstanceAttribute.js 82

存储在类型化数组中的属性的值。

Default Value: [0.0, 0.0, Number.MAX_VALUE]

内置方法

staticCesium.DistanceDisplayConditionGeometryInstanceAttribute.fromDistanceDisplayCondition(distanceDisplayCondition) → DistanceDisplayConditionGeometryInstanceAttribute

Core/DistanceDisplayConditionGeometryInstanceAttribute.js 154

创建一个新的DistanceDisplayConditionGeometryInstanceAttribute实例，其中提供了一个启用标志和DistanceDisplayCondition。

Name	Type	Description
`distanceDisplayCondition`	DistanceDisplayCondition	距离显示条件。

返回值：

新的DistanceDisplayConditionGeometryInstanceAttribute实例。

异常情况：

DeveloperError : distanceDisplayCondition.far 必须大于 distanceDisplayCondition.near。

示例：

var distanceDisplayCondition = new Cesium.DistanceDisplayCondition(100.0, 10000.0);
var instance = new Cesium.GeometryInstance({
  geometry : geometry,
  attributes : {
    distanceDisplayCondition : Cesium.DistanceDisplayConditionGeometryInstanceAttribute.fromDistanceDisplayCondition(distanceDisplayCondition)
  }
});

staticCesium.DistanceDisplayConditionGeometryInstanceAttribute.toValue(distanceDisplayCondition, result) → Float32Array

Core/DistanceDisplayConditionGeometryInstanceAttribute.js 178

将距离显示条件转换为可用于分配距离显示条件属性的类型化数组。

Name	Type	Description
`distanceDisplayCondition`	DistanceDisplayCondition	距离显示条件值。
`result`	Float32Array	optional 存储结果的数组，如果未定义，将创建一个新实例。

返回值：

修改后的结果参数或如果结果未定义，则创建一个新实例。

示例：

var attributes = primitive.getGeometryInstanceAttributes('an id');
attributes.distanceDisplayCondition = Cesium.DistanceDisplayConditionGeometryInstanceAttribute.toValue(distanceDisplayCondition, attributes.distanceDisplayCondition);