PlaneGeometry

PlaneGeometry（平面几何）创建一个二维平面，由一个矩形，X和Y方向的分段数和顶点高度数据组成。

语法

new Cesium.PlaneGeometry(options);

options 对象包含以下属性：

• minimumX：可选的数字， 默认值为0.0。
• maximumX：可选的数字， 默认值为1.0。
• minimumY：可选的数字， 默认值为0.0。
• maximumY：可选的数字， 默认值为1.0。
• vertexFormat：可选的VertexFormat（顶点格式）对象， 默认值为VertexFormat.DEFAULT。
• heightmap：可选的HeightmapTerrainData（高度地图地形数据）对象。
• heightmapWidth：可选的数字， 默认值为128。
• heightmapHeight：可选的数字， 默认值为128。
• extent：可选的Rectangle（矩形）对象， 默认值为Rectangle.MAX_VALUE。
• width：可选的数字， 默认值为1.0。
• height：可选的数字， 默认值为1.0。
• rowSegments：可选的数字， 默认值为1。
• columnSegments：可选的数字， 默认值为1。
• vertexStride：可选的数字， 默认值为undefined。

示例

var plane = new Cesium.PlaneGeometry({
  heightmapWidth : 5,
  heightmapHeight : 5,
  vertexFormat : Cesium.VertexFormat.POSITION_AND_NORMAL,
  width : 4.0,
  height : 4.0,
  rowSegments : 2,
  columnSegments : 2
});

这将创建一个2x2的顶点网格，其中每个顶点包含其位置和法向量。每个矩形被细分为2x2网格，其中每个网格包含一个顶点。X和Y方向上的坐标范围是[0.0, 4.0]，由于缺乏高度数据，该平面在Z轴上是平坦的。

属性

• attributes：GeometryAttributes 对象。
• boundingSphere：BoundingSphere 对象，表示几何体的外边界球。
• indices：Uint16Array（顶点索引数组）类型的数组，表示模型的索引集合。

方法

• fromDimensions(options)：使用指定的宽度和高度创建一个平面几何体。
  • options 对象包含以下属性：
    • vertexFormat：可选的VertexFormat（顶点格式）对象， 默认值为VertexFormat.DEFAULT。
    • width：可选的数字， 默认值为1.0。
    • height：可选的数字， 默认值为1.0。
    • rowSegments：可选的数字， 默认值为1。
    • columnSegments：可选的数字， 默认值为1。
• createGeometry(planeGeometry)：从现有的平面几何体中创建一个新的Geometry（几何体）对象。
  • planeGeometry：现有的平面几何体。

示例

var plane = Cesium.PlaneGeometry.fromDimensions({
  width: 10.0,
  height: 10.0,
  vertexFormat: Cesium.VertexFormat.POSITION_AND_NORMAL,
  rowSegments: 5,
  columnSegments: 5
});

var planeGeometry = Cesium.PlaneGeometry.createGeometry(plane);

这将创建一个2x2的顶点网格，其中每个顶点包含其位置和法向量。每个矩形被细分为5x5网格，其中每个网格包含一个顶点。X和Y方向上的坐标范围是[0.0, 10.0]，由于缺乏高度数据，该平面在Z轴上是平坦的，并返回一个几何体对象。

参考

• Cesium.PlaneGeometry