English中文

PolygonGeometry

new Cesium.PolygonGeometry(options)
engine/Source/Core/PolygonGeometry.js 668

椭球面上多边形的描述。多边形由多边形层次结构定义。多边形几何体可以用两者渲染 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 具有以下属性的对象： Object with the following properties:
名称 Name 类型 Type 默认值 Default 说明 Description
polygonHierarchy PolygonHierarchy 可以包含孔的多边形层次结构。 A polygon hierarchy that can include holes.
height number 0.0 可选 optional 多边形和椭球面之间的距离（以米为单位）。 The distance in meters between the polygon and the ellipsoid surface.
extrudedHeight number 可选 optional 多边形的拉伸面和椭球面之间的距离（以米为单位）。 The distance in meters between the polygon's extruded face and the ellipsoid surface.
vertexFormat VertexFormat VertexFormat.DEFAULT 可选 optional 要计算的顶点属性。 The vertex attributes to be computed.
stRotation number 0.0 可选 optional 纹理坐标的旋转（以弧度为单位）。正旋转是逆时针方向。 The rotation of the texture coordinates, in radians. A positive rotation is counter-clockwise.
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 使用每个位置的 options.positions 的高度，而不是使用 options.height 来确定高度。 Use the height of options.positions for each position instead of using options.height to determine the height.
closeTop boolean true 可选 optional 当为 false 时，使挤出多边形的顶部保持打开状态。 When false, leaves off the top of an extruded polygon open.
closeBottom boolean true 可选 optional 当为 false 时，使挤出多边形的底部保持打开状态。 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:
另见： See:
  • PolygonGeometry#createGeometry
  • PolygonGeometry#fromPositions

成员 Members

packedLength : number
engine/Source/Core/PolygonGeometry.js 734

用于将对象打包到数组中的元素数量。 The number of elements used to pack the object into an array.

方法 Methods

static Cesium.PolygonGeometry.computeRectangleFromPositions(positions, ellipsoid, arcType, result) → Rectangle
engine/Source/Core/PolygonGeometry.js 1047

计算一个矩形，该矩形包围由位置列表定义的多边形，包括国际日期变更线和极点上的情况。 Computes a rectangle which encloses the polygon defined by the list of positions, including cases over the international date line and the poles.
名称 Name 类型 Type 默认值 Default 说明 Description
positions Array.<Cartesian3> 定义多边形外边界的线性环。 A linear ring defining the outer boundary of the polygon.
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 用于存储结果的对象。 An object in which to store the result.
返回： Returns:
结果矩形 The result rectangle

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

计算多边形的几何表示，包括其顶点、索引和边界球体。 Computes the geometric representation of a polygon, including its vertices, indices, and a bounding sphere.
名称 Name 类型 Type 说明 Description
polygonGeometry PolygonGeometry 多边形的描述。 A description of the polygon.
返回： Returns:
计算的顶点和索引。 The computed vertices and indices.

static Cesium.PolygonGeometry.fromPositions(options) → PolygonGeometry
engine/Source/Core/PolygonGeometry.js 783

根据位置数组对多边形的描述。多边形几何体可以用两者渲染 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 具有以下属性的对象： Object with the following properties:
名称 Name 类型 Type 默认值 Default 说明 Description
positions Array.<Cartesian3> 定义多边形角点的位置数组。 An array of positions that defined the corner points of the polygon.
height number 0.0 可选 optional 多边形的高度。 The height of the polygon.
extrudedHeight number 可选 optional 多边形挤出的高度。 The height of the polygon extrusion.
vertexFormat VertexFormat VertexFormat.DEFAULT 可选 optional 要计算的顶点属性。 The vertex attributes to be computed.
stRotation number 0.0 可选 optional 纹理坐标的旋转（以弧度为单位）。正旋转是逆时针方向。 The rotation of the texture coordinates, in radians. A positive rotation is counter-clockwise.
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 使用每个位置的 options.positions 的高度，而不是使用 options.height 来确定高度。 Use the height of options.positions for each position instead of using options.height to determine the height.
closeTop boolean true 可选 optional 当为 false 时，使挤出多边形的顶部保持打开状态。 When false, leaves off the top of an extruded polygon open.
closeBottom boolean true 可选 optional 当为 false 时，使挤出多边形的底部保持打开状态。 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>
engine/Source/Core/PolygonGeometry.js 819

将提供的实例存储到提供的数组中。 Stores the provided instance into the provided array.
名称 Name 类型 Type 默认值 Default 说明 Description
value PolygonGeometry 包装的价值。 The value to pack.
array Array.<number> 要打包到的数组。 The array to pack into.
startingIndex number 0 可选 optional 开始打包元素的数组索引。 The index into the array at which to start packing the elements.
返回： Returns:
被打包成的数组 The array that was packed into

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

从打包数组中检索实例。 Retrieves an instance from a packed array.
名称 Name 类型 Type 默认值 Default 说明 Description
array Array.<number> 打包的数组。 The packed array.
startingIndex number 0 可选 optional 要解包的元素的起始索引。 The starting index of the element to be unpacked.
result PolygonGeometry 可选 optional 用于存储结果的对象。 The object into which to store the result.
返回： Returns:
修改后的结果参数或新的 PolygonGeometry 实例（如果未提供）。 The modified result parameter or a new PolygonGeometry instance if one was not provided.
需要帮助吗？获得答案的最快方法是从社区和团队那里获得答案 Need help? The fastest way to get answers is from the community and team on the Cesium Forum.
CtrlK
packages/engine
packages/widgets