Class PolylineEnt

多段线类表示CAD中的多段线实体，继承自实体基类。多段线由一系列连接的线段和弧段组成，支持凸度值来表示弧段。

Example

import { PolylineEnt, BulgePoints, BulgePoint, Point2D, Engine } from '@aspect/webcad-lib-ts';

// 创建多段线顶点
const points = new BulgePoints();
points.push(new BulgePoint(0, 0));
points.push(new BulgePoint(100, 0));
points.push(new BulgePoint(100, 100));

// 创建多段线
const pline = new PolylineEnt(points, true); // true表示闭合
pline.setDefaults();

// 添加到画布
Engine.addEntities(pline);

Hierarchy (View Summary)

EntityBase
- PolylineEnt

Index

Constructors

constructor

Properties

type objectId id _lineType _isAlive isDirty block?

Constructors

constructor

new PolylineEnt(
points?: BulgePoints | PointInput[],
color?: number,
): PolylineEnt

构造函数

Parameters

points: BulgePoints | PointInput[] = ...
凸度点集合或坐标数组
color: number = 256
颜色索引，默认为256

Returns PolylineEnt

Example

// 方式1：使用坐标数组（推荐，简洁）
const pline = new PolylineEnt([[0, 0], [100, 0], [100, 100]]);

// 方式2：使用 BulgePoints
const bps = new BulgePoints();
bps.add(new BulgePoint([0, 0]));
bps.add(new BulgePoint([100, 0]));
const pline = new PolylineEnt(bps);

Properties

type

type: string

实体类型标识符（如"LINE"、"CIRCLE"等）

objectId

objectId: string

DWG对象ID（句柄）- 从DWG文件导入时的唯一标识符这个值不应该在克隆时复制，新创建的实体应该为空字符串

id

id: number

实体索引ID - 从1开始递增的唯一索引用于在WebCAD格式中标识实体

_lineType

_lineType: string

_isAlive

_isAlive: boolean

isDirty

isDirty: boolean

是否处于脏状态，供渲染器增量更新

`Optional`block

block?: any

Accessors

color

get color(): number
获取颜色索引

Returns number
颜色索引值（256表示"随图层"颜色）
Inherited from EntityBase.color
- Defined in entities/EntityBase.ts:116
set color(value: number): void
设置颜色索引
Parameters
- value: number
  颜色索引值（256表示"随图层"颜色）
Returns void
Inherited from EntityBase.color
- Defined in entities/EntityBase.ts:125

layerId

get layerId(): string
获取图层ID

Returns string
图层ID字符串
Inherited from EntityBase.layerId
- Defined in entities/EntityBase.ts:137
set layerId(value: string): void
设置图层ID
Parameters
- value: string
  图层ID字符串
Returns void
Inherited from EntityBase.layerId
- Defined in entities/EntityBase.ts:146

lineTypeScale

get lineTypeScale(): number
获取线型比例

Returns number
线型比例因子
Inherited from EntityBase.lineTypeScale
- Defined in entities/EntityBase.ts:158
set lineTypeScale(value: number): void
设置线型比例
Parameters
- value: number
  线型比例因子
Returns void
Inherited from EntityBase.lineTypeScale
- Defined in entities/EntityBase.ts:167

lineWeight

get lineWeight(): number
获取线宽

Returns number
线宽值（-1=ByLayer, -2=ByBlock, >=0为具体值，单位为0.01mm）
Inherited from EntityBase.lineWeight
- Defined in entities/EntityBase.ts:179
set lineWeight(value: number): void
设置线宽
Parameters
- value: number
  线宽值（-1=ByLayer, -2=ByBlock, >=0为具体值）
Returns void
Inherited from EntityBase.lineWeight
- Defined in entities/EntityBase.ts:188

transpMgr

get transpMgr(): TransparencyManager
获取透明度管理器

Returns TransparencyManager
透明度管理器实例
Inherited from EntityBase.transpMgr
- Defined in entities/EntityBase.ts:200
set transpMgr(value: TransparencyManager): void
设置透明度管理器
Parameters
- value: TransparencyManager
  透明度管理器实例
Returns void
Inherited from EntityBase.transpMgr
- Defined in entities/EntityBase.ts:209

isAlive

get isAlive(): boolean
获取实体存活状态

