Class: LineSymbol3D

LineSymbol3D

new LineSymbol3D(options)

base/symbol/LineSymbol3D.js, line 4

三维线符号，用于在三维场景视图中渲染线要素（LineString），不支持二维视图。
三维线符号必须包含以下符号图层中的一个或多个，才能在三维场景中显示要素：
三维线符号图层、 三维管道符号图层
示例如下：
[1、创建一个三维线符号对象]

Name Type Description
options Object

初始化参数

Name Type Description
symbolLayers Collection 可选

符号图层集合，用于定义线要素的可视化样式。 可包含一个或多个符号图层，不同图层类型决定最终渲染效果（如线条、管道等）。
Example

创建一个三维线符号对象

// ES5 引入方式
const { ProfileType, Feature } = zondy.enum
const { PathSymbol3DLayer, ColorMaterial, LineSymbol3D } = zondy.symbol
const { LineString } = zondy.geometry
const { GraphicsLayer } = zondy.layer
// ES6 引入方式
import { ProfileType, PathSymbol3DLayer, ColorMaterial, LineSymbol3D, LineString, Feature, GraphicsLayer } from "@mapgis/webclient-common"

// 创建三维管道符号图层
const pathSymbol3DLayer = new PathSymbol3DLayer({
  // 管道横截面宽度，单位为米
  width: 40,
  // 管道横截面高度，单位为米
  height: 40,
  // 管道填充材质
  material: new ColorMaterial(),
  // 管道横截面类型：circle（圆形）、quad（矩形）
  profile: ProfileType.circle
})

// 创建三维线符号，并指定符号图层（可同时指定多个）
const symbol = new LineSymbol3D({
  symbolLayers: [pathSymbol3DLayer]
})

// 构造线几何对象（坐标格式为 [经度, 纬度, 高程]）
const lineString = new LineString({
  coordinates: [
    [113, 29, 0],
    [114, 30, 0],
    [115, 30, 0],
  ],
})

// 构建要素对象，将几何与符号绑定
const feature = new Feature({
  geometry: lineString,
  symbol: symbol
})

// 创建图形图层
const layer = new GraphicsLayer({
  graphics: [],
})
map.add(layer)

// 将要素添加至图层
layer.add(feature)

Extends

Members

symbolLayersCollection

符号图层集合，用于可视化要素对象

typeString

符号类型，固定值为 line-3d，用于标识当前符号为三维线符号。

Methods

clone(){LineSymbol3D}

base/symbol/LineSymbol3D.js, line 108

克隆当前符号，返回一个具有相同属性的新实例。 新实例与原实例互不影响（深拷贝内部状态）。

Returns:
Type Description
LineSymbol3D 克隆后的新符号实例

toJSON(){Object}

base/symbol/LineSymbol3D.js, line 99

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

Returns:
Type Description
Object 包含符号所有属性的 JSON 对象

LineSymbol3D.fromJSON(json){LineSymbol3D}

base/symbol/LineSymbol3D.js, line 90

通过 JSON 对象构造并返回一个新的 LineSymbol3D 实例（静态工厂方法）。 接收的 JSON 结构应与 LineSymbol3D#toJSON 的返回值一致。

Name Type Default Description
json Object {} 可选

符号属性的 JSON 对象
Returns:
Type Description
LineSymbol3D 新的 LineSymbol3D 实例