Class EllipseEnt

椭圆类表示CAD中的椭圆实体，继承自实体基类包含中心点、长短半径、角度等属性

Example

import { EllipseEnt, Point2D, Engine } from 'vjcad';

// 创建椭圆：中心(50,50)，长半径30，短半径20，角度0
const ellipse = new EllipseEnt(new Point2D(50, 50), 30, 20, 0);
ellipse.setDefaults();
Engine.addEntities(ellipse);

Hierarchy (View Summary)

EntityBase
- EllipseEnt

Constructors

constructor

new EllipseEnt(
    centerPoint?: PointInput,
    majorRadiusValue?: number,
    minorRadiusValue?: number,
    majorAxisAngle?: number,
    color?: number,
): EllipseEnt
构造函数支持简化的数组写法 [x, y]。
Parameters
- centerPoint: PointInput = ...
  椭圆中心点，支持 Point2D 或数组 [x, y]
- majorRadiusValue: number = 1
  长半径
- minorRadiusValue: number = 1
  短半径
- majorAxisAngle: number = 0
  长轴角度
- color: number = 256
  颜色索引，默认为256
Returns EllipseEnt
Example
```
// 简化写法
const ellipse1 = new EllipseEnt([50, 50], 30, 20, 0);

// Point2D 写法
const ellipse2 = new EllipseEnt(new Point2D(50, 50), 30, 20, 0);
```
Overrides EntityBase.constructor
- Defined in entities/EllipseEnt.ts:65

Properties

type

type: string

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

_radiusRatio

_radiusRatio: number

_startAngle

_startAngle: number

_endAngle

_endAngle: number

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

center

get center(): Point2D
Returns Point2D
- Defined in entities/EllipseEnt.ts:98
set center(value: PointInput): void
Parameters
- value: PointInput
Returns void
- Defined in entities/EllipseEnt.ts:102

majorAxis

get majorAxis(): number
Returns number
- Defined in entities/EllipseEnt.ts:108
set majorAxis(value: number): void
Parameters
- value: number
Returns void
- Defined in entities/EllipseEnt.ts:112

majorRadius

get majorRadius(): number
Returns number
- Defined in entities/EllipseEnt.ts:117
set majorRadius(value: number): void
Parameters
- value: number
Returns void
- Defined in entities/EllipseEnt.ts:121

minorRadius

get minorRadius(): number
Returns number
- Defined in entities/EllipseEnt.ts:126
set minorRadius(value: number): void
Parameters
- value: number
Returns void
- Defined in entities/EllipseEnt.ts:130

startAngle

get startAngle(): number
获取起始角度

Returns number
标准化的起始角度（弧度）
- Defined in entities/EllipseEnt.ts:140
set startAngle(newStartAngle: number): void
设置起始角度
Parameters
- newStartAngle: number
  新的起始角度（弧度）
Returns void
- Defined in entities/EllipseEnt.ts:149

endAngle

get endAngle(): number
获取结束角度

Returns number
标准化的结束角度（弧度）
- Defined in entities/EllipseEnt.ts:163
set endAngle(newEndAngle: number): void
设置结束角度
Parameters
- newEndAngle: number
  新的结束角度（弧度）
Returns void
- Defined in entities/EllipseEnt.ts:172

rotation

get rotation(): number
旋转角度别名（兼容性）

Returns number
Alias
majorAxis
- Defined in entities/EllipseEnt.ts:189
set rotation(value: number): void
Parameters
- value: number
Returns void
- Defined in entities/EllipseEnt.ts:193

innerAng

get innerAng(): number
获取椭圆弧的内角

计算从起始角度到结束角度的角度范围。

Returns number
内角值（弧度）
- Defined in entities/EllipseEnt.ts:206

isEllipse

get isEllipse(): boolean
检查是否为完整椭圆

判断椭圆是否为完整的椭圆（360度）而不是椭圆弧。

Returns boolean
如果是完整椭圆返回true
- Defined in entities/EllipseEnt.ts:218

isEllipseArc

