GeometryInstanceAttribute

new Cesium.GeometryInstanceAttribute (options)
Core/GeometryInstanceAttribute.js 42

每个实例几何属性的值和类型信息。
Name Type Description
options Object 具有以下属性的对象:
姓名 类型 默认 描述
componentDatatype 组件数据类型 属性中每个组件的数据类型，例如值中的单个元素。
componentsPerAttribute 数字 一个介于 1 和 4 之间的数字，用于定义属性中组件的数量。
normalize 布尔值 false 可选 当 true 且 componentDatatype 为整数格式时，指示组件在作为浮点访问以进行渲染时应映射到范围 [0, 1]（无符号）或 [-1, 1]（有符号）。
value 数组.<数字> 属性的值。
Throws:
  • DeveloperError : options.componentsPerAttribute 必须介于 1 和 4 之间。
Example: 
const 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.GeometryInstanceAttribute({
      componentDatatype : Cesium.ComponentDatatype.UNSIGNED_BYTE,
      componentsPerAttribute : 4,
      normalize : true,
      value : [255, 255, 0, 255]
    })
  }
});
See:

Members

componentDatatype : ComponentDatatype
Core/GeometryInstanceAttribute.js 73

属性中每个组件的数据类型，例如 GeometryInstanceAttribute#value 中的单个元素。
Default Value: undefined

componentsPerAttribute : Number
Core/GeometryInstanceAttribute.js 92

一个介于 1 和 4 之间的数字，用于定义属性中组件的数量。例如，具有 x、y 和 z 分量的位置属性将具有 3，如代码示例中所示。
Default Value: undefined
Example: 
show : new Cesium.GeometryInstanceAttribute({
  componentDatatype : Cesium.ComponentDatatype.UNSIGNED_BYTE,
  componentsPerAttribute : 1,
  normalize : true,
  value : [1.0]
})

normalize : Boolean
Core/GeometryInstanceAttribute.js 117

当为 true 且 componentDatatype 为整数格式时，指示组件在作为浮点访问以进行渲染时应映射到范围 [0, 1]（无符号）或 [-1, 1]（有符号）。

这通常在使用 ComponentDatatype.UNSIGNED_BYTE 存储颜色时使用。

Default Value: false
Example: 
attribute.componentDatatype = Cesium.ComponentDatatype.UNSIGNED_BYTE;
attribute.componentsPerAttribute = 4;
attribute.normalize = true;
attribute.value = [
  Cesium.Color.floatToByte(color.red),
  Cesium.Color.floatToByte(color.green),
  Cesium.Color.floatToByte(color.blue),
  Cesium.Color.floatToByte(color.alpha)
];

value : Array.<Number>
Core/GeometryInstanceAttribute.js 136

存储在类型化数组中的属性值。在代码示例中， values 中的每三个元素定义一个属性，因为 componentsPerAttribute 为 3。
Default Value: undefined
Example: 
show : new Cesium.GeometryInstanceAttribute({
  componentDatatype : Cesium.ComponentDatatype.UNSIGNED_BYTE,
  componentsPerAttribute : 1,
  normalize : true,
  value : [1.0]
})