## 渲染符号详细说明

### 1.渲染符号说明

#### 支持的符号类型

符号名称 | 类名 | Api 文档链接
--- | --- | ---
简单标注符号 | SimpleMarkerSymbol | SimpleMarkerSymbol
图片标注符号 | PictureMarkerSymbol | PictureMarkerSymbol
简单线符号 | SimpleLineSymbol | SimpleLineSymbol
简单填充符号 | SimpleFillSymbol | SimpleFillSymbol
图片填充符号 | PictureFillSymbol | PictureFillSymbol
文本符号 | TextSymbol | TextSymbol
MapGIS 文本符号 | MapGISTextSymbol | MapGISTextSymbol
三维点符号 | PointSymbol3D | PointSymbol3D
三维线符号 | LineSymbol3D | LineSymbol3D
三维体符号 | PolygonSymbol3D | PolygonSymbol3D
注记三维符号 | LabelSymbol3D | LabelSymbol3D

#### 渲染符号对应的 Cesium 对象

符号名称 | 类名 | 对应的 Cesium 对象
--- | --- | ---
简单标注符号 | SimpleMarkerSymbol | Cesium.PointPrimitive()
简单标注符号 | SimpleMarkerSymbol | Cesium.Billboard()
图片标注符号 | PictureMarkerSymbol | Cesium.Billboard()
简单线符号 | SimpleLineSymbol | Cesium.Primitive()
简单线符号 | SimpleLineSymbol | Cesium.GroundPolylinePrimitive()
简单填充符号 | SimpleFillSymbol | Cesium.Primitive()
简单填充符号 | SimpleFillSymbol | Cesium.GroundPrimitive()
图片填充符号 | PictureFillSymbol | Cesium.Primitive()
图片填充符号 | PictureFillSymbol | Cesium.GroundPrimitive()
文本符号 | TextSymbol | Cesium.Billboard()
MapGIS 文本符号 | MapGISTextSymbol | Cesium.Billboard()
三维图标符号图层 | IconSymbol3DLayer | Cesium.Billboard()
三维文字符号图层 | TextSymbol3DLayer | Cesium.Label()
三维对象符号图层 | ObjectSymbol3DLayer | Cesium.Primitive()
三维对象符号图层 | ObjectSymbol3DLayer | Cesium.Model()
三维线符号图层 | LineSymbol3DLayer | Cesium.Primitive()
三维线符号图层 | LineSymbol3DLayer | Cesium.GroundPolylinePrimitive()
三维管道符号图层 | PathSymbol3DLayer | Cesium.Primitive()
三维区符号图层 | FillSymbol3DLayer | Cesium.Primitive()
三维拉伸区符号图层 | ExtrudeSymbol3DLayer | Cesium.Primitive()

### 2.限制

#### zondy.leaflet.MapView 视图上

图元类型 | 支持的符号类型 |
--- | --- | ---
点 | SimpleMarkerSymbol，PictureMarkerSymbol |
线 | SimpleLineSymbol |
区 | SimpleFillSymbol，PictureFillSymbol，TextSymbol，SimpleMarkerSymbol，PictureMarkerSymbol |
注记 | TextSymbol |

#### zondy.mapboxgl.MapView 视图上

图元类型 | 支持的符号类型 |
--- | --- | ---
点 | SimpleMarkerSymbol，PictureMarkerSymbol |
线 | SimpleLineSymbol |
区 | SimpleFillSymbol，PictureFillSymbol，TextSymbol，SimpleMarkerSymbol，PictureMarkerSymbol |
注记 | TextSymbol |

- mapboxgl 引擎限制，目前图片资源仅支持 png, webp, or jpg format 传入
- mapboxgl 引擎限制，几何图元图层使用 PictureFillSymbol 时，无法设置填充图片的（xscale,yscale,width,height）

#### zondy.cesium.SceneView 视图上

图元类型 | 支持的符号类型 |
--- | --- | ---
点 | SimpleMarkerSymbol，PictureMarkerSymbol |
线 | SimpleLineSymbol |
区 | SimpleFillSymbol，PictureFillSymbol，TextSymbol，MapGISTextSymbol，SimpleMarkerSymbol，PictureMarkerSymbol |
注记 | TextSymbol，MapGISTextSymbol |

- 目前绘制文字上下标和分式时，TextSymbol，MapGISTextSymbol 上属性支持有限，会出现部分属性无法生效的问题。

#### 各符号属性在引擎上的限制

- SimpleMarkerSymbol