Returns boolean
是否存活（true表示有效，false表示已删除）
Inherited from EntityBase.isAlive
- Defined in entities/EntityBase.ts:219
set isAlive(value: boolean): void
设置实体存活状态
Parameters
- value: boolean
  是否存活
Returns void
Inherited from EntityBase.isAlive
- Defined in entities/EntityBase.ts:228

xdataRaw

get xdataRaw(): Record<string, string>
获取原始扩展数据（用于序列化）格式: { "1001": "AppName", "1000": "JSON字符串" }

Returns Record<string, string>
原始xdata对象或undefined
Inherited from EntityBase.xdataRaw
- Defined in entities/EntityBase.ts:242
set xdataRaw(value: Record<string, string>): void
设置原始扩展数据（从数据库加载时使用）
Parameters
- value: Record<string, string>
  原始xdata对象
Returns void
Inherited from EntityBase.xdataRaw
- Defined in entities/EntityBase.ts:251

extData

get extData(): Record<string, any>
获取扩展数据（用户友好格式）自动解析JSON字符串返回对象

Returns Record<string, any>
解析后的扩展数据对象，或undefined
Example
```
const data = entity.extData;
console.log(data?.sensorVal); // 10
```
Inherited from EntityBase.extData
- Defined in entities/EntityBase.ts:267

extDataAppName

get extDataAppName(): string
获取扩展数据的应用程序名（AppName）

Returns string
AppName字符串，或undefined
Inherited from EntityBase.extDataAppName
- Defined in entities/EntityBase.ts:281

doc

get doc(): any
获取所属文档

通过实体所在的块来获取文档对象。在CAD系统中，实体总是属于某个块，而块又属于某个文档。

Returns any
文档对象，如果无法获取则返回undefined
Inherited from EntityBase.doc
- Defined in entities/EntityBase.ts:337

layer

get layer(): string
获取图层名称

根据实体的layerId从文档的图层集合中查找对应的图层名称。如果找不到对应的图层，则返回默认图层"0"。

Returns string
图层名称，默认为"0"
Inherited from EntityBase.layer
- Defined in entities/EntityBase.ts:350
set layer(layerName: string): void
设置图层名称

根据图层名称查找对应的图层ID并设置给实体。如果找不到指定的图层，则使用默认图层ID（"0"）。

注意：优先使用实体所属文档的图层列表，如果实体尚未添加到文档，则使用 Engine.currentDoc 的图层列表。
Parameters
- layerName: string
  图层名称
Returns void
Inherited from EntityBase.layer
- Defined in entities/EntityBase.ts:367

lineType

get lineType(): string
获取线型

返回实体当前的线型设置。线型控制线条的显示样式（如实线、虚线、点划线等）。

Returns string
线型名称
Inherited from EntityBase.lineType
- Defined in entities/EntityBase.ts:384
set lineType(lineTypeName: string): void
设置线型

设置实体的线型，支持标准CAD线型、常见别名和自定义线型。输入的线型名称会被转换为大写进行匹配。

支持的线型：
- CONTINUOUS: 连续线（实线）
- HIDDEN/DASHED: 虚线（虚线）
- CENTER: 中心线
- PHANTOM: 幻影线
- DOT: 点线（映射为虚线）
- 自定义线型：通过LinetypeManager管理的线型
Parameters
- lineTypeName: string
  线型名称
Returns void
Inherited from EntityBase.lineType
- Defined in entities/EntityBase.ts:405

globalWidth

get globalWidth(): number
获取全局线宽

Returns number
全局线宽值
- Defined in entities/PolylineEnt.ts:64
set globalWidth(val: number): void
设置全局线宽并标记修改
Parameters
- val: number
  新的全局线宽值
Returns void
- Defined in entities/PolylineEnt.ts:73

isClosed

get isClosed(): boolean
获取是否闭合

Returns boolean
是否闭合
- Defined in entities/PolylineEnt.ts:83
set isClosed(val: boolean): void
设置是否闭合并标记修改
Parameters
- val: boolean
Returns void
- Defined in entities/PolylineEnt.ts:90

elevation

get elevation(): number
获取整体高程（2D多段线使用）

Returns number
整体高程值
- Defined in entities/PolylineEnt.ts:100
set elevation(val: number): void
设置整体高程并标记修改
Parameters
- val: number
  新的高程值
Returns void
- Defined in entities/PolylineEnt.ts:109