get isEllipseArc(): boolean
检查是否为椭圆弧

判断椭圆是否为椭圆弧（不完整的椭圆）。

Returns boolean
如果是椭圆弧返回true
- Defined in entities/EllipseEnt.ts:234

radiusRatio

get radiusRatio(): number
获取半径比例

计算短半径与长半径的比例。

Returns number
半径比例值（0-1之间）
- Defined in entities/EllipseEnt.ts:269

circumference

get circumference(): number
获取椭圆周长

计算椭圆的周长，这里使用长半径的近似计算。

Returns number
椭圆周长
- Defined in entities/EllipseEnt.ts:464

quad1

get quad1(): Point2D
获取第一象限点（右端点）

计算椭圆长轴正方向的端点。

Returns Point2D
第一象限点坐标
- Defined in entities/EllipseEnt.ts:475

quad2

get quad2(): Point2D
获取第二象限点（上端点）

计算椭圆短轴正方向的端点。

Returns Point2D
第二象限点坐标
- Defined in entities/EllipseEnt.ts:488

quad3

get quad3(): Point2D
获取第三象限点（左端点）

计算椭圆长轴负方向的端点。

Returns Point2D
第三象限点坐标
- Defined in entities/EllipseEnt.ts:501

quad4

get quad4(): Point2D
获取第四象限点（下端点）

计算椭圆短轴负方向的端点。

Returns Point2D
第四象限点坐标
- Defined in entities/EllipseEnt.ts:514

startPoint

get startPoint(): Point2D
获取椭圆弧起点

根据起始角度计算椭圆弧的起点坐标。

Returns Point2D
起点坐标
- Defined in entities/EllipseEnt.ts:527

endPoint

get endPoint(): Point2D
获取椭圆弧终点

根据结束角度计算椭圆弧的终点坐标。

Returns Point2D
终点坐标
- Defined in entities/EllipseEnt.ts:544

handle

get handle(): string
DWG句柄别名（兼容性）

Returns string
Alias
objectId
Inherited from EntityBase.handle
- Defined in entities/EntityBase.ts:121

entityType

get entityType(): string
实体类型别名（兼容性）

Returns string
Alias
type
Inherited from EntityBase.entityType
- Defined in entities/EntityBase.ts:129

color

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

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

layerId

get layerId(): string
获取图层ID

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

lineTypeScale

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

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

lineWeight

get lineWeight(): number
获取线宽

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

transpMgr

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

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

isAlive

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

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

visible

get visible(): boolean
DXF Group Code 60 entity visibility. true = visible (default), false = invisible.

Returns boolean
Inherited from EntityBase.visible
- Defined in entities/EntityBase.ts:261
set visible(value: boolean): void
Parameters
- value: boolean
Returns void
Inherited from EntityBase.visible
- Defined in entities/EntityBase.ts:265

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

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:307

extDataAppName

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

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

doc

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

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

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

layer

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

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

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

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

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

lineType

get lineType(): string
获取线型

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

Returns string
线型名称
Inherited from EntityBase.lineType
- Defined in entities/EntityBase.ts:424
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:445

Methods

rotateAngle

rotateAngle(rotationAngle: number): void
旋转椭圆角度

同时旋转起始角度和结束角度。
Parameters
- rotationAngle: number
  旋转角度（弧度）
Returns void
- Defined in entities/EllipseEnt.ts:245

resetEllipseAngle

resetEllipseAngle(): void
重置椭圆角度

将起始角度和结束角度都重置为0，使椭圆变为完整椭圆。

Returns void
- Defined in entities/EllipseEnt.ts:256

allPointsWithInBox

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

对于椭圆，只需检查中心点是否在指定的边界框内。这是一个简化的可见性检测方法。
Parameters
- boundingBox: BoundingBox
  边界框对象
Returns boolean
如果中心点在框内返回true
- Defined in entities/EllipseEnt.ts:283

initialize

initialize(centerPoint: Point2D, majorRadiusValue: number, color: number): void
初始化椭圆参数