三级功能项 | 备注 | mapboxgl 插件层 -要素图层 | mapboxgl 插件层-几何图层 | 备注 | cesium 插件层 | 备注 | leaflet 插件层 | 备注 | openlayers 插件层 | 备注
--- | --- | --- | --- | --- | --- | --- | --- | --- | --- | ---
type |  | ✔ | ✔ |  | ✔ |  | ✔ |  | ✕ |
color |  | ✔ | ✔ |  | ✔ |  | ✔ |  | ✕ |
path |  | ✕ | ✕ |  | ✕ |  | ✔ |  | ✕ |
style |  | ✔ | ✕ | 仅支持‘circle 形状’ | ✔ |  | ✔ |  | ✕ |
xoffset |  | ✔ | ✕ | 此属性不支持表达式 | ✔ |  | ✔ |  | ✕ |
yoffset |  | ✔ | ✕ | 此属性不支持表达式 | ✔ |  | ✔ |  | ✕ |
outline |  | ✔ | ✔ | 仅支持边线 color，width | ✔ |  | ✔ |  | ✕ |
angle |  | ✕ | ✕ |  | ✔ |  | ✔ |  | ✕ |
size |  | ✔ | ✔ |  | ✔ |  | ✔ |  | ✕ |

- PictureMarkerSymbol

三级功能项 | 备注 | mapboxgl 插件层 -要素图层 | mapboxgl 插件层-几何图层 | 备注 | cesium 插件层 | 备注 | leaflet 插件层 | 备注 | openlayers 插件层 | 备注
--- | --- | --- | --- | --- | --- | --- | --- | --- | --- | ---
type |  | ✔ | ✔ |  | ✔ |  | ✔ |  | ✕ |
angle |  | ✔ | ✔ |  | ✔ |  | ✔ |  | ✕ |
xoffset |  | ✔ | ✕ |  | ✔ |  | ✔ |  | ✕ |
yoffset |  | ✔ | ✕ |  | ✔ |  | ✔ |  | ✕ |
width |  | ✔ | ✔ |  | ✔ |  | ✔ |  | ✕ |
height |  | ✔ | ✔ |  | ✔ |  | ✔ |  | ✕ |
url |  | ✔ | ✔ |  | ✔ |  | ✔ |  | ✕ |

- SimpleLineSymbol

三级功能项 | 备注 | mapboxgl 插件层 -要素图层 | mapboxgl 插件层-几何图层 | 备注 | cesium 插件层 | 备注 | leaflet 插件层 | 备注 | openlayers 插件层 | 备注
--- | --- | --- | --- | --- | --- | --- | --- | --- | --- | ---
type |  | ✔ | ✔ |  | ✔ |  | ✔ |  | ✕ |
color |  | ✔ | ✔ |  | ✔ |  | ✔ |  | ✕ |
width |  | ✔ | ✔ |  | ✔ |  | ✔ |  | ✕ |
cap |  | ✔ | ✕ | 此属性不支持表达式 | ✕ |  | ✔ |  | ✕ |
join |  | ✔ | ✔ |  | ✕ |  | ✔ |  | ✕ |
marker |  | ✕ | ✕ | 此属性不支持表达式 | ✕ |  | ✔ |  | ✕ |
miterLimit |  | ✔ | ✕ | 此属性不支持表达式 | ✕ |  | ✔ |  | ✕ |
style |  | ✔ | ✕ | 此属性不支持表达式 | ✔ |  | ✔ |  | ✕ |

- SimpleFillSymbol

三级功能项 | 备注 | mapboxgl 插件层 -要素图层 | mapboxgl 插件层-几何图层 | 备注 | cesium 插件层 | 备注 | leaflet 插件层 | 备注 | openlayers 插件层 | 备注
--- | --- | --- | --- | --- | --- | --- | --- | --- | --- | ---
type |  | ✔ | ✔ |  | ✔ |  | ✔ |  | ✕ |
color |  | ✔ | ✔ |  | ✔ |  | ✔ |  | ✕ |
outline |  | ✔ | ✔ | 仅支持边线 color，width | ✔ |  | ✔ |  | ✕ |
style |  | ✕ | ✕ | 暂时不支持，后续动态生成纹理扩充 | ✔ |  | ✔ |  | ✕ |

- PictureFillSymbol