bulgePoints

get bulgePoints(): BulgePoints
获取凸度点集合

Returns BulgePoints
- Defined in entities/PolylineEnt.ts:117
set bulgePoints(val: BulgePoints): void
设置凸度点集合并标记修改
Parameters
- val: BulgePoints
Returns void
- Defined in entities/PolylineEnt.ts:124

elevations

get elevations(): number[]
获取高程值数组（3D多段线使用）

Returns number[]
高程值数组，如果不是3D多段线则返回null
- Defined in entities/PolylineEnt.ts:133
set elevations(val: number[]): void
设置高程值数组
Parameters
- val: number[]
  高程值数组，设置为null则清除高程数据
Returns void
- Defined in entities/PolylineEnt.ts:144

hasElevations

get hasElevations(): boolean
检查是否有高程数据（是否为3D多段线）

Returns boolean
是否有高程数据
- Defined in entities/PolylineEnt.ts:164

endPtIsClosed

get endPtIsClosed(): boolean
检查终点是否与起点闭合判断多段线的起点和终点是否重合（在容差范围内）

Returns boolean
是否闭合
- Defined in entities/PolylineEnt.ts:238

startPoint

get startPoint(): Point2D
获取起点

Returns Point2D
多段线的起点坐标
- Defined in entities/PolylineEnt.ts:427

endPoint

get endPoint(): Point2D
获取终点

Returns Point2D
多段线的终点坐标
- Defined in entities/PolylineEnt.ts:435

startBulgePoint

get startBulgePoint(): BulgePoint
获取起始凸度点

Returns BulgePoint
多段线的起始凸度点对象
- Defined in entities/PolylineEnt.ts:443

endBulgePoint

get endBulgePoint(): BulgePoint
获取结束凸度点

Returns BulgePoint
多段线的结束凸度点对象
- Defined in entities/PolylineEnt.ts:451

length

get length(): number
获取多段线总长度

计算多段线所有段的总长度，包括直线段和圆弧段。

Returns number
多段线的总长度
- Defined in entities/PolylineEnt.ts:638

subEnts

get subEnts(): (ArcEnt | LineEnt)[]
获取多段线的实体段集合

将多段线的凸度点转换为具体的几何实体（直线或圆弧）。这是多段线的核心方法，用于将抽象的凸度表示转换为具体的几何对象。

算法逻辑：
1. 根据是否闭合调整点的配对方式
2. 对每一对相邻点，根据凸度值创建直线或圆弧
3. 凸度为0：创建直线段
4. 凸度非0：创建圆弧段
Returns (ArcEnt | LineEnt)[]
实体段数组，包含直线(ut)和圆弧(ct)
- Defined in entities/PolylineEnt.ts:661

subGeometries

get subGeometries(): (GLine | GArc)[]
获取多段线的轻量级几何体集合（用于几何计算和渲染）

与 subEnts 不同，此方法返回轻量级几何对象（GLine、GArc），不包含实体属性（颜色、图层等），减少内存占用和计算开销。支持缓存，通过 Engine.ENABLE_GEOMETRY_CACHE 控制。

Returns (GLine | GArc)[]
轻量级几何体数组
- Defined in entities/PolylineEnt.ts:702

selfIntersect

get selfIntersect(): boolean
检测多段线自相交

检查多段线是否存在自相交（线段之间相交）。这是一个重要的几何验证方法，用于检测多段线的有效性。

算法逻辑：
1. 临时处理闭合状态，避免起终点重合的干扰
2. 对每个线段，检查它与其他非相邻线段的交点
3. 只检查直线段之间的相交（简化处理）
4. 恢复原始闭合状态
Returns boolean
如果存在自相交返回true
- Defined in entities/PolylineEnt.ts:903

hasBulge

get hasBulge(): boolean
检查是否包含凸度

判断多段线是否包含非零的凸度值（即是否包含圆弧段）。

Returns boolean
如果包含圆弧段返回true
- Defined in entities/PolylineEnt.ts:963

areaIsClosed

get areaIsClosed(): boolean
检查面积计算时是否闭合

判断多段线在面积计算时是否应该被视为闭合。即使标记为开放，如果起终点重合也视为闭合。

Returns boolean
如果应该视为闭合返回true
- Defined in entities/PolylineEnt.ts:980

area

get area(): number
获取多段线面积

