Cesium API - ColorGeometryInstanceAttribute 中文文档

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

ColorGeometryInstanceAttribute API 调用方法

new Cesium.ColorGeometryInstanceAttribute(red, green, blue, alpha)

Core/ColorGeometryInstanceAttribute.js 36

每个实例的几何颜色的值和类型信息。

Name	Type	Default	Description
`red`	Number	`1.0`	optional 红色分量。
`green`	Number	`1.0`	optional 绿色分量。
`blue`	Number	`1.0`	optional 蓝色分量。
`alpha`	Number	`1.0`	optional alpha分量。

示例：

var instance = new Cesium.GeometryInstance({
  geometry : Cesium.BoxGeometry.fromDimensions({
    dimensions : new Cesium.Cartesian3(1000000.0, 1000000.0, 500000.0)
  }),
  modelMatrix : Cesium.Matrix4.multiplyByTranslation(Cesium.Transforms.eastNorthUpToFixedFrame(
    Cesium.Cartesian3.fromDegrees(0.0, 0.0)), new Cesium.Cartesian3(0.0, 0.0, 1000000.0), new Cesium.Matrix4()),
  id : 'box',
  attributes : {
    color : new Cesium.ColorGeometryInstanceAttribute(red, green, blue, alpha)
  }
});

参考：

成员变量

readonlycomponentDatatype : ComponentDatatype

Core/ColorGeometryInstanceAttribute.js 69

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

Default Value: ComponentDatatype.UNSIGNED_BYTE

readonlycomponentsPerAttribute : Number

Core/ColorGeometryInstanceAttribute.js 85

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

Default Value: 4

readonlynormalize : Boolean

Core/ColorGeometryInstanceAttribute.js 102

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

Default Value: true

value : Uint8Array

Core/ColorGeometryInstanceAttribute.js 49

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

Default Value: [255, 255, 255, 255]

内置方法

staticCesium.ColorGeometryInstanceAttribute.equals(left, right) → Boolean

Core/ColorGeometryInstanceAttribute.js 165

比较提供的ColorGeometryInstanceAttributes，如果相等，返回true，否则返回false。

Name	Type	Description
`left`	ColorGeometryInstanceAttribute	optional 第一个ColorGeometryInstanceAttribute。
`right`	ColorGeometryInstanceAttribute	optional 第二个ColorGeometryInstanceAttribute。

返回值：

如果两者相等，则为true；否则false。

staticCesium.ColorGeometryInstanceAttribute.fromColor(color) → ColorGeometryInstanceAttribute

Core/ColorGeometryInstanceAttribute.js 123

根据提供的Color创建一个新的ColorGeometryInstanceAttribute实例。

Name	Type	Description
`color`	Color	颜色。

返回值：

新的ColorGeometryInstanceAttribute实例。

示例：

var instance = new Cesium.GeometryInstance({
  geometry : geometry,
  attributes : {
    color : Cesium.ColorGeometryInstanceAttribute.fromColor(Cesium.Color.CORNFLOWERBLUE),
  }
});

staticCesium.ColorGeometryInstanceAttribute.toValue(color, result) → Uint8Array

Core/ColorGeometryInstanceAttribute.js 145

将颜色转换为可用于分配颜色属性的类型化数组。

Name	Type	Description
`color`	Color	颜色。
`result`	Uint8Array	optional 存储结果的数组，如果未定义，将创建一个新实例。

返回值：

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

示例：

var attributes = primitive.getGeometryInstanceAttributes('an id');
attributes.color = Cesium.ColorGeometryInstanceAttribute.toValue(Cesium.Color.AQUA, attributes.color);