GeometryInstanceAttribute

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

Members

componentDatatype : ComponentDatatype

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

componentsPerAttribute : Number

一个介于1和4之间的数字，用于定义属性中组件的数量。例如，具有x、y和z组件的位置属性将有3个，如代码示例所示。
Default Value: undefined
Example:
show : new bmgl.GeometryInstanceAttribute({
  componentDatatype : bmgl.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 = bmgl.ComponentDatatype.UNSIGNED_BYTE;
attribute.componentsPerAttribute = 4;
attribute.normalize = true;
attribute.value = [
  bmgl.Color.floatToByte(color.red),
  bmgl.Color.floatToByte(color.green),
  bmgl.Color.floatToByte(color.blue),
  bmgl.Color.floatToByte(color.alpha)
];

value : Array.<Number>

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