计算多段线围成的面积。只有满足特定条件的多段线才能计算面积：
1. 不包含圆弧段（hasBulge为false）
2. 形成闭合区域（areaIsClosed为true）
3. 没有自相交（selfIntersect为false）
Returns number
面积值，如果不满足条件返回-1
- Defined in entities/PolylineEnt.ts:999

doubleArea

get doubleArea(): number
获取双倍面积

使用鞋带公式计算多边形的双倍面积。这是面积计算的基础方法。

Returns number
双倍面积值
- Defined in entities/PolylineEnt.ts:1017

isCCW

get isCCW(): boolean
检查是否为逆时针方向

根据双倍面积的符号判断多段线的绕向。正值表示逆时针，负值表示顺时针。

Returns boolean
如果是逆时针方向返回true
- Defined in entities/PolylineEnt.ts:1029

Methods

setExtData

setExtData(appName: string, data: Record<string, any>): void
设置扩展数据（用户友好格式）自动将对象序列化为JSON字符串存储
Parameters
- appName: string
  应用程序名（用于在DWG中标识数据来源）
- data: Record<string, any>
  要存储的数据对象（将被序列化为JSON）
Returns void
Example
```
entity.setExtData("MY_SENSOR", {
  sensorVal: 10,
  deviceName: "温度传感器",
  isActive: true
});
```
Inherited from EntityBase.setExtData
- Defined in entities/EntityBase.ts:300

clearExtData

clearExtData(): void
清除扩展数据

Returns void
Inherited from EntityBase.clearExtData
- Defined in entities/EntityBase.ts:312

hasExtData

hasExtData(): boolean
检查是否有扩展数据

Returns boolean
是否存在扩展数据
Inherited from EntityBase.hasExtData
- Defined in entities/EntityBase.ts:322

fromDefaultProps

fromDefaultProps(defaultPropsObject: any): this
从默认属性对象复制属性

将指定的默认属性对象的所有相关属性复制到当前实体。这通常用于创建新实体时应用默认设置。
Parameters
- defaultPropsObject: any
  默认属性对象，包含layer、colorIndex、lineType等属性
Returns this
当前实例（支持链式调用）
Inherited from EntityBase.fromDefaultProps
- Defined in entities/EntityBase.ts:469

setDefaults

setDefaults(): void
设置为系统默认值

从全局CAD系统设置中获取当前的默认属性值并应用到实体。这些默认值包括当前图层、当前颜色、当前线型等。

使用的全局变量：
- Engine.currentDoc.CLAYER: 当前图层名称
- Engine.CECOLOR: 当前实体颜色
- Engine.CELTYPE: 当前实体线型
- Engine.CELTSCALE: 当前实体线型比例
Returns void
Inherited from EntityBase.setDefaults
- Defined in entities/EntityBase.ts:531

fromDbDefaultProps

fromDbDefaultProps(dbPropsObject: any): this
从数据库默认属性对象设置属性

从数据库查询结果或序列化数据中恢复实体属性。这个方法处理数据库中可能存在的空值和默认值情况。
Parameters
- dbPropsObject: any
  数据库属性对象，包含layerId、colorIndex等属性
Returns this
当前实例（支持链式调用）
Inherited from EntityBase.fromDbDefaultProps
- Defined in entities/EntityBase.ts:551

mapToDbDefaultProps

mapToDbDefaultProps(targetDbObject: any): any
将属性映射到数据库默认属性对象

将当前实体的属性映射到数据库存储格式的对象中。用于保存实体数据到数据库或序列化。
Parameters
- targetDbObject: any
  目标数据库属性对象
Returns any
映射后的属性对象
Inherited from EntityBase.mapToDbDefaultProps
- Defined in entities/EntityBase.ts:609

dispose

dispose(): void
释放实体占用的外部资源子类如持有 PIXI 对象或大尺寸缓冲，应覆盖此方法清理

Returns void
Inherited from EntityBase.dispose
- Defined in entities/EntityBase.ts:671

getElevationAt

getElevationAt(index: number): number
获取指定顶点的高程值
Parameters
- index: number
  顶点索引（0-based）
Returns number
高程值，如果索引无效则返回0
- Defined in entities/PolylineEnt.ts:173

setElevationAt

setElevationAt(index: number, elevation: number): void
设置指定顶点的高程值
Parameters
- index: number
  顶点索引（0-based）
