PolygonOutlineGeometry

new Cesium.PolygonOutlineGeometry(options)

椭球上多边形轮廓的描述。多边形由多边形层次结构定义。
Name Type Description
options object 包含以下属性的对象:
Name Type Default Description
polygonHierarchy PolygonHierarchy 可包含孔洞的多边形层次结构。
height number 0.0 optional 多边形与椭球表面之间的距离(米)。
extrudedHeight number optional 多边形拉伸面与椭球表面之间的距离(米)。
vertexFormat VertexFormat VertexFormat.DEFAULT optional 待计算的顶点属性。
ellipsoid Ellipsoid Ellipsoid.default optional 用作参考的椭球体。
granularity number CesiumMath.RADIANS_PER_DEGREE optional 每个经纬度之间的角距离(弧度)。决定缓冲区中的位置数量。
perPositionHeight boolean false optional 对每个位置使用options.positions的高度,而非使用options.height确定高度。
arcType ArcType ArcType.GEODESIC optional 轮廓必须遵循的路径类型。有效选项为LinkType.GEODESICArcType.RHUMB
Example:
// 1. create a polygon outline from points
const polygon = new Cesium.PolygonOutlineGeometry({
  polygonHierarchy : new Cesium.PolygonHierarchy(
    Cesium.Cartesian3.fromDegreesArray([
      -72.0, 40.0,
      -70.0, 35.0,
      -75.0, 30.0,
      -70.0, 30.0,
      -68.0, 40.0
    ])
  )
});
const geometry = Cesium.PolygonOutlineGeometry.createGeometry(polygon);

// 2. create a nested polygon with holes outline
const polygonWithHole = new Cesium.PolygonOutlineGeometry({
  polygonHierarchy : new Cesium.PolygonHierarchy(
    Cesium.Cartesian3.fromDegreesArray([
      -109.0, 30.0,
      -95.0, 30.0,
      -95.0, 40.0,
      -109.0, 40.0
    ]),
    [new Cesium.PolygonHierarchy(
      Cesium.Cartesian3.fromDegreesArray([
        -107.0, 31.0,
        -107.0, 39.0,
        -97.0, 39.0,
        -97.0, 31.0
      ]),
      [new Cesium.PolygonHierarchy(
        Cesium.Cartesian3.fromDegreesArray([
          -105.0, 33.0,
          -99.0, 33.0,
          -99.0, 37.0,
          -105.0, 37.0
        ]),
        [new Cesium.PolygonHierarchy(
          Cesium.Cartesian3.fromDegreesArray([
            -103.0, 34.0,
            -101.0, 34.0,
            -101.0, 36.0,
            -103.0, 36.0
          ])
        )]
      )]
    )]
  )
});
const geometry = Cesium.PolygonOutlineGeometry.createGeometry(polygonWithHole);

// 3. create extruded polygon outline
const extrudedPolygon = new Cesium.PolygonOutlineGeometry({
  polygonHierarchy : new Cesium.PolygonHierarchy(
    Cesium.Cartesian3.fromDegreesArray([
      -72.0, 40.0,
      -70.0, 35.0,
      -75.0, 30.0,
      -70.0, 30.0,
      -68.0, 40.0
    ])
  ),
  extrudedHeight: 300000
});
const geometry = Cesium.PolygonOutlineGeometry.createGeometry(extrudedPolygon);
See:
  • PolygonOutlineGeometry#createGeometry
  • PolygonOutlineGeometry#fromPositions

Members

用于将对象打包到数组中的元素数量。

Methods

static Cesium.PolygonOutlineGeometry.createGeometry(polygonGeometry)Geometry|undefined

计算多边形轮廓的几何表示,包括其顶点、索引和边界球。
Name Type Description
polygonGeometry PolygonOutlineGeometry 多边形轮廓的描述。
Returns:
计算得到的顶点和索引。

static Cesium.PolygonOutlineGeometry.fromPositions(options)PolygonOutlineGeometry

从位置数组定义的多边形轮廓描述。
Name Type Description
options object 包含以下属性的对象:
Name Type Default Description
positions Array.<Cartesian3> 定义多边形角点的位置数组。
height number 0.0 optional 多边形的高度。
extrudedHeight number optional 多边形拉伸的高度。
ellipsoid Ellipsoid Ellipsoid.default optional 用作参考的椭球体。
granularity number CesiumMath.RADIANS_PER_DEGREE optional 每个经纬度之间的角距离(弧度)。决定缓冲区中的位置数量。
perPositionHeight boolean false optional 对每个位置使用options.positions的高度,而非使用options.height确定高度。
arcType ArcType ArcType.GEODESIC optional 轮廓必须遵循的路径类型。有效选项为LinkType.GEODESICArcType.RHUMB
Returns:
Example:
// create a polygon from points
const polygon = Cesium.PolygonOutlineGeometry.fromPositions({
  positions : Cesium.Cartesian3.fromDegreesArray([
    -72.0, 40.0,
    -70.0, 35.0,
    -75.0, 30.0,
    -70.0, 30.0,
    -68.0, 40.0
  ])
});
const geometry = Cesium.PolygonOutlineGeometry.createGeometry(polygon);
See:
  • PolygonOutlineGeometry#createGeometry

static Cesium.PolygonOutlineGeometry.pack(value, array, startingIndex)Array.<number>

将提供的实例存储到提供的数组中。
Name Type Default Description
value PolygonOutlineGeometry 要打包的值。
array Array.<number> 要打包到的数组。
startingIndex number 0 optional 数组中开始打包元素的索引。
Returns:
被打包到的数组

static Cesium.PolygonOutlineGeometry.unpack(array, startingIndex, result)PolygonOutlineGeometry

从打包的数组中检索实例。
Name Type Default Description
array Array.<number> 打包数组。
startingIndex number 0 optional 要解包的元素起始索引。
result PolygonOutlineGeometry optional 存储结果的对象。
Returns:
修改后的结果参数,若未提供则返回新的PolygonOutlineGeometry实例。
Need help? The fastest way to get answers is from the community and team on the Cesium Forum.