Class SplineEnt

样条曲线类表示NURBS样条曲线，支持控制点和拟合点定义

Example

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

// 创建样条曲线
const spline = new SplineEnt();
spline.setDefaults();
// 设置拟合点...
Engine.addEntities(spline);

Hierarchy (View Summary)

EntityBase
- SplineEnt

Index

Constructors

constructor

Properties

type objectId id _lineType _isAlive isDirty block?

Constructors

constructor

new SplineEnt(): SplineEnt
Returns SplineEnt
Overrides EntityBase.constructor
- Defined in entities/SplineEnt.ts:101

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

fitPoints

get fitPoints(): SplineFitPoints
Returns SplineFitPoints
- Defined in entities/SplineEnt.ts:60
set fitPoints(val: SplineFitPoints): void
Parameters
- val: SplineFitPoints
Returns void
- Defined in entities/SplineEnt.ts:61

controlPoints

get controlPoints(): SplineControlPoints
Returns SplineControlPoints
- Defined in entities/SplineEnt.ts:66
set controlPoints(val: SplineControlPoints): void
Parameters
- val: SplineControlPoints
Returns void
- Defined in entities/SplineEnt.ts:67

splineFlag

get splineFlag(): number
Returns number
- Defined in entities/SplineEnt.ts:72
set splineFlag(val: number): void
Parameters
- val: number
Returns void
- Defined in entities/SplineEnt.ts:73

degree

get degree(): number
Returns number
- Defined in entities/SplineEnt.ts:75
set degree(val: number): void
Parameters
- val: number
Returns void
- Defined in entities/SplineEnt.ts:76

knots

get knots(): SplineKnots
Returns SplineKnots
- Defined in entities/SplineEnt.ts:78
set knots(val: SplineKnots): void
Parameters
- val: SplineKnots
Returns void
- Defined in entities/SplineEnt.ts:79

knotTolerance

get knotTolerance(): number
Returns number
- Defined in entities/SplineEnt.ts:84
set knotTolerance(val: number): void
Parameters
- val: number
Returns void
- Defined in entities/SplineEnt.ts:85

controlTolerance

get controlTolerance(): number
Returns number
- Defined in entities/SplineEnt.ts:87
set controlTolerance(val: number): void
Parameters
- val: number
Returns void
- Defined in entities/SplineEnt.ts:88

fitTolerance

get fitTolerance(): number
Returns number
- Defined in entities/SplineEnt.ts:90
set fitTolerance(val: number): void
Parameters
- val: number
Returns void
- Defined in entities/SplineEnt.ts:91

isRational

get isRational(): boolean
Returns boolean
- Defined in entities/SplineEnt.ts:93
set isRational(val: boolean): void
Parameters
- val: boolean
Returns void
- Defined in entities/SplineEnt.ts:94

isPeriodic

get isPeriodic(): boolean
Returns boolean
- Defined in entities/SplineEnt.ts:96
set isPeriodic(val: boolean): void
Parameters
- val: boolean
Returns void
- Defined in entities/SplineEnt.ts:97

numberOfKnot

get numberOfKnot(): number
获取节点数量

Returns number
节点数量
- Defined in entities/SplineEnt.ts:122

numberOfControlPoints

get numberOfControlPoints(): number
获取控制点数量

Returns number
控制点数量
- Defined in entities/SplineEnt.ts:130

numberOfFitPoints

get numberOfFitPoints(): number
获取拟合点数量

Returns number
拟合点数量
- Defined in entities/SplineEnt.ts:138

isClosed

get isClosed(): boolean
判断是否闭合

Returns boolean
是否闭合
- Defined in entities/SplineEnt.ts:146

isPlanar

get isPlanar(): boolean
判断是否平面

Returns boolean
是否平面（始终为true）
- Defined in entities/SplineEnt.ts:154

endPtIsClosed

get endPtIsClosed(): boolean
判断端点是否闭合

Returns boolean
端点是否闭合
- Defined in entities/SplineEnt.ts:199

startPoint

get startPoint(): Point2D
获取起始点

Returns Point2D
起始点坐标
- Defined in entities/SplineEnt.ts:232

endPoint

get endPoint(): Point2D
获取结束点

Returns Point2D
结束点坐标
- Defined in entities/SplineEnt.ts:240

length

get length(): number
获取样条曲线长度计算所有线段实体的总长度

Returns number
曲线长度
- Defined in entities/SplineEnt.ts:512

subEnts

get subEnts(): (ArcEnt | LineEnt)[]
获取样条曲线的线段实体将控制点连接成线段实体数组

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