三级功能项 | 备注 | mapboxgl 插件层 -要素图层 | mapboxgl 插件层-几何图层 | 备注 | cesium 插件层 | 备注 | leaflet 插件层 | 备注 | openlayers 插件层 | 备注
--- | --- | --- | --- | --- | --- | --- | --- | --- | --- | ---
type |  | ✕ | ✕ |  | ✔ |  | ✔ |  | ✕ |
color |  | ✕ | ✕ |  | ✔ |  | ✔ |  | ✕ |
outline |  | ✕ | ✕ |  | ✔ |  | ✔ |  | ✕ |
url |  | ✕ | ✕ |  | ✔ |  | ✔ |  | ✕ |
width |  | ✕ | ✕ |  | ✕ | cesium 里面加载图片没有高宽的概念、无法预加载处理图片 | ✔ |  | ✕ |
xoffset |  | ✕ | ✕ |  | ✕ | 无相关接口可用 | ✔ |  | ✕ |
yoffset |  | ✕ | ✕ |  | ✕ | 无相关接口可用 | ✔ |  | ✕ |
xscale |  | ✕ | ✕ |  | ✔ |  | ✔ |  | ✕ |
yscale |  | ✕ | ✕ |  | ✔ |  | ✔ |  | ✕ |
height |  | ✕ | ✕ |  | ✕ | cesium 里面加载图片没有高宽的概念、无法预加载处理图片 | ✔ |  | ✕ |

- TextSymbol

三级功能项 | 备注 | mapboxgl 插件层 -要素图层 | mapboxgl 插件层-几何图层 | 备注 | cesium 插件层 | 备注 | leaflet 插件层 | 备注 | openlayers 插件层 | 备注
--- | --- | --- | --- | --- | --- | --- | --- | --- | --- | ---
text |  | ✔ | ✔ |  | ✔ |  | ✔ |  | ✕ |
color |  | ✔ | ✔ |  | ✔ |  | ✔ |  | ✕ |
xoffset |  | ✔ | ✕ |  | ✔ |  | ✔ |  | ✕ |
yoffset |  | ✔ | ✕ |  | ✔ |  | ✔ |  | ✕ |
horizontalAlignment |  | ✔ | ✕ |  | ✔ |  | ✔ |  | ✕ |
font |  | ✕ | ✕ | 不支持文字设置字体 | ✔ |  | ✔ |  | ✕ |
haloColor |  | ✔ | ✔ |  | ✔ |  | ✔ |  | ✕ |
haloSize |  | ✔ | ✔ |  | ✔ |  | ✔ |  | ✕ |
kerning |  | ✔ | ✔ |  | ✕ | 三维底层 api 限制，不支持 | ✔ |  | ✕ |
lineHeight |  | ✔ | ✕ |  | ✔ |  | ✔ |  | ✕ |
lineWidth |  | ✔ | ✕ |  | ✔ |  | ✔ |  | ✕ |
rotated |  | ✔ | ✔ |  | ✔ |  | ✔ |  | ✕ |
type |  | ✔ | ✕ |  | ✔ |  | ✔ |  | ✕ |
verticalAlignment |  | ✔ | ✕ |  | ✔ |  | ✔ |  | ✕ |
angle |  | ✔ | ✔ |  | ✔ |  | ✔ |  | ✕ |
backgroundColor |  | ✕ | ✕ |  | ✔ |  | ✔ |  | ✕ |
borderLineColor |  | ✕ | ✕ |  | ✕ | 三维底层 api 限制，不支持 | ✔ |  | ✕ |
borderLineSize |  | ✕ | ✕ |  | ✕ | 三维底层 api 限制，不支持 | ✔ |  | ✕ |

- MapGISTextSymbol