使用给定的中心点、长半径和颜色初始化椭圆。
Parameters
- centerPoint: Point2D
  中心点坐标
- majorRadiusValue: number
  长半径值
- color: number
  颜色索引
Returns void
- Defined in entities/EllipseEnt.ts:296

mirror

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

对椭圆进行镜像变换，以指定的两点为镜像轴。镜像操作会改变中心点位置、长轴角度和起始/结束角度。
Parameters
- mirrorAxisStart: PointInput
  镜像轴起点
- mirrorAxisEnd: PointInput
  镜像轴终点
Returns void
Overrides EntityBase.mirror
- Defined in entities/EllipseEnt.ts:312

move

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

将椭圆从一个位置移动到另一个位置。只改变中心点位置，不影响半径和角度。
Parameters
- fromPoint: PointInput
  起始位置
- toPoint: PointInput
  目标位置
Returns void
Overrides EntityBase.move
- Defined in entities/EllipseEnt.ts:341

rotate

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

围绕指定点旋转椭圆。同时旋转中心点和长轴角度。
Parameters
- rotationCenter: PointInput
  旋转中心点
- rotationAngle: number
  旋转角度（弧度）
Returns void
- Defined in entities/EllipseEnt.ts:362

scale

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

以指定点为中心对椭圆进行缩放。缩放会同时影响中心点位置和长短半径大小。
Parameters
- scaleCenter: PointInput
  缩放中心点
- scaleFactor: number
  缩放因子
Returns void
- Defined in entities/EllipseEnt.ts:384

stretch

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

根据拉伸框和移动向量对椭圆进行拉伸。如果中心点在拉伸框内，则移动整个椭圆。
Parameters
- stretchStartPoint: PointInput
  拉伸起始点
- stretchEndPoint: PointInput
  拉伸目标点
- stretchBox: BoundingBox
  拉伸框对象
Returns void
- Defined in entities/EllipseEnt.ts:407

gripEdit

gripEdit(newGripPosition: Point2D, gripType: string): void
夹点编辑操作

根据夹点类型和新位置更新椭圆的几何参数。支持两种夹点类型：中心点和象限点。
Parameters
- newGripPosition: Point2D
  新的夹点位置
- gripType: string
  夹点类型（"center"=中心点，"quad"=象限点）
Returns void
- Defined in entities/EllipseEnt.ts:433

repairStretch

repairStretch(backupData: EllipseEnt): void
修复拉伸操作

从备份数据恢复椭圆的几何参数。
Parameters
- backupData: EllipseEnt
  备份的椭圆数据
Returns void
- Defined in entities/EllipseEnt.ts:452

getGlPoints

getGlPoints(): Point2D[]
获取OpenGL渲染点集

生成椭圆或椭圆弧的离散点集，用于OpenGL或WebGL渲染。算法分为两种情况：
1. 完整椭圆：生成均匀分布的点
2. 椭圆弧：根据角度范围生成点
Returns Point2D[]
渲染点集数组
- Defined in entities/EllipseEnt.ts:564

getBounds

getBounds(coordinateSystemType?: string): BoundingBox
获取椭圆边界框

根据指定的坐标系计算椭圆的边界框。通过获取椭圆的所有渲染点来计算精确的边界框。
Parameters
- coordinateSystemType: string = "Ucs"
  坐标系类型（"Wcs"、"Ucs"、"Dcs"）
Returns BoundingBox
边界框对象
- Defined in entities/EllipseEnt.ts:614

getBoundsDcs

getBoundsDcs(): BoundingBox
获取显示坐标系边界框

Returns BoundingBox
显示坐标系边界框
- Defined in entities/EllipseEnt.ts:645

getBoundsWcs

getBoundsWcs(): BoundingBox
获取世界坐标系边界框

Returns BoundingBox
世界坐标系边界框
- Defined in entities/EllipseEnt.ts:653

getBoundsUcs

getBoundsUcs(): BoundingBox
获取用户坐标系边界框