- elevation: number
  高程值
Returns void
- Defined in entities/PolylineEnt.ts:185

allPointsWithInBox

allPointsWithInBox(boundingBox: BoundingBox): boolean
检查所有关键点是否在指定框内

判断多段线的所有顶点是否都在指定的边界框内。这是一个可见性检测方法，用于判断多段线是否完全在视图范围内。
Parameters
- boundingBox: BoundingBox
  边界框对象
Returns boolean
如果所有顶点都在框内返回true
- Defined in entities/PolylineEnt.ts:253

reverse

reverse(): void
反转多段线方向

将多段线的顶点顺序反转，同时反转所有凸度值的符号。这个操作会改变多段线的绘制方向，但保持几何形状不变。

Returns void
- Defined in entities/PolylineEnt.ts:270

addVertex

addVertex(point: PointInput, bulge?: number, elevation?: number): void
添加一个顶点到多段线末尾支持简化的数组写法 [x, y]。
Parameters
- point: PointInput
  新顶点的坐标，支持 Point2D 或数组 [x, y]
- bulge: number = 0
  从新顶点到下一个顶点的凸度，默认为0
- Optionalelevation: number
  顶点高程值（可选），如果存在高程数组会同步添加
Returns void
Example
```
const polyline = new PolylineEnt();
polyline.addVertex([0, 0]);
polyline.addVertex([100, 0]);
polyline.addVertex([100, 100], 0.5); // 带凸度
```
- Defined in entities/PolylineEnt.ts:301

addPoint

addPoint(coord: [number, number], bulge?: number): this
添加单个点（简化接口）
Parameters
- coord: [number, number]
  坐标数组 [x, y]
- bulge: number = 0
  凸度值，默认为0
Returns this
this，支持链式调用
Example
```
pline.addPoint([100, 0]);
pline.addPoint([100, 50], -0.5);
```
- Defined in entities/PolylineEnt.ts:322

addPoints

addPoints(points: ([number, number] | [[number, number], number])[]): this
批量添加点（追加到末尾）
Parameters
- points: ([number, number] | [[number, number], number])[]
  点数组，每项可以是 [x, y] 或 [[x, y], bulge]
Returns this
this，支持链式调用
Example
```
pline.addPoints([[0, 0], [100, 0], [[100, 50], -0.5]]);
```
- Defined in entities/PolylineEnt.ts:335

setPoints

setPoints(points: ([number, number] | [[number, number], number])[]): this
设置所有点（替换现有点）
Parameters
- points: ([number, number] | [[number, number], number])[]
  点数组，每项可以是 [x, y] 或 [[x, y], bulge]
Returns this
this，支持链式调用
Example
```
pline.setPoints([[0, 0], [100, 0], [[100, 50], -0.5], [50, 80], [0, 50]]);
```
- Defined in entities/PolylineEnt.ts:357

getPoint

getPoint(index: number): [number, number]
获取指定索引的点坐标
Parameters
- index: number
  点索引（0-based）
Returns [number, number]
[x, y] 坐标数组
Example
```
const [x, y] = pline.getPoint(0);
```
- Defined in entities/PolylineEnt.ts:369

getPointWithBulge

getPointWithBulge(index: number): [[number, number], number]
获取指定索引的点坐标和凸度
Parameters
- index: number
  点索引（0-based）
Returns [[number, number], number]
[[x, y], bulge] 格式
Example
```
const [[x, y], bulge] = pline.getPointWithBulge(0);
```
- Defined in entities/PolylineEnt.ts:381

getPoints

getPoints(): [number, number][]
获取所有点坐标（不含凸度）

Returns [number, number][]
[x, y][] 坐标数组
Example
```
const points = pline.getPoints(); // [[0,0], [100,0], [100,50]]
```
- Defined in entities/PolylineEnt.ts:392

getPointsWithBulge

getPointsWithBulge(): ([number, number] | [[number, number], number])[]
获取所有点（含凸度，与setPoints格式一致）

Returns ([number, number] | [[number, number], number])[]
点数组，凸度为0时返回[x,y]，否则返回[[x,y], bulge]
Example
```
const points = pline.getPointsWithBulge();
// [[0,0], [100,0], [[100,50], -0.5]]
```
- Defined in entities/PolylineEnt.ts:403

removeLastVertex

