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	point
ObjectSymbol3DLayer	PointSymbol3D、PolygonSymbol3D	volumetric	meters
LineSymbol3DLayer	LineSymbol3D、PolygonSymbol3D	flat	point
PathSymbol3DLayer	LineSymbol3D	volumetric	meters
FillSymbol3DLayer	PolygonSymbol3D、MeshSymbol3D	flat	-
WaterSymbol3DLayer	PolygonSymbol3D	flat	-
ExtrudeSymbol3DLayer	PolygonSymbol3D	volumetric	meters
TextSymbol3DLayer	PointSymbol3D、PolygonSymbol3D、LabelSymbol3D	flat	point

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

另请参阅

• Symbol3D
• Renderer
• Graphic

属性概述

属性详细信息

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 }
);

this.addHandles(handle);

// Destroy the object
this.destroy();

参数

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

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

fromJSON(json){*}static

创建此类的新实例并使用从 GeoScene 产品生成的 JSON 对象值对其进行初始化。传入到输入 json 参数的对象通常来自对 REST API 中查询操作的响应或来自另一个 GeoScene 产品的 toJSON() 方法。

参数

json Object GeoScene 格式实例的 JSON 表示。

返回

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

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 表示。