实体完整目录

所有 VjCAD 实体类型的构造方式、属性和方法。

---

LineEnt — 直线

const { LineEnt, Engine } = vjcad;
const line = new LineEnt([0, 0], [100, 100]);
line.setDefaults();
line.color = 1;
Engine.addEntities(line);

---

CircleEnt — 圆

const { CircleEnt, Engine } = vjcad;
const circle = new CircleEnt([50, 50], 30);  // 圆心, 半径
circle.setDefaults();
Engine.addEntities(circle);

---

ArcEnt — 圆弧

const { ArcEnt, Point2D, Engine } = vjcad;

// 方式1：圆心 + 半径 + 角度（弧度）
const arc = new ArcEnt([50, 50], 30, 0, Math.PI / 2);  // 0° 到 90° 逆时针
arc.setDefaults();
Engine.addEntities(arc);

// 方式2：三点定弧
const arc2 = new ArcEnt();
arc2.initBy3Pt(new Point2D(0, 0), new Point2D(50, 30), new Point2D(100, 0));
arc2.setDefaults();
Engine.addEntities(arc2);

角度规则：0 = 正右方（3点钟），逆时针增加，Math.PI / 2 = 正上方，Math.PI = 正左方。

---

PolylineEnt — 多段线

const { PolylineEnt, Engine } = vjcad;

// 方式1：setPoints 批量设置
const pline = new PolylineEnt();
pline.setPoints([[0, 0], [100, 0], [100, 60], [0, 60]]);
pline.isClosed = true;
pline.setDefaults();
Engine.addEntities(pline);

// 方式2：链式 addPoint
const pline2 = new PolylineEnt();
pline2.addPoint([0, 0])
      .addPoint([50, 0], 0.5)   // 带凸度的弧段
      .addPoint([100, 0]);
pline2.setDefaults();
Engine.addEntities(pline2);

// 方式3：带圆弧段
const pline3 = new PolylineEnt();
pline3.setPoints([
    [0, 0],               // 直线段
    [[50, 0], 0.5],       // 弧段（凸度 0.5，逆时针）
    [100, 0],
    [[100, 50], -0.5]     // 弧段（负凸度，顺时针）
]);
pline3.setDefaults();
Engine.addEntities(pline3);

凸度说明：

• 0 — 直线段
• 1 — 半圆弧（逆时针，圆心角 180°）
• -1 — 半圆弧（顺时针）
• bulge = tan(圆心角 / 4)，圆心角单位为弧度
• 常用值：90° 圆角 → tan(π/8) ≈ 0.4142，60° → ≈ 0.2679，120° → ≈ 0.5774

注意：bulge=1 是半圆弧（180°），不是 90° 圆角！绘制圆角矩形应使用 Math.tan(Math.PI / 8) ≈ 0.4142。

---

TextEnt — 单行文字

const { TextEnt, Engine } = vjcad;
const text = new TextEnt();
text.insertionPoint = [0, 100];
text.text = "Hello WebCAD";
text.height = 10;
text.rotation = 0;           // 弧度
text.textAlignment = 5;      // 居中
text.setDefaults();
Engine.addEntities(text);

文本对齐方式（textAlignment）：

7=左上     8=中上     9=右上
4=左中     5=中心     6=右中
1=左下     2=中下     3=右下

特殊字符：%%d → °（度），%%c → Ø（直径），%%p → ±（正负）

---

MTextEnt — 多行文字

const { MTextEnt, Engine } = vjcad;
const mtext = new MTextEnt();
mtext.insertionPoint = [0, 100];
mtext.text = "第一行\n第二行\n第三行";
mtext.height = 8;
mtext.maxWidth = 80;
mtext.setDefaults();
Engine.addEntities(mtext);

MText 格式代码（通过 contents 属性使用）：

mtext.contents = "{\\C1;红色}{\\C2;黄色}{\\C3;绿色}";

---

SplineEnt — 样条曲线

const { SplineEnt, Engine } = vjcad;
const spline = new SplineEnt();
spline.setFitPoints([[0, 0], [50, 100], [100, 50], [150, 100]]);
// ⚠️ 必须传 [x,y] 数组——实现按 e[0]/e[1] 索引，传 Point2D 对象会得到 NaN
// isClosed 是只读 getter（首尾点重合即闭合），模块/严格模式下赋值会抛 TypeError
spline.setDefaults();
Engine.addEntities(spline);

---

EllipseEnt — 椭圆

const { EllipseEnt, Engine } = vjcad;
const ellipse = new EllipseEnt([50, 50], 40, 20, 0);  // 圆心, 长半轴, 短半轴, 长轴角(弧度)
ellipse.setDefaults();
// majorAxis 是长轴角度（number，弧度），不是向量；radiusRatio 只读（= minorRadius / majorRadius），赋值会抛 TypeError
Engine.addEntities(ellipse);

---

DotEnt — 点

const { DotEnt, Engine } = vjcad;
const dot = new DotEnt([50, 50]);
dot.setDefaults();
Engine.addEntities(dot);

---

SolidEnt — 实体填充

const { SolidEnt, Engine } = vjcad;

// 三角形填充
const solid = new SolidEnt([0, 0], [100, 0], [50, 80]);
solid.setDefaults();
solid.color = 1;
Engine.addEntities(solid);

// 四边形填充：按周边顺序给点（不是 AutoCAD 的 Z 序，Z 序会画成沙漏）
const solid2 = new SolidEnt([0, 0], [100, 0], [100, 80], [0, 80]);
solid2.setDefaults();
Engine.addEntities(solid2);

---

RayEnt — 射线 / XLineEnt — 构造线

const { RayEnt, XLineEnt, Engine } = vjcad;

// 射线（从起点向一个方向无限延伸）；第二参是**弧度制角度**，不是方向点
const ray = new RayEnt([0, 0], Math.PI / 4);   // 45°
ray.setDefaults();
Engine.addEntities(ray);

// 构造线（向两个方向无限延伸）；第二参同为角度（0 = 水平）
const xline = new XLineEnt([50, 50], 0);
xline.setDefaults();
Engine.addEntities(xline);

---

BezierEnt — 贝塞尔曲线

const { BezierEnt, Engine } = vjcad;
const bezier = new BezierEnt(bulgePointsCollection);
bezier.setDefaults();
Engine.addEntities(bezier);

---

ImageRefEnt — 图片引用

const { ImageRefEnt, Engine } = vjcad;
const img = new ImageRefEnt();
// 需设置图片源和裁剪模式后使用
img.setDefaults();
Engine.addEntities(img);

---

通用属性（所有实体）

通用方法（所有实体）

上表"数组也行"只对基础实体成立；标注族（*DimensionEnt）与 MLeaderEnt 的 move/rotate/scale/mirror 只收 Point2D，传数组会得到 NaN 坐标。