cesium中Entity的PolygonGraphics添加多边形

1 前言

利用PolygonGraphics能够在cesium中添加多边形。

cesium探索系列目录：传送门

2 PolygonGraphics类说明

2.1 创建polygon的options

Cesium.PolygonGraphics.ConstructorOptions

名称	默认值	描述
show	true	指定多边形是否可见
hierarchy		指定多边形的层次特性
height	0	指定多边形相对于椭球曲面的高度
heightReference	HeightReference.NONE	指定高度的相对值
extrudedHeight		拉伸高度
extrudedHeightReference	HeightReference.NONE	指定拉伸高度的相对属性
stRotation	0	指定多边形纹理从北向逆时针旋转值
granularity		指定多边形上点之间的角度距离
fill	true	布尔属性，指定多边形是否使用提供的材质填充
material	Color.WHITE	用于填充多边形的材质的特性
outline	false	布尔属性，是否对多边形进行轮廓绘制
outlineColor	Color.BLACK	指定轮廓颜色的属性
outlineWidth	1.0	指定轮廓宽度的数字属性
perPositionHeight	false	指定是否使用每个位置的高度
closeTop	true	如果为false，则使挤出多边形的顶部保持打开状态
closeBottom	true	如果为false，则使挤出多边形的底部保持打开状态
shadows	ShadowMode.DISABLED	枚举属性，指定多边形是投射阴影还是从光源接收阴影。
arcType	ArcType.GEODESIC	多边形必须遵循的直线类型
distanceDisplayCondition		指定此多边形将显示在距摄影机的距离处
classificationType	ClassificationType.BOTH	枚举属性，指定此多边形在地面上时是对地形、三维瓷砖进行分类，还是对两者进行分类。
zIndex	0	指定用于对地面几何图形进行排序的zIndex的特性。只有当多边形为常量且未指定高度或拉伸高度时才有效果
textureCoordinates		将纹理坐标指定为笛卡尔2点的多边形层次的特性。对地面基本体没有影响。

AccType：
ArcType定义连接顶点时应采用的路径。

值	含义
NONE	不符合椭球面的直线
GEODESIC	遵循测地线路径。
RHUMB	编号遵循RHUMB或loxodrome路径。

2.2 常用方法

clone(result)

复制该PolygonGraphics实例，输入一个PolygonGraphics，返回一个相同的PolygonGraphics。

merge(source)

将此对象上每个未分配的属性分配给提供的源对象上相同属性的值。

3 Polygon的创建与使用

3.1 创建代码

// 创建polygon并加入场景
const polygon = new Cesium.Entity({
  polygon: {
    hierarchy: Cesium.Cartesian3.fromDegreesArray([
      115.3, 39.9, 115.3, 35.0, 112.0, 35.0, 112.0, 39.9, 114.3, 39.9,
    ]),
    material: Cesium.Color.RED.withAlpha(0.4),
    outline: true,
    outlineColor: Cesium.Color.BLUE,
  },
});

viewer.entities.add(polygon)

3.2 运行效果

相比平面 plane ，多边形紧贴地面，会随着地球曲率的变化而变化。>

修改坐标组为[20.3, 39.9, 20.3, 35.0, 112.0, 35.0, 112.0, 39.9, 114.3, 39.9]，可以看到，生成的多边形结紧贴地面，会在三维的球上做相应的曲率变化。