幾何體實(shí)例化允許一個(gè)
new GeometryInstance(options)
Geometry對(duì)象在多個(gè)不同的位置，并且顏色獨(dú)特。例如，一個(gè)BoxGeometry可以多次實(shí)例化，每個(gè)BoxGeometry具有不同的modelMatrix來(lái)更改其位置、旋轉(zhuǎn)和比例。
Parameters:
options
(Object)
| Name | Description |
|---|---|
options.geometry
Geometry
|
要實(shí)例的幾何體。 |
options.modelMatrix
Matrix4
default Matrix4.IDENTITY
|
將幾何體從模型轉(zhuǎn)換為世界坐標(biāo)的模型矩陣。 |
options.id
Object
|
使用Scene#pick或使用Primitive#getGeometryInstanceAttributes獲取/設(shè)置每個(gè)實(shí)例屬性時(shí)要返回的用戶定義對(duì)象。
|
options.attributes
Object
|
每個(gè)實(shí)例的屬性，如下面示例中顯示的show或color屬性。 |
Example
// Create geometry for a box, and two instances that refer to it.
// One instance positions the box on the bottom and colored aqua.
// The other instance positions the box on the top and color white.
var geometry = bmgl.BoxGeometry.fromDimensions({
vertexFormat : bmgl.VertexFormat.POSITION_AND_NORMAL,
dimensions : new bmgl.Cartesian3(1000000.0, 1000000.0, 500000.0)
});
var instanceBottom = new bmgl.GeometryInstance({
geometry : geometry,
modelMatrix : bmgl.Matrix4.multiplyByTranslation(bmgl.Transforms.eastNorthUpToFixedFrame(
bmgl.Cartesian3.fromDegrees(-75.59777, 40.03883)), new bmgl.Cartesian3(0.0, 0.0, 1000000.0), new bmgl.Matrix4()),
attributes : {
color : bmgl.ColorGeometryInstanceAttribute.fromColor(bmgl.Color.AQUA)
},
id : 'bottom'
});
var instanceTop = new bmgl.GeometryInstance({
geometry : geometry,
modelMatrix : bmgl.Matrix4.multiplyByTranslation(bmgl.Transforms.eastNorthUpToFixedFrame(
bmgl.Cartesian3.fromDegrees(-75.59777, 40.03883)), new bmgl.Cartesian3(0.0, 0.0, 3000000.0), new bmgl.Matrix4()),
attributes : {
color : bmgl.ColorGeometryInstanceAttribute.fromColor(bmgl.Color.AQUA)
},
id : 'top'
});See:
Members
attributes : Object
每個(gè)實(shí)例的屬性，如
ColorGeometryInstanceAttribute或ShowGeometryInstanceAttribute。Geometry每個(gè)頂點(diǎn)的屬性不同；這些屬性對(duì)于整個(gè)實(shí)例都是常量。
-
Default Value:
undefined
geometry : Geometry
正在實(shí)例化的幾何體。
-
Default Value:
undefined
id : Object
選擇實(shí)例或使用實(shí)例獲取/設(shè)置每個(gè)實(shí)例屬性時(shí)返回的用戶定義對(duì)象。
-
Default Value:
undefined
See:
modelMatrix : Matrix4
將幾何體從模型坐標(biāo)轉(zhuǎn)換為世界坐標(biāo)的4x4轉(zhuǎn)換矩陣。當(dāng)這是單位矩陣時(shí)，幾何圖形以世界坐標(biāo)繪制，即地球的wgs84坐標(biāo)。本地參考幀可以通過(guò)提供不同的轉(zhuǎn)換矩陣來(lái)使用，如
Transforms.eastNorthUpToFixedFrame返回的轉(zhuǎn)換矩陣。
-
Default Value:
Matrix4.IDENTITY