Symbol是所有符号的基类。符号将点、线、面和网格几何表示为 View的矢量图形。符号只能直接在 graphics 上直接设置在 GraphicsLayer 或 View.graphics 中。 否则，它们将分配给应用于 Layer 的 Renderer 。
有许多符号可用于描绘要素。选择符号类型取决于以下因素：
- 将在其中渲染符号的 View 类型 - MapView（用于 2D）或 SceneView（用于 3D）
- 特征的 geometry type
- 可视化的目的和上下文
下表表示了应根据视图类型使用哪些符号子类。
| View type | Symbol subclasses |
|---|---|
| MapView (2D) | FillSymbol, LineSymbol, MarkerSymbol, TextSymbol, WebStyleSymbol, CIMSymbol |
| SceneView (3D) | Symbol3D, WebStyleSymbol, CIMSymbol |
如果在 MapView 中使用数据，请使用下表作为选择符号类型的指南。
| Geometry type | Valid symbol types |
|---|---|
| Point | SimpleMarkerSymbol, PictureMarkerSymbol, TextSymbol, WebStyleSymbol, CIMSymbol |
| Polyline | SimpleLineSymbol, TextSymbol, CIMSymbol |
| Polygon | SimpleFillSymbol, PictureFillSymbol, SimpleMarkerSymbol, TextSymbol, CIMSymbol |
如果在 SceneView 中使用数据，请在选择符号类型时使用下表作为指南。
| Geometry type | Valid symbol types |
|---|---|
| Point | PointSymbol3D, LabelSymbol3D, WebStyleSymbol, CIMSymbol |
| Polyline | LineSymbol3D, LabelSymbol3D |
| Polygon | PolygonSymbol3D, LabelSymbol3D |
| Mesh | MeshSymbol3D, LabelSymbol3D |
虽然上表中未明确指出，但 3D SceneViews 支持 2D 符号，而 2D MapViews 不支持 3D 符号。但是，在 SceneView 中工作时，建议首选 3D 符号类型而不是 2D 符号类型。
属性列表
| 属性 | 类型 | 描述 | 类 | |
|---|---|---|---|---|
| Color | 更多信息 符号的颜色。 | 更多信息 | Symbol | |
| String | 更多信息 类名。 | 更多信息 | Accessor | |
| String | 更多信息 符号类型。 | 更多信息 | Symbol |
属性详细说明
-
符号的颜色。 这可以使用 rgb(a) 值数组、命名字符串、十六进制字符串或 hsl(a) 字符串进行自动转换， 具有
r、g、b和a属性或 颜色对象。- 默认值:black
示例代码:// CSS color string symbol.color = "dodgerblue";// HEX string symbol.color = "#33cc33";// array of RGBA values symbol.color = [51, 204, 51, 0.3];// object with rgba properties symbol.color = { r: 51, g: 51, b: 204, a: 0.7 };
-
起始版本: GeoScene API for JavaScript 4.22
-
类名。类的名称声明格式为
geoscene.folder.className。
-
type Stringreadonly
-
符号类型。
可选值:"simple-marker"|"picture-marker"|"simple-line"|"simple-fill"|"picture-fill"|"text"|"shield-label-symbol"|"point-3d"|"line-3d"|"polygon-3d"|"web-style"|"mesh-3d"|"label-3d"|"cim"
方法列表
| 属性 | 返回值类型 | 描述 | 类 | |
|---|---|---|---|---|
| * | 更多信息 创建此类的新实例并使用从 GeoScene产品生成的 JSON 对象的值对其进行初始化。 | 更多信息 | Symbol | |
| Object | 更多信息 将此类的实例转换为其 GeoScene portal JSON 格式。 | 更多信息 | Symbol |
方法详细说明
-
fromJSON(json){*}static
-
创建此类的新实例，并使用从 GeoScene 产品生成的 JSON 对象的值对其进行初始化。传递给输入
json参数的对象通常来自对 REST API 中的查询操作的响应，或者来自另一个 GeoScene产品的 toJSON() 方法。有关何时以及如何使用此函数的详细信息和示例，请参阅指南中的 使用 fromJSON() 主题。参数:json Object实例的 json 表达式，以geoscene 格式显示。
返回值:类型 描述 * 返回一个该类的新实例。
-
toJSON(){Object}
-
将此类的实例转换为 GeoScene portal JSON 格式。 有关更多信息，请参阅 使用 fromJSON() 指南。
返回值:类型 描述 Object 此类实例的 GeoScene portal JSON 格式。