GeometryInstanceAttribute

new SuperMap3D.GeometryInstanceAttribute(options)

确定是否显示几何实例的每个实例几何属性的值和类型信息。
Name Type Description
options Object 具有以下属性的对象：
Name Type Default Description
componentDatatype ComponentDatatype optional 属性中每个组件的数据类型，例如值中的各个元素。
componentsPerAttribute Number optional 介于 1 和 4 之间的数字，用于定义属性中组件的数量。
normalize Boolean false optional 为 true 且 componentDatatype（组件数据类型）为整数格式时，表示在以浮点格式访问组件进行渲染时，应将其映射到范围 [0, 1] （无符号）或 [-1, 1]（有符号）。
value Array.<Number> optional 属性的值。
Throws:
  • DeveloperError : options.componentsPerAttribute 必须介于 1 和 4 之间。
Example:
var instance = new SuperMap3D.GeometryInstance({
  geometry : SuperMap3D.BoxGeometry.fromDimensions({
    dimensions : new SuperMap3D.Cartesian3(1000000.0, 1000000.0, 500000.0)
  }),
  modelMatrix : SuperMap3D.Matrix4.multiplyByTranslation(SuperMap3D.Transforms.eastNorthUpToFixedFrame(
    SuperMap3D.Cartesian3.fromDegrees(0.0, 0.0)), new SuperMap3D.Cartesian3(0.0, 0.0, 1000000.0), new SuperMap3D.Matrix4()),
  id : 'box',
  attributes : {
    color : new SuperMap3D.GeometryInstanceAttribute({
      componentDatatype : SuperMap3D.ComponentDatatype.UNSIGNED_BYTE,
      componentsPerAttribute : 4,
      normalize : true,
      value : [255, 255, 0, 255]
    })
  }
});
See:

Members

componentDatatype : ComponentDatatype

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

componentsPerAttribute : Number

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

normalize : Boolean

为 true 且 componentDatatype（组件数据类型）为整数格式时，表示在以浮点格式访问组件进行渲染时，应将其映射到范围 [0, 1] （无符号）或 [-1, 1]（有符号）。 这通常用于使用 ComponentDatatype.UNSIGNED_BYTE 来存储颜色。
Default Value: false
Example:
attribute.componentDatatype = SuperMap3D.ComponentDatatype.UNSIGNED_BYTE;
attribute.componentsPerAttribute = 4;
attribute.normalize = true;
attribute.value = [
  SuperMap3D.Color.floatToByte(color.red),
  SuperMap3D.Color.floatToByte(color.green),
  SuperMap3D.Color.floatToByte(color.blue),
  SuperMap3D.Color.floatToByte(color.alpha)
];

value : Array.<Number>

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