Class: Symbol3DLayer

Symbol3DLayer

new Symbol3DLayer(options)

base/symbol/symbol3DLayer/Symbol3DLayer.js, line 4

三维符号图层基类,定义三维场景中点、线、面几何及 glTF 模型的渲染样式。
所有三维符号均包含一个 symbolLayers 属性,即 Symbol3DLayer 的集合,每个符号至少需要一个符号图层才能正常渲染。
当前支持以下类型的三维符号图层:
IconSymbol3DLayerObjectSymbol3DLayerLineSymbol3DLayerPathSymbol3DLayerFillSymbol3DLayerWaterSymbol3DLayerExtrudeSymbol3DLayerTextSymbol3DLayer

Name Type Description
options Object

构造参数

Name Type Description
id String 可选

符号图层唯一标识,不传时自动生成随机 UUID

transformMatrix Array.<Number> 可选

图层的变换矩阵,格式为16个元素的一维数组,表示一个4x4的齐次坐标变换矩阵

Members

idString

符号图层唯一标识

transformMatrixArray.<Number>

图层的变换矩阵,格式为16个元素的一维数组,表示一个4x4的齐次坐标变换矩阵

三维符号图层类型,子类中固定为对应类型字符串。 可选值:"icon" | "object" | "line" | "path" | "fill" | "water" | "extrude" | "text"

Methods

clone(){Symbol3DLayer}

base/symbol/symbol3DLayer/Symbol3DLayer.js, line 67

克隆当前图层,返回一个具有相同属性的新实例(深拷贝)。 新实例与原实例互不影响。

Returns:
Type Description
Symbol3DLayer 克隆后的新 Symbol3DLayer 实例

toJSON(){Object}

base/symbol/symbol3DLayer/Symbol3DLayer.js, line 54

将当前实例序列化为普通 JSON 对象,可用于持久化存储或网络传输。 返回的对象可通过 Symbol3DLayer.fromJSON 反序列化还原。

Returns:
Type Description
Object 包含图层所有属性的 JSON 对象

Symbol3DLayer.fromJSON(json){Symbol3DLayer}

base/symbol/symbol3DLayer/Symbol3DLayer.js, line 45

通过 JSON 数据构造对应的 Symbol3DLayer 子类实例(静态工厂方法)。 会根据 JSON 中的 type 字段自动创建对应子类(如 FillSymbol3DLayer、ExtrudeSymbol3DLayer 等)。

Name Type Description
json Object

符号图层的 JSON 对象,结构应与各子类 toJSON() 返回值一致

Returns:
Type Description
Symbol3DLayer 对应子类的符号图层实例