removeLastVertex(): void
移除最后一个顶点

Returns void
- Defined in entities/PolylineEnt.ts:415

setClosed

setClosed(closedFlag: boolean): void
设置闭合状态
Parameters
- closedFlag: boolean
  是否闭合
Returns void
- Defined in entities/PolylineEnt.ts:459

mirror

mirror(mirrorAxisStart: PointInput, mirrorAxisEnd: PointInput): void
镜像变换

对多段线进行镜像变换，以指定的两点为镜像轴。镜像操作会改变所有顶点位置和凸度值的符号。
Parameters
- mirrorAxisStart: PointInput
  镜像轴起点
- mirrorAxisEnd: PointInput
  镜像轴终点
Returns void
Overrides EntityBase.mirror
- Defined in entities/PolylineEnt.ts:473

getRawBulgePoints

getRawBulgePoints(): BulgePoint[]
Returns BulgePoint[]
- Defined in entities/PolylineEnt.ts:499

move

move(fromPoint: PointInput, toPoint: PointInput): void
移动变换

将多段线从一个位置移动到另一个位置。移动所有顶点，保持相对位置不变。
Parameters
- fromPoint: PointInput
  起始位置
- toPoint: PointInput
  目标位置
Returns void
- Defined in entities/PolylineEnt.ts:511

rotate

rotate(rotationCenter: PointInput, rotationAngle: number): void
旋转变换

围绕指定点旋转多段线。旋转所有顶点，凸度值保持不变。
Parameters
- rotationCenter: PointInput
  旋转中心点
- rotationAngle: number
  旋转角度（弧度）
Returns void
- Defined in entities/PolylineEnt.ts:537

scale

scale(scaleCenter: PointInput, scaleFactor: number): void
缩放变换

以指定点为中心对多段线进行缩放。缩放会同时影响顶点位置和全局线宽。
Parameters
- scaleCenter: PointInput
  缩放中心点
- scaleFactor: number
  缩放因子
Returns void
- Defined in entities/PolylineEnt.ts:566

stretch

stretch(
    stretchStartPoint: PointInput,
    stretchEndPoint: PointInput,
    stretchBox: BoundingBox,
): void
拉伸变形操作

根据拉伸框和移动向量对多段线进行拉伸。只有在拉伸框内的顶点会被移动。
Parameters
- stretchStartPoint: PointInput
  拉伸起始点
- stretchEndPoint: PointInput
  拉伸目标点
- stretchBox: BoundingBox
  拉伸框对象
Returns void
- Defined in entities/PolylineEnt.ts:594

repairStretch

repairStretch(backupPolylineData: PolylineEnt): void
修复拉伸操作

从备份数据恢复多段线的几何参数。
Parameters
- backupPolylineData: PolylineEnt
  备份的多段线数据
Returns void
- Defined in entities/PolylineEnt.ts:626

clearGeometryCache

clearGeometryCache(): void
清除几何缓存在实体被修改时调用

Returns void
- Defined in entities/PolylineEnt.ts:745

setModified

setModified(): void
重写 setModified 以清除几何缓存

Returns void
Overrides EntityBase.setModified
- Defined in entities/PolylineEnt.ts:752

boundingBox

boundingBox(coordinateSystemType?: CoordinateSystemType): BoundingBox
计算边界框

根据指定的坐标系计算多段线的最小边界矩形。通过合并所有段的边界框来计算总边界框。
Parameters
- coordinateSystemType: CoordinateSystemType = CoordinateSystemType.WCS
  坐标系类型（M.WCS、M.UCS、M.DCS）
Returns BoundingBox
边界框对象
- Defined in entities/PolylineEnt.ts:766

getSubEnts

getSubEnts(): (ArcEnt | LineEnt)[]
获取实体段集合

返回多段线的所有实体段。这是ents属性的访问方法。

Returns (ArcEnt | LineEnt)[]
实体段数组
- Defined in entities/PolylineEnt.ts:820

getEnts_Ext

getEnts_Ext(): (ArcEnt | LineEnt | RayEnt | CircleEnt)[]
获取扩展实体段集合

获取多段线的扩展实体集合，用于延伸操作。将首尾两段替换为对应的延伸实体（圆或射线）。

