GeometryInstance

new Cesium.GeometryInstance (options)

几何实例化允许一个 Geometry 对象位于几个不同的位置并具有唯一的颜色。例如,可以多次实例化一个 BoxGeometry ,每次使用不同的 modelMatrix 来更改其位置、旋转和比例。
Name Type Description
options Object 具有以下属性的对象:
姓名 类型 默认 描述
geometry 几何 | 几何工厂 要实例化的几何图形。
modelMatrix 矩阵4 Matrix4.IDENTITY 可选 将几何从模型转换为世界坐标的模型矩阵。
id 目的 可选 当使用 Scene#pick 实例或使用 Primitive#getGeometryInstanceAttributes 获取/设置每个实例属性时返回的用户定义对象。
attributes 目的 可选 的 Per-instance 属性,如以下示例中所示的 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.
const geometry = Cesium.BoxGeometry.fromDimensions({
  vertexFormat : Cesium.VertexFormat.POSITION_AND_NORMAL,
  dimensions : new Cesium.Cartesian3(1000000.0, 1000000.0, 500000.0)
});
const instanceBottom = new Cesium.GeometryInstance({
  geometry : geometry,
  modelMatrix : Cesium.Matrix4.multiplyByTranslation(Cesium.Transforms.eastNorthUpToFixedFrame(
    Cesium.Cartesian3.fromDegrees(-75.59777, 40.03883)), new Cesium.Cartesian3(0.0, 0.0, 1000000.0), new Cesium.Matrix4()),
  attributes : {
    color : Cesium.ColorGeometryInstanceAttribute.fromColor(Cesium.Color.AQUA)
  },
  id : 'bottom'
});
const instanceTop = new Cesium.GeometryInstance({
  geometry : geometry,
  modelMatrix : Cesium.Matrix4.multiplyByTranslation(Cesium.Transforms.eastNorthUpToFixedFrame(
    Cesium.Cartesian3.fromDegrees(-75.59777, 40.03883)), new Cesium.Cartesian3(0.0, 0.0, 3000000.0), new Cesium.Matrix4()),
  attributes : {
    color : Cesium.ColorGeometryInstanceAttribute.fromColor(Cesium.Color.AQUA)
  },
  id : 'top'
});
See:

Members

每个实例的属性,如 ColorGeometryInstanceAttribute ShowGeometryInstanceAttribute 。每个顶点的 Geometry 属性不同;这些属性对于整个实例都是不变的。
Default Value: undefined
被实例化的几何体。
Default Value: undefined
选择实例或用于获取/设置每个实例属性时返回的用户定义对象。
Default Value: undefined
See:
将几何从模型转换为世界坐标的 4x4 转换矩阵。当这是单位矩阵时,几何图形是在世界坐标系中绘制的,即地球的 WGS84 坐标系。可以通过提供不同的变换矩阵来使用本地参考帧,就像 Transforms.eastNorthUpToFixedFrame 返回的那样。
Default Value: Matrix4.IDENTITY