三级功能项 | 备注 | mapboxgl 插件层 -要素图层 | mapboxgl 插件层-几何图层 | 备注 | cesium 插件层 | 备注 | leaflet 插件层 | 备注 | openlayers 插件层 | 备注
--- | --- | --- | --- | --- | --- | --- | --- | --- | --- | ---
backgroundPadding |  | ✕ | ✕ |  | ✔ |  | ✕ |  | ✕ |
backgroundImage | 测试接口，后面可能会调整 | ✕ | ✕ |  | ✔ |  | ✕ |  | ✕ |
textDecorationUnderlineColor |  | ✕ | ✕ |  | ✔ |  | ✕ |  | ✕ |
textDecorationUnderlineWidth |  | ✕ | ✕ |  | ✔ |  | ✕ |  | ✕ |
textDecorationThroughlineColor |  | ✕ | ✕ |  | ✔ |  | ✕ |  | ✕ |
textDecorationThroughlineWidth |  | ✕ | ✕ |  | ✔ |  | ✕ |  | ✕ |
textShadowOffsetX |  | ✕ | ✕ |  | ✔ |  | ✕ |  | ✕ |
textShadowOffsetY |  | ✕ | ✕ |  | ✔ |  | ✕ |  | ✕ |
textShadowBlur |  | ✕ | ✕ |  | ✔ |  | ✕ |  | ✕ |
textShadowColor |  | ✕ | ✕ |  | ✔ |  | ✕ |  | ✕ |
letterSpacing |  | ✕ | ✕ |  | ✔ |  | ✕ |  | ✕ |
lineMaxNum |  | ✕ | ✕ |  | ✔ |  | ✕ |  | ✕ |
textWraps |  | ✕ | ✕ |  | ✔ |  | ✕ |  | ✕ |
textExtraIcon | 测试接口，后面可能会调整 | ✕ | ✕ |  | ✔ |  | ✕ |  | ✕ |
textExtraIconAnchor | 测试接口，后面可能会调整 | ✕ | ✕ |  | ✔ |  | ✕ |  | ✕ |
textExtraIconSize | 测试接口，后面可能会调整 | ✕ | ✕ |  | ✔ |  | ✕ |  | ✕ |

三维符号图层

- IconSymbol3DLayer

三级功能项 | 备注 | mapboxgl 插件层 -要素图层 | mapboxgl 插件层-几何图层 | 备注 | cesium 插件层 | 备注 | leaflet 插件层 | 备注 | openlayers 插件层 | 备注
--- | --- | --- | --- | --- | --- | --- | --- | --- | --- | ---
resource |  | ✕ | ✕ |  | ✔ |  | ✕ |  | ✕ |
size |  | ✕ | ✕ |  | ✔ |  | ✕ |  | ✕ |
material |  | ✕ | ✕ |  | ✔ |  | ✕ |  | ✕ |
outline |  | ✕ | ✕ |  | ✔ |  | ✕ |  | ✕ |
anchor |  | ✕ | ✕ |  | ✔ |  | ✕ |  | ✕ |
anchorPosition |  | ✕ | ✕ |  | ✔ |  | ✕ |  | ✕ |
anchor |  | ✕ | ✕ |  | ✕ |  | ✕ |  | ✕ |

- ObjectSymbol3DLayer

三级功能项 | 备注 | mapboxgl 插件层 -要素图层 | mapboxgl 插件层-几何图层 | 备注 | cesium 插件层 | 备注 | leaflet 插件层 | 备注 | openlayers 插件层 | 备注
--- | --- | --- | --- | --- | --- | --- | --- | --- | --- | ---
anchor |  | ✕ | ✕ |  | ✕ |  | ✕ |  | ✕ |
anchorPosition |  | ✕ | ✕ |  | ✕ |  | ✕ |  | ✕ |
castShadows |  | ✕ | ✕ |  | ✔ |  | ✕ |  | ✕ |
heading |  | ✕ | ✕ |  | ✕ |  | ✕ |  | ✕ |
roll |  | ✕ | ✕ |  | ✕ |  | ✕ |  | ✕ |
tilt |  | ✕ | ✕ |  | ✕ |  | ✕ |  | ✕ |
height |  | ✕ | ✕ |  | ✔ |  | ✕ |  | ✕ |
width |  | ✕ | ✕ |  | ✔ |  | ✕ |  | ✕ |
depth |  | ✕ | ✕ |  | ✔ |  | ✕ |  | ✕ |
material |  | ✕ | ✕ |  | ✔ |  | ✕ |  | ✕ |
resource |  | ✕ | ✕ |  | ✔ |  | ✕ |  | ✕ |

- LineSymbol3DLayer

三级功能项 | 备注 | mapboxgl 插件层 -要素图层 | mapboxgl 插件层-几何图层 | 备注 | cesium 插件层 | 备注 | leaflet 插件层 | 备注 | openlayers 插件层 | 备注
--- | --- | --- | --- | --- | --- | --- | --- | --- | --- | ---
size |  | ✕ | ✕ |  | ✔ |  | ✕ |  | ✕ |
material |  | ✕ | ✕ |  | ✔ |  | ✕ |  | ✕ |
pattern |  | ✕ | ✕ |  | ✔ |  | ✕ |  | ✕ |
cap |  | ✕ | ✕ |  | ✕ |  | ✕ |  | ✕ |
join |  | ✕ | ✕ |  | ✕ |  | ✕ |  | ✕ |
marker |  | ✕ | ✕ |  | ✕ |  | ✕ |  | ✕ |