subGeometries

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

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

Returns GLine[]
轻量级几何体数组
- Defined in entities/SplineEnt.ts:605

selfIntersect

get selfIntersect(): boolean
检查是否自相交检测样条曲线的线段是否存在自相交

Returns boolean
是否自相交
- Defined in entities/SplineEnt.ts:780

areaIsClosed

get areaIsClosed(): boolean
检查区域是否闭合判断样条曲线是否形成闭合区域

Returns boolean
区域是否闭合
- Defined in entities/SplineEnt.ts:833

area

get area(): number
获取面积样条曲线不支持面积计算

Returns number
面积（样条曲线返回-1）
- Defined in entities/SplineEnt.ts:849

doubleArea

get doubleArea(): number
获取双倍面积使用控制点计算多边形的双倍面积

Returns number
双倍面积
- Defined in entities/SplineEnt.ts:858

isCCW

get isCCW(): boolean
检查是否逆时针方向根据双倍面积的符号判断方向

Returns boolean
是否逆时针方向
- Defined in entities/SplineEnt.ts:868

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

getNurbsPoints

getNurbsPoints(): Point2D[]
获取NURBS点通过B样条算法计算样条曲线上的点

Returns Point2D[]
NURBS点数组
- Defined in entities/SplineEnt.ts:162

allPointsWithInBox

allPointsWithInBox(boundingBox: BoundingBox): boolean
检查所有控制点是否在指定框内
Parameters
- boundingBox: BoundingBox
  边界框
Returns boolean
是否所有点都在框内
- Defined in entities/SplineEnt.ts:215

addControlPoint

addControlPoint(coord: [number, number], weight?: number): this
添加单个控制点（简化接口）
Parameters
- coord: [number, number]
  坐标数组 [x, y]
- weight: number = 1
  权重，默认为1
Returns this
this，支持链式调用
Example
```
spline.addControlPoint([100, 0]);
spline.addControlPoint([100, 50], 0.5);
```
- Defined in entities/SplineEnt.ts:256

addControlPoints

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

setControlPoints

setControlPoints(
points: ([number, number] | [[number, number], number])[],
): this
设置所有控制点（替换现有点）
Parameters
- points: ([number, number] | [[number, number], number])[]
  点数组，每项可以是 [x, y] 或 [[x, y], weight]
Returns this
this，支持链式调用
Example
```
spline.setControlPoints([[0, 0], [50, 100], [100, 0], [[150, 50], 0.5]]);
```
- Defined in entities/SplineEnt.ts:301

getControlPoint

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

getControlPointWithWeight

getControlPointWithWeight(index: number): [[number, number], number]
获取指定索引的控制点坐标和权重
Parameters
- index: number
  点索引（0-based）
Returns [[number, number], number]
[[x, y], weight] 格式
Example
```
const [[x, y], weight] = spline.getControlPointWithWeight(0);
```
- Defined in entities/SplineEnt.ts:325

getControlPoints

getControlPoints(): [number, number][]
获取所有控制点坐标（不含权重）

Returns [number, number][]
[x, y][] 坐标数组
Example
```
const points = spline.getControlPoints(); // [[0,0], [100,0], ...]
```
- Defined in entities/SplineEnt.ts:336

getControlPointsWithWeight

getControlPointsWithWeight(): ([number, number] | [[number, number], number])[]
获取所有控制点（含权重，与setControlPoints格式一致）

Returns ([number, number] | [[number, number], number])[]
点数组，权重为1时返回[x,y]，否则返回[[x,y], weight]
Example
```
const points = spline.getControlPointsWithWeight();
// [[0,0], [100,0], [[100,50], 0.5]]
```
- Defined in entities/SplineEnt.ts:347

mirror

mirror(mirrorAxisStart: PointInput, mirrorAxisEnd: PointInput): void
镜像操作沿指定轴线镜像样条曲线
Parameters
- mirrorAxisStart: PointInput
  镜像轴起点
- mirrorAxisEnd: PointInput
  镜像轴终点
Returns void
Overrides EntityBase.mirror
- Defined in entities/SplineEnt.ts:364

move

move(fromPoint: PointInput, toPoint: PointInput): void
移动操作将样条曲线从起始点移动到目标点
Parameters
- fromPoint: PointInput
  起始点
- toPoint: PointInput
  目标点
Returns void
- Defined in entities/SplineEnt.ts:390

rotate

rotate(centerPoint: PointInput, angle: number): void
旋转操作绕指定中心点旋转样条曲线
Parameters
- centerPoint: PointInput
  旋转中心
