Cesium API - GeometryInstance 中文文档

本文介绍下Cesium中 GeometryInstance API的详细使用说明。

GeometryInstance API 调用方法

new Cesium.GeometryInstance(options)

Core/GeometryInstance.js 48

几何图形实例允许一个Geometry对象位于几个不同的位置和独特的（uniquely）颜色。例如，一个BoxGeometry可以实例化多次，每次都使用不同的modelMatrix来改变它的位置、旋转和比例。

Name Type Description

options

Object

对象，具有以下属性：

Name	Type	Default	Description
`geometry`	Geometry		实例化的几何。
`modelMatrix`	Matrix4	`Matrix4.IDENTITY`	optional 转换模型矩阵，将几何图形从模型坐标转换为世界坐标。
`id`	Object		optional 当使用`Scene#pick`选择实例或使用`Primitive#getGeometryInstanceAttributes`获取/设置每个实例的属性时，返回一个用户定义的对象。
`attributes`	Object		optional 每个实例的属性，如下面示例中显示的show或color属性。

示例：

// 为一个box创建几何图形，以及引用它的两个实例。
// 一个实例将盒子放置在底部，且颜色设置为浅绿色。
// 另一个实例将盒子放置在顶部，并将颜色设置为白色。
var geometry = Cesium.BoxGeometry.fromDimensions({
  vertexFormat : Cesium.VertexFormat.POSITION_AND_NORMAL,
  dimensions : new Cesium.Cartesian3(1000000.0, 1000000.0, 500000.0)
});
var 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'
});
var 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'
});

参考：