- PathSymbol3DLayer

三级功能项 | 备注 | mapboxgl 插件层 -要素图层 | mapboxgl 插件层-几何图层 | 备注 | cesium 插件层 | 备注 | leaflet 插件层 | 备注 | openlayers 插件层 | 备注
--- | --- | --- | --- | --- | --- | --- | --- | --- | --- | ---
anchor |  | ✕ | ✕ |  | ✕ |  | ✕ |  | ✕ |
anchorPosition |  | ✕ | ✕ |  | ✕ |  | ✕ |  | ✕ |
castShadows |  | ✕ | ✕ |  | ✔ |  | ✕ |  | ✕ |
heading |  | ✕ | ✕ |  | ✕ |  | ✕ |  | ✕ |
roll |  | ✕ | ✕ |  | ✕ |  | ✕ |  | ✕ |
tilt |  | ✕ | ✕ |  | ✕ |  | ✕ |  | ✕ |
height |  | ✕ | ✕ |  | ✔ |  | ✕ |  | ✕ |
width |  | ✕ | ✕ |  | ✔ |  | ✕ |  | ✕ |
depth |  | ✕ | ✕ |  | ✔ |  | ✕ |  | ✕ |
material |  | ✕ | ✕ |  | ✔ |  | ✕ |  | ✕ |
resource |  | ✕ | ✕ |  | ✔ |  | ✕ |  | ✕ |

- FillSymbol3DLayer

三级功能项 | 备注 | mapboxgl 插件层 -要素图层 | mapboxgl 插件层-几何图层 | 备注 | cesium 插件层 | 备注 | leaflet 插件层 | 备注 | openlayers 插件层 | 备注
--- | --- | --- | --- | --- | --- | --- | --- | --- | --- | ---
material |  | ✕ | ✕ |  | ✔ |  | ✕ |  | ✕ |
castShadows |  | ✕ | ✕ |  | ✔ |  | ✕ |  | ✕ |
outline |  | ✕ | ✕ |  | ✕ |  | ✕ |  | ✕ |
pattern |  | ✕ | ✕ |  | ✕ |  | ✕ |  | ✕ |

- WaterSymbol3DLayer

三级功能项 | 备注 | mapboxgl 插件层 -要素图层 | mapboxgl 插件层-几何图层 | 备注 | cesium 插件层 | 备注 | leaflet 插件层 | 备注 | openlayers 插件层 | 备注
--- | --- | --- | --- | --- | --- | --- | --- | --- | --- | ---
|  | ✕ | ✕ |  | ✕ |  | ✕ |  | ✕ |

- ExtrudeSymbol3DLayer

三级功能项 | 备注 | mapboxgl 插件层 -要素图层 | mapboxgl 插件层-几何图层 | 备注 | cesium 插件层 | 备注 | leaflet 插件层 | 备注 | openlayers 插件层 | 备注
--- | --- | --- | --- | --- | --- | --- | --- | --- | --- | ---
material |  | ✕ | ✕ |  | ✔ |  | ✕ |  | ✕ |
size |  | ✕ | ✕ |  | ✔ |  | ✕ |  | ✕ |
castShadows |  | ✕ | ✕ |  | ✔ |  | ✕ |  | ✕ |
edges |  | ✕ | ✕ |  | ✕ |  | ✕ |  | ✕ |

- TextSymbol3DLayer

三级功能项 | 备注 | mapboxgl 插件层 -要素图层 | mapboxgl 插件层-几何图层 | 备注 | cesium 插件层 | 备注 | leaflet 插件层 | 备注 | openlayers 插件层 | 备注
--- | --- | --- | --- | --- | --- | --- | --- | --- | --- | ---
text |  | ✕ | ✕ |  | ✔ |  | ✕ |  | ✕ |
font |  | ✕ | ✕ |  | ✔ |  | ✕ |  | ✕ |
size |  | ✕ | ✕ |  | ✔ |  | ✕ |  | ✕ |
material |  | ✕ | ✕ |  | ✔ |  | ✕ |  | ✕ |
background |  | ✕ | ✕ |  | ✔ |  | ✕ |  | ✕ |
halo |  | ✕ | ✕ |  | ✕ |  | ✕ |  | ✕ |
horizontalAlignment |  | ✕ | ✕ |  | ✔ |  | ✕ |  | ✕ |
verticalAlignment |  | ✕ | ✕ |  | ✔ |  | ✕ |  | ✕ |
lineHeight |  | ✕ | ✕ |  | ✕ |  | ✕ |  | ✕ |