Returns BoundingBox
用户坐标系边界框
- Defined in entities/EllipseEnt.ts:661

boundingBox

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

根据指定的坐标系计算椭圆的最小边界矩形。这是标准的边界框计算方法，与getBounds方法功能相同。
Parameters
- coordinateSystemType: CoordinateSystemType = CoordinateSystemType.WCS
  坐标系类型（M.WCS、M.UCS、M.DCS）
Returns BoundingBox
边界框对象
- Defined in entities/EllipseEnt.ts:674

undoMap

undoMap(undoData: EllipseEnt): void
撤销映射操作

从撤销数据恢复椭圆的所有几何参数。
Parameters
- undoData: EllipseEnt
  撤销数据对象
Returns void
- Defined in entities/EllipseEnt.ts:709

clone

clone(): EllipseEnt
克隆椭圆

创建当前椭圆的完整副本，包括所有几何参数和属性。

Returns EllipseEnt
新的椭圆实例
Overrides EntityBase.clone
- Defined in entities/EllipseEnt.ts:726

toDb

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

将椭圆对象转换为适合数据库存储的格式。

Returns DbEllipse
数据库格式的椭圆对象
- Defined in entities/EllipseEnt.ts:752

fromDb

fromDb(dbData: any): void
从数据库格式恢复

从数据库格式的对象恢复椭圆的所有参数。
Parameters
- dbData: any
  数据库格式的椭圆数据
Returns void
- Defined in entities/EllipseEnt.ts:777

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:340

clearExtData

clearExtData(): void
清除扩展数据

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

hasExtData

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

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

fromDefaultProps

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

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

setCloneSource

setCloneSource(sourceHandle: string, mapid?: string, version?: string): void
显式标记本实体克隆自哪个图纸中的哪个实体

generateCloneObjectId 依赖 Engine.currentDoc.serverSource，编程式成图时当前文档往往不是克隆来源，需要用这个方法直接指定。

导出 DWG 时后端据此从源图做 ODA 克隆，只把发生变化的属性覆盖上去，未改动的字体、线型和填充图案保持源实体原样。
Parameters
- sourceHandle: string
  源实体在 DWG 中的 handle
- Optionalmapid: string
  源图 mapid；省略表示克隆自当前文档的 templateFrom 模板
- version: string = "v1"
  源图版本，默认 "v1"
Returns void
Inherited from EntityBase.setCloneSource
- Defined in entities/EntityBase.ts:573

setDefaults

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

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

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

fromDbDefaultProps

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

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

mapToDbDefaultProps

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

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

setModified

setModified(): void
通知渲染系统此实体已被修改。在桶渲染模式下，这将标记对应的桶为"脏"，以便在下次 regenPartial 时重绘。注意：此方法只标记，不触发重绘。调用方需要在适当的时候（如命令结束时）调用 regenPartial()。

Returns void
Inherited from EntityBase.setModified
- Defined in entities/EntityBase.ts:761

dispose

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

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

Class EllipseEnt

Example

Hierarchy (View Summary)

Index

Constructors

Properties

Accessors

Methods

Constructors

constructor

Parameters

Returns EllipseEnt

Example

Properties

type

_radiusRatio

_startAngle

_endAngle

objectId

id

_lineType

_isAlive

isDirty

Optionalblock

Accessors

center

Returns Point2D

Parameters

Returns void

majorAxis

Returns number

Parameters

Returns void

majorRadius

Returns number

Parameters

Returns void

minorRadius

Returns number

Parameters

Returns void

startAngle

Returns number

Parameters

Returns void

endAngle

Returns number

Parameters

Returns void

rotation

Returns number

Alias

Parameters

Returns void

innerAng

Returns number

isEllipse

Returns boolean

isEllipseArc

Returns boolean

radiusRatio

Returns number

circumference

Returns number

quad1

Returns Point2D

quad2

Returns Point2D

quad3

Returns Point2D

quad4

Returns Point2D

startPoint

Returns Point2D

endPoint

Returns Point2D

handle

Returns string

Alias

entityType

`Optional`block