算法逻辑：
1. 保留中间段不变
2. 第一段：圆弧→圆，直线→反向射线
3. 最后一段：圆弧→圆，直线→正向射线
Returns (ArcEnt | LineEnt | RayEnt | CircleEnt)[]
扩展实体段数组
- Defined in entities/PolylineEnt.ts:837

getEnts_AsNotZero

getEnts_AsNotZero(): (ArcEnt | LineEnt)[]
获取非零长度的实体段集合

过滤掉长度为零的实体段（起点和终点重合的段）。这用于避免在计算中包含退化的几何对象。

Returns (ArcEnt | LineEnt)[]
非零长度的实体段数组
- Defined in entities/PolylineEnt.ts:876

trimFrontAtDist

trimFrontAtDist(trimDistance: number): void
从前端按距离修剪多段线

从多段线的起点开始，按指定距离修剪多段线。算法遍历各段，累计长度直到达到指定距离，然后修剪相应的段。
Parameters
- trimDistance: number
  修剪距离
Returns void
- Defined in entities/PolylineEnt.ts:1041

trimBackAtDist

trimBackAtDist(trimDistance: number): void
从后端按距离修剪多段线

从多段线的终点开始，按指定距离修剪多段线。算法与trimFrontAtDist类似，但从后向前处理。
Parameters
- trimDistance: number
  修剪距离
Returns void
- Defined in entities/PolylineEnt.ts:1092

gripEdit

gripEdit(newPoint: Point2D, gripIndex: string): void
夹点编辑操作

编辑多段线的顶点位置。根据夹点索引更新对应顶点的坐标。
Parameters
- newPoint: Point2D
  新的夹点位置
- gripIndex: string
  夹点索引（字符串格式）
Returns void
- Defined in entities/PolylineEnt.ts:1145

gripEdit_Mid

gripEdit_Mid(newMidPoint: Point2D, segmentIndexString: string): void
中点夹点编辑操作

编辑多段线段的中点位置。这是一个复杂的操作，需要根据段的类型（直线或圆弧）采用不同的处理方式。
Parameters
- newMidPoint: Point2D
  新的中点位置
- segmentIndexString: string
  段索引（字符串格式）
Returns void
- Defined in entities/PolylineEnt.ts:1160

undoMap

undoMap(sourcePolyline: PolylineEnt): void
撤销映射操作

从撤销数据恢复多段线的所有参数。
Parameters
- sourcePolyline: PolylineEnt
  撤销数据对象
Returns void
- Defined in entities/PolylineEnt.ts:1214

clone

clone(): PolylineEnt
克隆多段线

创建当前多段线的完整副本，包括所有顶点和属性。

Returns PolylineEnt
新的多段线实例
- Defined in entities/PolylineEnt.ts:1228

toDb

toDb(): DbPline
转换为数据库格式

将多段线对象转换为适合数据库存储的格式。

Returns DbPline
数据库格式的多段线对象
- Defined in entities/PolylineEnt.ts:1262

fromDb

fromDb(dbPolyline: DbPline): void
从数据库格式恢复

从数据库格式的对象恢复多段线的所有参数。支持两种数据格式：新格式（dbBulgePoints）和旧格式（pointDataList）。
Parameters
- dbPolyline: DbPline
  数据库格式的多段线数据
Returns void
- Defined in entities/PolylineEnt.ts:1283

Class PolylineEnt

Example

Hierarchy (View Summary)

Index

Constructors

Properties

Accessors

Methods

Constructors

constructor

Parameters

Returns PolylineEnt

Example

Properties

type

objectId

id

_lineType

_isAlive

isDirty

Optionalblock

Accessors

color

Returns number

Parameters

Returns void

layerId

Returns string

Parameters

Returns void

lineTypeScale

Returns number

Parameters

Returns void

lineWeight

Returns number

Parameters

Returns void

transpMgr

Returns TransparencyManager

Parameters

Returns void

isAlive

Returns boolean

Parameters

Returns void

xdataRaw

Returns Record<string, string>

Parameters

Returns void

extData

Returns Record<string, any>

Example

extDataAppName

Returns string

doc

Returns any

layer

Returns string

Parameters

Returns void

lineType

Returns string

Parameters

Returns void

globalWidth

Returns number

Parameters

Returns void

isClosed

Returns boolean

Parameters

Returns void

elevation

Returns number

Parameters

Returns void

bulgePoints

Returns BulgePoints

Parameters

`Optional`block