每個實例幾何圖形屬性的值和類型信息。
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之間。
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]
})