- angle: number
  旋转角度（弧度）
Returns void
- Defined in entities/SplineEnt.ts:414

scale

scale(centerPoint: PointInput, scaleFactor: number): void
缩放操作以指定中心点缩放样条曲线
Parameters
- centerPoint: PointInput
  缩放中心
- scaleFactor: number
  缩放比例
Returns void
- Defined in entities/SplineEnt.ts:440

stretch

stretch(
    fromPoint: PointInput,
    toPoint: PointInput,
    stretchBox: BoundingBox,
): void
拉伸操作在指定拉伸框内的控制点会被移动
Parameters
- fromPoint: PointInput
  起始点
- toPoint: PointInput
  目标点
- stretchBox: BoundingBox
  拉伸框对象
Returns void
- Defined in entities/SplineEnt.ts:464

repairStretch

repairStretch(sourceSpline: SplineEnt): void
修复拉伸操作从源对象恢复控制点数据
Parameters
- sourceSpline: SplineEnt
  源样条曲线对象
Returns void
- Defined in entities/SplineEnt.ts:502

getRawControlPoints

getRawControlPoints(): SplineControlPoints
Returns SplineControlPoints
- Defined in entities/SplineEnt.ts:525

getNurbsEnts

getNurbsEnts(): LineEnt[]
获取NURBS实体数组将NURBS点转换为线段实体数组

Returns LineEnt[]
NURBS线段数组
- Defined in entities/SplineEnt.ts:534

toPline

toPline(): PolylineEnt
转换为多段线将样条曲线转换为多段线对象

Returns PolylineEnt
多段线对象
- Defined in entities/SplineEnt.ts:553

clearGeometryCache

clearGeometryCache(): void
清除几何缓存

Returns void
- Defined in entities/SplineEnt.ts:640

setModified

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

Returns void
Overrides EntityBase.setModified
- Defined in entities/SplineEnt.ts:647

boundingBox

boundingBox(coordinateSystemType?: CoordinateSystemType): BoundingBox
获取边界框计算包含所有实体的最小边界框
Parameters
- coordinateSystemType: CoordinateSystemType = CoordinateSystemType.WCS
  坐标系类型，默认为WCS
Returns BoundingBox
边界框
- Defined in entities/SplineEnt.ts:658

getSubEnts

getSubEnts(): (ArcEnt | LineEnt)[]
获取实体数组

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

getEnts_Ext

getEnts_Ext(): (ArcEnt | LineEnt | RayEnt | CircleEnt)[]
获取扩展实体数组在首尾添加扩展的射线或圆

Returns (ArcEnt | LineEnt | RayEnt | CircleEnt)[]
扩展实体数组
- Defined in entities/SplineEnt.ts:718

getEnts_AsNotZero

getEnts_AsNotZero(): (ArcEnt | LineEnt)[]
获取非零长度实体数组过滤掉长度为零的实体

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

gripEdit

gripEdit(newPosition: Point2D, gripIndex: string): void
夹点编辑移动指定索引的控制点到新位置
Parameters
- newPosition: Point2D
  新位置
- gripIndex: string
  夹点索引字符串
Returns void
- Defined in entities/SplineEnt.ts:878

undoMap

undoMap(undoData: SplineEnt): void
撤销映射从源对象恢复控制点数据
Parameters
- undoData: SplineEnt
  源样条曲线对象
Returns void
- Defined in entities/SplineEnt.ts:889

clone

clone(): SplineEnt
克隆对象创建当前样条曲线的完整副本

Returns SplineEnt
克隆的样条曲线对象
- Defined in entities/SplineEnt.ts:899

toDb

toDb(): DbSpline
转换为数据库对象将样条曲线转换为可持久化的数据库格式

Returns DbSpline
数据库样条曲线对象
- Defined in entities/SplineEnt.ts:922

fromDb

fromDb(dbData: DbSpline): void
从数据库对象加载从数据库格式恢复样条曲线数据
Parameters
- dbData: DbSpline
  数据库样条曲线对象
Returns void
- Defined in entities/SplineEnt.ts:941

Class SplineEnt

Example

Hierarchy (View Summary)

Index

Constructors

Properties

Accessors

Methods

Constructors

constructor

Returns SplineEnt

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

fitPoints

Returns SplineFitPoints

Parameters

Returns void

controlPoints

Returns SplineControlPoints

Parameters

Returns void

splineFlag

Returns number

Parameters

Returns void

degree

Returns number

Parameters

Returns void

knots

`Optional`block