Symbol3DLayer

符号图层用于定义使用 3D 符号渲染的 Point、Polyline、Polygon 和网格几何的可视化。3D 符号只能用于渲染 FeatureLayer、SceneLayer 或 3D SceneView 中的独立图形中的要素。2D MapViews 不支持 3D 符号。

所有 3D 符号都有一个 symbolLayers 属性，该属性是 Symbol3DLayer 对象的数组。所有符号必须至少具有一个添加到 symbolLayers 属性的符号图层。将 symbol 对象视为一个容器，其中包含多个符号图层，这些图层可定义符号的外观。一个图层可以是轮廓，另一图层可能是填充内容，等等。符号图层与符号之间的关系类似于业务图层与地图的关系。

每个符号图层类型只能应用于某些 Symbol3D 和 Geometry 类型。请参阅下表，了解有关何时使用每种符号图层类型的详细信息。

Symbol3DLayer 类型	Symbol3D 类型	Flat/Volumetric	大小单位	示例
IconSymbol3DLayer	PointSymbol3D、PolygonSymbol3D	flat	points
ObjectSymbol3DLayer	PointSymbol3D、PolygonSymbol3D	volumetric	meters
LineSymbol3DLayer	LineSymbol3D、PolygonSymbol3D	flat	points
PathSymbol3DLayer	LineSymbol3D	volumetric	meters
FillSymbol3DLayer	PolygonSymbol3D、MeshSymbol3D	flat	-
WaterSymbol3DLayer	PolygonSymbol3D	flat	-
ExtrudeSymbol3DLayer	PolygonSymbol3D	volumetric	meters
TextSymbol3DLayer	PointSymbol3D、PolygonSymbol3D、LabelSymbol3D	flat	points

平面符号图层的大小通常以磅或像素（屏幕空间）定义，而体积符号图层的大小则以米（实际空间）定义。

另请参阅

• 符号设计器

• Symbol3D
• 渲染器
• Graphic

• GeoScene 博客 - 使用图标、线和填充符号

• GeoScene 博客 - 使用对象、路径和拉伸

• GeoScene 博客 - 使用属性来表示真实世界的要素大小

属性概述

属性详细信息

declaredClass Stringreadonly inherited

起始版本：GeoScene Maps SDK for JavaScript 4.7

类的名称。声明的类名称格式化为 geoscene.folder.className。

type Stringreadonly

3D 符号图层类型。有关可能值列表，请参见下表。

值	描述
icon
object
line
path
fill
water
extrude
text

可能值："icon"|"object"|"line"|"path"|"fill"|"water"|"extrude"|"text"

方法概述

方法详细说明

addHandles(handleOrHandles, groupKey)inherited

起始版本：GeoScene Maps SDK for JavaScript 4.25

添加一个或多个与对象的生命周期相关联的句柄。当对象被销毁时，将移除句柄。

// Manually manage handles
const handle = reactiveUtils.when(
  () => !view.updating,
  () => {
    wkidSelect.disabled = false;
  },
  { once: true }
);

// Handle gets removed when the object is destroyed.
this.addHandles(handle);

参数

handleOrHandles WatchHandle|WatchHandle[] 对象销毁后，标记为要移除的句柄。

groupKey * optional 标识句柄应添加到的组的键。组中的所有句柄稍后都可使用 Accessor.removeHandles() 进行删除。如果未提供键，则句柄将被添加到默认组。

fromJSON(json){*}static

创建此类的新实例并使用从 GeoScene 产品生成的 JSON 对象值对其进行初始化。传入到输入 json 参数的对象通常来自对 REST API 中查询操作的响应或来自另一个 GeoScene 产品的 toJSON() 方法。有关何时以及如何使用该函数的详细信息和示例，请参阅指南中的使用 fromJSON() 主题。

参数

json Object GeoScene 格式实例的 JSON 表示。有关各种输入 JSON 对象的结构示例，请参阅 GeoScene REST API 文档。

返回

类型	描述
*	返回该类的新实例。

hasHandles(groupKey){Boolean}inherited

起始版本：GeoScene Maps SDK for JavaScript 4.25

如果存在指定的句柄组，则返回 true。

参数

groupKey * optional 组键。

返回

类型	描述
Boolean	如果存在指定的句柄组，则返回 true。

示例

// Remove a named group of handles if they exist.
if (obj.hasHandles("watch-view-updates")) {
  obj.removeHandles("watch-view-updates");
}

removeHandles(groupKey)inherited

起始版本：GeoScene Maps SDK for JavaScript 4.25

移除对象拥有的句柄组。

参数

groupKey * optional 要移除的组键或组键的数组或集合。

示例

obj.removeHandles(); // removes handles from default group

obj.removeHandles("handle-group");
obj.removeHandles("other-handle-group");

toJSON(){Object}

将此类的实例转换为 GeoScene Portal JSON 表示。有关详细信息，请参阅使用 fromJSON() 指南主题。

返回

类型	描述
Object	此类实例的 GeoScene Portal JSON 表示。