EllipsoidGeometryUpdater

EllipsoidGeometryUpdater 是一个负责更新 Cesium 中椭球体几何图形的帮助程序。

描述

EllipsoidGeometryUpdater 可以用于更新椭球体几何图形的位置、方向、尺寸和形状属性。

要使用 EllipsoidGeometryUpdater，请将其附加到 Cesium.Entity 中的 EllipsoidGraphics 内容。

var entity = viewer.entities.add({
  name : 'Ellipsoid',
  position: Cesium.Cartesian3.fromDegrees(-75.59777, 40.03883),
  ellipsoid : {
    radii : new Cesium.Cartesian3(100000.0, 100000.0, 200000.0),
    material : Cesium.Color.RED.withAlpha(0.5)
  }
});

var updater = new Cesium.EllipsoidGeometryUpdater(entity);

方法

update(time)

更新椭球体几何图形的位置、方向、尺寸和形状属性。

参数（Parameters）:

• time : 当前模拟时间以及模拟时间间隔的对象。

isDestroyed()

当帮助程序被销毁时返回 true，否则返回 false。

事件

onTerrainChanged

当椭球体几何图形所在的地形发生变化时触发的事件。

var entity = viewer.entities.add({
  name : 'Ellipsoid',
  position: Cesium.Cartesian3.fromDegrees(-75.59777, 40.03883),
  ellipsoid : {
    radii : new Cesium.Cartesian3(100000.0, 100000.0, 200000.0),
    material : Cesium.Color.RED.withAlpha(0.5)
  }
});

var updater = new Cesium.EllipsoidGeometryUpdater(entity);

updater.onTerrainChanged.addEventListener(function() {
  console.log('Terrain has changed, updating ellipsoid geometry.');
});

属性

entity

要更新的 Cesium.Entity。

fillEnabled

一个布尔值，指示椭球体是否填充。默认值为 true。

granularity

一个数字，表示椭球体表面的细分级别。默认为 0.1。

heightReference

一个定义椭球体几何图形的高度参考类型的常量。

默认值为 Cesium.HeightReference.NONE。

radii

描述椭球体 X、Y 和 Z 尺寸的三元组。默认值为 (1.0, 1.0, 1.0)。

show

一个布尔值，指示是否显示椭球体。默认值为 true。

vertexFormat

定义椭球体顶点格式的常量。

默认情况下，顶点格式为 Cesium.PerInstanceColorAppearance.VERTEX_FORMAT。

示例

设置椭球体几何图形的位置、尺寸和方向。

var entity = viewer.entities.add({
  name : 'Ellipsoid',
  position: Cesium.Cartesian3.fromDegrees(-75.59777, 40.03883),
  ellipsoid : {
    radii : new Cesium.Cartesian3(100000.0, 100000.0, 200000.0),
    material : Cesium.Color.RED.withAlpha(0.5)
  }
});

var updater = new Cesium.EllipsoidGeometryUpdater(entity);
updater.radii = new Cesium.Cartesian3(200000.0, 100000.0, 100000.0);
updater.position = Cesium.Cartesian3.fromDegrees(-75.59728, 40.03945);
updater.orientation = Cesium.Transforms.headingPitchRollQuaternion(updater.position, new Cesium.HeadingPitchRoll(0.5, 0, 0));

异常

• 如果 entity 不是 Cesium.Entity 类型，则抛出一个 TypeError。
• 如果 entity 的 ellipsoidGraphics 不是 Cesium.EllipsoidGraphics 类型，则抛出一个 TypeError。

参见

• Cesium.EllipsoidGraphics
• Cesium.Entity
• Cesium.Transforms