PolygonOutlineGeometry
查阅Mars3D API

new Cesium.PolygonOutlineGeometry(options)
engine/Source/Core/PolygonOutlineGeometry.js 349

A description of the outline of a polygon on the ellipsoid. The polygon is defined by a polygon hierarchy.
参数名称 类型 描述信息
options object Object with the following properties:
参数名称 类型 默认值 描述信息
polygonHierarchy PolygonHierarchy A polygon hierarchy that can include holes.
height number 0.0 可选 The distance in meters between the polygon and the ellipsoid surface.
extrudedHeight number 可选 The distance in meters between the polygon's extruded face and the ellipsoid surface.
vertexFormat VertexFormat VertexFormat.DEFAULT 可选 The vertex attributes to be computed.
ellipsoid Ellipsoid Ellipsoid.default 可选 The ellipsoid to be used as a reference.
granularity number CesiumMath.RADIANS_PER_DEGREE 可选 The distance, in radians, between each latitude and longitude. Determines the number of positions in the buffer.
perPositionHeight boolean false 可选 Use the height of options.positions for each position instead of using options.height to determine the height.
arcType ArcType ArcType.GEODESIC 可选 The type of path the outline must follow. Valid options are ArcType.GEODESIC and ArcType.RHUMB.
使用示例:
// 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);
参考:
  • PolygonOutlineGeometry#createGeometry
  • PolygonOutlineGeometry#fromPositions

成员(属性)

packedLength : number
engine/Source/Core/PolygonOutlineGeometry.js 405

The number of elements used to pack the object into an array.

方法

static Cesium.PolygonOutlineGeometry.createGeometry(polygonGeometry) → Geometry|undefined
engine/Source/Core/PolygonOutlineGeometry.js 569

Computes the geometric representation of a polygon outline, including its vertices, indices, and a bounding sphere.
参数名称 类型 描述信息
polygonGeometry PolygonOutlineGeometry A description of the polygon outline.
返回值:
The computed vertices and indices.

static Cesium.PolygonOutlineGeometry.fromPositions(options) → PolygonOutlineGeometry
engine/Source/Core/PolygonOutlineGeometry.js 541

A description of a polygon outline from an array of positions.
参数名称 类型 描述信息
options object Object with the following properties:
参数名称 类型 默认值 描述信息
positions Array.<Cartesian3> An array of positions that defined the corner points of the polygon.
height number 0.0 可选 The height of the polygon.
extrudedHeight number 可选 The height of the polygon extrusion.
ellipsoid Ellipsoid Ellipsoid.default 可选 The ellipsoid to be used as a reference.
granularity number CesiumMath.RADIANS_PER_DEGREE 可选 The distance, in radians, between each latitude and longitude. Determines the number of positions in the buffer.
perPositionHeight boolean false 可选 Use the height of options.positions for each position instead of using options.height to determine the height.
arcType ArcType ArcType.GEODESIC 可选 The type of path the outline must follow. Valid options are LinkType.GEODESIC and ArcType.RHUMB.
返回值:
使用示例:
// 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);
参考:
  • PolygonOutlineGeometry#createGeometry

static Cesium.PolygonOutlineGeometry.pack(value, array, startingIndex) → Array.<number>
engine/Source/Core/PolygonOutlineGeometry.js 423

Stores the provided instance into the provided array.
参数名称 类型 默认值 描述信息
value PolygonOutlineGeometry The value to pack.
array Array.<number> The array to pack into.
startingIndex number 0 可选 The index into the array at which to start packing the elements.
返回值:
The array that was packed into

static Cesium.PolygonOutlineGeometry.unpack(array, startingIndex, result) → PolygonOutlineGeometry
engine/Source/Core/PolygonOutlineGeometry.js 466

Retrieves an instance from a packed array.
参数名称 类型 默认值 描述信息
array Array.<number> The packed array.
startingIndex number 0 可选 The starting index of the element to be unpacked.
result PolygonOutlineGeometry 可选 The object into which to store the result.
返回值:
The modified result parameter or a new PolygonOutlineGeometry instance if one was not provided.
packages/engine
packages/widgets