PolygonGeometry - CesiumJS API 文档

new Cesium.PolygonGeometry(options)

A description of a polygon on the ellipsoid. The polygon is defined by a polygon hierarchy. Polygon geometry can be rendered with both Primitive and GroundPrimitive.

Name Type Description

options

object

下列属性的对象 :

Name	Type	Default	Description
`polygonHierarchy`	PolygonHierarchy		多边形结构可以包括孔.
`height`	number	`0.0`	optional 多边形与椭圆表面之间的米数距离.
`extrudedHeight`	number		optional 多边形外凸面与椭圆形表面之间以米计的距离.
`vertexFormat`	VertexFormat	`VertexFormat.DEFAULT`	optional The vertex attributes to be computed.
`stRotation`	number	`0.0`	optional 纹理坐标的旋转,以弧度表示. 正旋转是逆时针.
`ellipsoid`	Ellipsoid	`Ellipsoid.default`	optional The ellipsoid to be used as a reference.
`granularity`	number	`CesiumMath.RADIANS_PER_DEGREE`	optional The distance, in radians, between each latitude and longitude. Determines the number of positions in the buffer.
`perPositionHeight`	boolean	`false`	optional Use the height of options.positions for each position instead of using options.height to determine the height.
`closeTop`	boolean	`true`	optional When false, leaves off the top of an extruded polygon open.
`closeBottom`	boolean	`true`	optional When false, leaves off the bottom of an extruded polygon open.
`arcType`	ArcType	`ArcType.GEODESIC`	optional The type of line the polygon edges must follow. Valid options are `ArcType.GEODESIC` and `ArcType.RHUMB`.
`textureCoordinates`	PolygonHierarchy		optional Texture coordinates as a `PolygonHierarchy` of `Cartesian2` points. Has no effect for ground primitives.

Example:

// 1. create a polygon from points
const polygon = new Cesium.PolygonGeometry({
  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.PolygonGeometry.createGeometry(polygon);

// 2. create a nested polygon with holes
const polygonWithHole = new Cesium.PolygonGeometry({
  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.PolygonGeometry.createGeometry(polygonWithHole);

// 3. create extruded polygon
const extrudedPolygon = new Cesium.PolygonGeometry({
  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.PolygonGeometry.createGeometry(extrudedPolygon);

Demo:

Cesium Sandcastle Polygon Demo

See:

PolygonGeometry#createGeometry
PolygonGeometry#fromPositions

Members

packedLength : number

用于将对象组合成数组的元素数量.

Methods

static Cesium.PolygonGeometry.computeRectangleFromPositions(positions, ellipsoid, arcType, result) → Rectangle

计算一个矩形,其中包含位置列表定义的多边形,包括国际日期线和极线上的大小写.

Name	Type	Default	Description
`positions`	Array.<Cartesian3>		定义多边形外部边界的线性环.
`ellipsoid`	Ellipsoid	`Ellipsoid.default`	optional The ellipsoid to be used as a reference.
`arcType`	ArcType	`ArcType.GEODESIC`	optional The type of line the polygon edges must follow. Valid options are `ArcType.GEODESIC` and `ArcType.RHUMB`.
`result`	Rectangle		optional 存储结果的对象 .

Returns:

结果矩形

static Cesium.PolygonGeometry.createGeometry(polygonGeometry) → Geometry|undefined

计算一个多边形的几何表示,包括它的顶点,指数和边框.

Name	Type	Description
`polygonGeometry`	PolygonGeometry	多边形描述.

Returns:

计算出的顶点和指数.

static Cesium.PolygonGeometry.fromPositions(options) → PolygonGeometry

A description of a polygon from an array of positions. Polygon geometry can be rendered with both Primitive and GroundPrimitive.

Name Type Description

options

object

下列属性的对象 :

Name	Type	Default	Description
`positions`	Array.<Cartesian3>		定义多边形角点的一系列位置.
`height`	number	`0.0`	optional 多边形的高度.
`extrudedHeight`	number		optional 多边形挤压的高度.
`vertexFormat`	VertexFormat	`VertexFormat.DEFAULT`	optional The vertex attributes to be computed.
`stRotation`	number	`0.0`	optional 纹理坐标的旋转,以弧度表示. 正旋转是逆时针.
`ellipsoid`	Ellipsoid	`Ellipsoid.default`	optional The ellipsoid to be used as a reference.
`granularity`	number	`CesiumMath.RADIANS_PER_DEGREE`	optional The distance, in radians, between each latitude and longitude. Determines the number of positions in the buffer.
`perPositionHeight`	boolean	`false`	optional Use the height of options.positions for each position instead of using options.height to determine the height.
`closeTop`	boolean	`true`	optional When false, leaves off the top of an extruded polygon open.
`closeBottom`	boolean	`true`	optional When false, leaves off the bottom of an extruded polygon open.
`arcType`	ArcType	`ArcType.GEODESIC`	optional The type of line the polygon edges must follow. Valid options are `ArcType.GEODESIC` and `ArcType.RHUMB`.
`textureCoordinates`	PolygonHierarchy		optional Texture coordinates as a `PolygonHierarchy` of `Cartesian2` points. Has no effect for ground primitives.

Returns:

Example:

// create a polygon from points
const polygon = Cesium.PolygonGeometry.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.PolygonGeometry.createGeometry(polygon);

See:

PolygonGeometry#createGeometry

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

将所提供的实例存储到所提供的数组中.

Name	Type	Default	Description
`value`	PolygonGeometry		包装的价值.
`array`	Array.<number>		装入的阵列.
`startingIndex`	number	`0`	optional The index into the array at which to start packing the elements.

Returns:

装入的阵列

static Cesium.PolygonGeometry.unpack(array, startingIndex, result) → PolygonGeometry

从组合的数组中获取实例 .

Name	Type	Default	Description
`array`	Array.<number>		装填的阵列.
`startingIndex`	number	`0`	optional The starting index of the element to be unpacked.
`result`	PolygonGeometry		optional 存储结果的对象.

Returns:

未提供修改的结果参数或新的PolygonGeometry实例.