@windypro-rourou/dsh-eda 0.1.0 → 0.1.1

package/skill/references/classes/IPCB_PrimitiveArc.md

@@ -0,0 +1,1901 @@
+# IPCB\_PrimitiveArc class
+
+Arc line primitive
+
+## Signature
+
+```typescript
+class IPCB_PrimitiveArc implements IPCB_Primitive
+```
+**Implements:** [IPCB\_Primitive](../interfaces/IPCB_Primitive.md)
+
+## Remarks
+
+Both lines and arc lines are wires, corresponding to the line traces and arc traces on the canvas
+
+## Methods
+
+<table><thead><tr><th>
+
+Method
+
+</th><th>
+
+Modifiers
+
+</th><th>
+
+Description
+
+</th></tr></thead>
+<tbody><tr><td>
+
+[done()](./IPCB_PrimitiveArc.md)
+
+</td><td>
+
+</td><td>
+
+**_(BETA)_** Apply the changes to the primitives to the canvas
+
+</td></tr>
+<tr><td>
+
+[getAdjacentPrimitives()](./IPCB_PrimitiveArc.md)
+
+</td><td>
+
+</td><td>
+
+**_(BETA)_** Get Adjacent primitive objects
+
+</td></tr>
+<tr><td>
+
+[getEntireTrack(includeVias)](./IPCB_PrimitiveArc.md)
+
+</td><td>
+
+</td><td>
+
+**_(BETA)_** Get the entire wire
+
+</td></tr>
+<tr><td>
+
+[getEntireTrack(includeVias)](./IPCB_PrimitiveArc.md)
+
+</td><td>
+
+</td><td>
+
+**_(BETA)_** Get the entire wire
+
+</td></tr>
+<tr><td>
+
+[getState\_ArcAngle()](./IPCB_PrimitiveArc.md)
+
+</td><td>
+
+</td><td>
+
+Get the property state: arc angle
+
+</td></tr>
+<tr><td>
+
+[getState\_EndX()](./IPCB_PrimitiveArc.md)
+
+</td><td>
+
+</td><td>
+
+Get the property state: end position X
+
+</td></tr>
+<tr><td>
+
+[getState\_EndY()](./IPCB_PrimitiveArc.md)
+
+</td><td>
+
+</td><td>
+
+Get the property state: end position Y
+
+</td></tr>
+<tr><td>
+
+[getState\_InteractiveMode()](./IPCB_PrimitiveArc.md)
+
+</td><td>
+
+</td><td>
+
+Get the property state: interaction mode
+
+</td></tr>
+<tr><td>
+
+[getState\_Layer()](./IPCB_PrimitiveArc.md)
+
+</td><td>
+
+</td><td>
+
+Get the property state: Layer
+
+</td></tr>
+<tr><td>
+
+[getState\_LineWidth()](./IPCB_PrimitiveArc.md)
+
+</td><td>
+
+</td><td>
+
+Get the property state: Line width
+
+</td></tr>
+<tr><td>
+
+[getState\_Net()](./IPCB_PrimitiveArc.md)
+
+</td><td>
+
+</td><td>
+
+Get the property state: net name
+
+</td></tr>
+<tr><td>
+
+[getState\_PrimitiveId()](./IPCB_PrimitiveArc.md)
+
+</td><td>
+
+</td><td>
+
+Get the property state: primitive ID
+
+</td></tr>
+<tr><td>
+
+[getState\_PrimitiveLock()](./IPCB_PrimitiveArc.md)
+
+</td><td>
+
+</td><td>
+
+Get the property state: whether it is locked
+
+</td></tr>
+<tr><td>
+
+[getState\_PrimitiveType()](./IPCB_PrimitiveArc.md)
+
+</td><td>
+
+</td><td>
+
+Get the property state: primitive type
+
+</td></tr>
+<tr><td>
+
+[getState\_StartX()](./IPCB_PrimitiveArc.md)
+
+</td><td>
+
+</td><td>
+
+Get the property state: start position X
+
+</td></tr>
+<tr><td>
+
+[getState\_StartY()](./IPCB_PrimitiveArc.md)
+
+</td><td>
+
+</td><td>
+
+Get the property state: start position Y
+
+</td></tr>
+<tr><td>
+
+[isAsync()](./IPCB_PrimitiveArc.md)
+
+</td><td>
+
+</td><td>
+
+Query whether the primitive is an async primitive
+
+</td></tr>
+<tr><td>
+
+[reset()](./IPCB_PrimitiveArc.md)
+
+</td><td>
+
+</td><td>
+
+**_(BETA)_** Reset the async primitive to the current canvas state
+
+</td></tr>
+<tr><td>
+
+[setState\_ArcAngle(arcAngle)](./IPCB_PrimitiveArc.md)
+
+</td><td>
+
+</td><td>
+
+**_(BETA)_** Set the property state: arc angle
+
+</td></tr>
+<tr><td>
+
+[setState\_EndX(endX)](./IPCB_PrimitiveArc.md)
+
+</td><td>
+
+</td><td>
+
+**_(BETA)_** Set the property state: end position X
+
+</td></tr>
+<tr><td>
+
+[setState\_EndY(endY)](./IPCB_PrimitiveArc.md)
+
+</td><td>
+
+</td><td>
+
+**_(BETA)_** Set the property state: end position Y
+
+</td></tr>
+<tr><td>
+
+[setState\_InteractiveMode(interactiveMode)](./IPCB_PrimitiveArc.md)
+
+</td><td>
+
+</td><td>
+
+**_(BETA)_** Set the property state: interaction mode
+
+</td></tr>
+<tr><td>
+
+[setState\_Layer(layer)](./IPCB_PrimitiveArc.md)
+
+</td><td>
+
+</td><td>
+
+**_(BETA)_** Set the property state: Layer
+
+</td></tr>
+<tr><td>
+
+[setState\_LineWidth(lineWidth)](./IPCB_PrimitiveArc.md)
+
+</td><td>
+
+</td><td>
+
+**_(BETA)_** Set the property state: Line width
+
+</td></tr>
+<tr><td>
+
+[setState\_Net(net)](./IPCB_PrimitiveArc.md)
+
+</td><td>
+
+</td><td>
+
+**_(BETA)_** Set the property state: net name
+
+</td></tr>
+<tr><td>
+
+[setState\_PrimitiveLock(primitiveLock)](./IPCB_PrimitiveArc.md)
+
+</td><td>
+
+</td><td>
+
+**_(BETA)_** Set the property state: whether it is locked
+
+</td></tr>
+<tr><td>
+
+[setState\_StartX(startX)](./IPCB_PrimitiveArc.md)
+
+</td><td>
+
+</td><td>
+
+**_(BETA)_** Set the property state: start position X
+
+</td></tr>
+<tr><td>
+
+[setState\_StartY(startY)](./IPCB_PrimitiveArc.md)
+
+</td><td>
+
+</td><td>
+
+**_(BETA)_** Set the property state: start position Y
+
+</td></tr>
+<tr><td>
+
+[toAsync()](./IPCB_PrimitiveArc.md)
+
+</td><td>
+
+</td><td>
+
+Convert Primitive to Async primitive
+
+</td></tr>
+<tr><td>
+
+[toSync()](./IPCB_PrimitiveArc.md)
+
+</td><td>
+
+</td><td>
+
+Convert Primitive to Sync primitive
+
+</td></tr>
+</tbody></table>
+
+---
+
+## 方法详情
+
+### done
+
+# IPCB\_PrimitiveArc.done() method
+
+> This API is provided as a beta preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
+
+Apply the changes to the primitives to the canvas
+
+## Signature
+
+```typescript
+function done(): Promise<IPCB_PrimitiveArc>;
+```
+
+## Returns
+
+Promise&lt;[IPCB\_PrimitiveArc](./IPCB_PrimitiveArc.md)<!-- -->&gt;
+
+Arc line primitive object
+
+## Example
+
+```javascript
+// 1. 生成本次运行专用的坐标，避免与之前保留的测试圆弧重合
+const x = 42000 + (Math.floor(Math.random() * 100000));
+const y = 2000 + (Math.floor(Math.random() * 100000));
+
+// 2. 创建一段测试圆弧
+const arc = await eda.pcb_PrimitiveArc.create('', 1, x, y, x + 500, y + 300, 90, 10, 1, false);
+
+// 3. 切换异步模式，连续累计两处修改（线宽 + 换层）
+const asyncArc = arc.toAsync();
+asyncArc.setState_LineWidth(24);
+asyncArc.setState_Layer(2);
+
+// 4. 一次性提交到画布
+await asyncArc.done();
+
+// 5. 从画布重新读取，确认两处修改都已生效（保留现场供观察）
+const refetched = await eda.pcb_PrimitiveArc.get(arc.getState_PrimitiveId());
+
+console.log('lineWidth:', 10, '→', refetched.getState_LineWidth());
+console.log('layer:', 1, '→', refetched.getState_Layer());
+```
+
+### getadjacentprimitives
+
+# IPCB\_PrimitiveArc.getAdjacentPrimitives() method
+
+> This API is provided as a beta preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
+
+Get Adjacent primitive objects
+
+## Signature
+
+```typescript
+function getAdjacentPrimitives(): Promise<
+	Array<IPCB_PrimitiveLine | IPCB_PrimitiveVia | IPCB_PrimitiveArc>
+>;
+```
+
+## Returns
+
+Promise&lt;Array&lt;[IPCB\_PrimitiveLine](./IPCB_PrimitiveLine.md) \| [IPCB\_PrimitiveVia](./IPCB_PrimitiveVia.md) \| [IPCB\_PrimitiveArc](./IPCB_PrimitiveArc.md)<!-- -->&gt;&gt;
+
+Adjacent line, via, and arc-line primitive objects
+
+## Remarks
+
+It will get the line, via, and arc-line primitive objects directly connected to the arc line
+
+## Example
+
+```javascript
+// 1. 创建一条直线走线，终点落在 (7500, 7000)
+const line = await eda.pcb_PrimitiveLine.create('', 1, 7000, 7000, 7500, 7000, 10);
+
+// 2. 创建一段圆弧，起点与直线终点重合，两段构成一整段导线
+const arc = await eda.pcb_PrimitiveArc.create('', 1, 7500, 7000, 7800, 7300, 90, 10, 1, false);
+
+// 3. 获取与圆弧直接相连的图元，并读出各自的类型
+const adjacent = await arc.getAdjacentPrimitives();
+
+// 4. 清理测试图元（查询类案例不留测试对象）
+await eda.pcb_PrimitiveLine.delete([line]);
+await eda.pcb_PrimitiveArc.delete([arc]);
+
+console.log('adjacent count:', adjacent.length);
+adjacent.forEach((p, i) => {
+	console.log(`adjacent[${i}] type:`, p.getState_PrimitiveType());
+});
+```
+
+### getentiretrack
+
+# IPCB\_PrimitiveArc.getEntireTrack() method
+
+> This API is provided as a beta preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
+
+Get the entire wire
+
+## Signature
+
+```typescript
+function getEntireTrack(includeVias: false): Promise<Array<IPCB_PrimitiveLine | IPCB_PrimitiveArc>>;
+```
+
+## Parameters
+
+<table><thead><tr><th>
+
+Parameter
+
+</th><th>
+
+Type
+
+</th><th>
+
+Description
+
+</th></tr></thead>
+<tbody><tr><td>
+
+includeVias
+
+</td><td>
+
+false
+
+</td><td>
+
+Whether to include the vias at both ends of the wire
+
+</td></tr>
+</tbody></table>
+
+## Returns
+
+Promise&lt;Array&lt;[IPCB\_PrimitiveLine](./IPCB_PrimitiveLine.md) \| [IPCB\_PrimitiveArc](./IPCB_PrimitiveArc.md)<!-- -->&gt;&gt;
+
+All lines and arc lines in the entire wire
+
+## Example
+
+```javascript
+// 1. 创建一条直线走线，终点落在 (7500, 7000)
+const line = await eda.pcb_PrimitiveLine.create('', 1, 7000, 7000, 7500, 7000, 10);
+
+// 2. 创建一段圆弧，起点与直线终点重合，两段构成一整段导线
+const arc = await eda.pcb_PrimitiveArc.create('', 1, 7500, 7000, 7800, 7300, 90, 10, 1, false);
+
+// 3. 只取导线内的直线和圆弧
+const trackOnly = await arc.getEntireTrack(false);
+
+// 4. 连两端过孔一起取（本例两端没有过孔，数量不变）
+const trackWithVias = await arc.getEntireTrack(true);
+
+// 5. 清理测试图元（查询类案例不留测试对象）
+await eda.pcb_PrimitiveLine.delete([line]);
+await eda.pcb_PrimitiveArc.delete([arc]);
+
+console.log('track(false) count:', trackOnly.length);
+trackOnly.forEach((p, i) => {
+	console.log(`track(false)[${i}] type:`, p.getState_PrimitiveType());
+});
+console.log('track(true) count:', trackWithVias.length);
+```
+
+### getentiretrack_1
+
+# IPCB\_PrimitiveArc.getEntireTrack() method
+
+> This API is provided as a beta preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
+
+Get the entire wire
+
+## Signature
+
+```typescript
+function getEntireTrack(
+	includeVias: true,
+): Promise<Array<IPCB_PrimitiveLine | IPCB_PrimitiveArc | IPCB_PrimitiveVia>>;
+```
+
+## Parameters
+
+<table><thead><tr><th>
+
+Parameter
+
+</th><th>
+
+Type
+
+</th><th>
+
+Description
+
+</th></tr></thead>
+<tbody><tr><td>
+
+includeVias
+
+</td><td>
+
+true
+
+</td><td>
+
+Whether to include the vias at both ends of the wire
+
+</td></tr>
+</tbody></table>
+
+## Returns
+
+Promise&lt;Array&lt;[IPCB\_PrimitiveLine](./IPCB_PrimitiveLine.md) \| [IPCB\_PrimitiveArc](./IPCB_PrimitiveArc.md) \| [IPCB\_PrimitiveVia](./IPCB_PrimitiveVia.md)<!-- -->&gt;&gt;
+
+All lines and arc lines in the entire wire, as well as the vias connected at both ends (if any)
+
+### getstate_arcangle
+
+# IPCB\_PrimitiveArc.getState\_ArcAngle() method
+
+Get the property state: arc angle
+
+## Signature
+
+```typescript
+function getState_ArcAngle(): number;
+```
+
+## Returns
+
+number
+
+Arc angle
+
+## Example
+
+```javascript
+// 1. 创建一段 90° 测试圆弧（PCB 坐标单位 mil）
+const arc = await eda.pcb_PrimitiveArc.create('', 1, 1000, 1000, 1500, 1300, 90, 10, 1, false);
+
+// 2. 读取圆弧角度
+const arcAngle = arc.getState_ArcAngle();
+
+// 3. 清理测试图元（查询类案例不留测试对象）
+await eda.pcb_PrimitiveArc.delete([arc.getState_PrimitiveId()]);
+
+console.log('arcAngle:', arcAngle);
+```
+
+### getstate_endx
+
+# IPCB\_PrimitiveArc.getState\_EndX() method
+
+Get the property state: end position X
+
+## Signature
+
+```typescript
+function getState_EndX(): number;
+```
+
+## Returns
+
+number
+
+End position X
+
+## Example
+
+```javascript
+// 1. 创建一段测试圆弧，终点 (1500, 1300)（PCB 坐标单位 mil）
+const arc = await eda.pcb_PrimitiveArc.create('', 1, 1000, 1000, 1500, 1300, 90, 10, 1, false);
+
+// 2. 读取终止位置 X
+const endX = arc.getState_EndX();
+
+// 3. 清理测试图元（查询类案例不留测试对象）
+await eda.pcb_PrimitiveArc.delete([arc.getState_PrimitiveId()]);
+
+console.log('endX:', endX);
+```
+
+### getstate_endy
+
+# IPCB\_PrimitiveArc.getState\_EndY() method
+
+Get the property state: end position Y
+
+## Signature
+
+```typescript
+function getState_EndY(): number;
+```
+
+## Returns
+
+number
+
+End position Y
+
+## Example
+
+```javascript
+// 1. 创建一段测试圆弧，终点 (1500, 1300)（PCB 坐标单位 mil）
+const arc = await eda.pcb_PrimitiveArc.create('', 1, 1000, 1000, 1500, 1300, 90, 10, 1, false);
+
+// 2. 读取终止位置 Y
+const endY = arc.getState_EndY();
+
+// 3. 清理测试图元（查询类案例不留测试对象）
+await eda.pcb_PrimitiveArc.delete([arc.getState_PrimitiveId()]);
+
+console.log('endY:', endY);
+```
+
+### getstate_interactivemode
+
+# IPCB\_PrimitiveArc.getState\_InteractiveMode() method
+
+Get the property state: interaction mode
+
+## Signature
+
+```typescript
+function getState_InteractiveMode(): EPCB_PrimitiveArcInteractiveMode;
+```
+
+## Returns
+
+[EPCB\_PrimitiveArcInteractiveMode](../enums/EPCB_PrimitiveArcInteractiveMode.md)
+
+Interaction mode
+
+## Example
+
+```javascript
+// 1. 创建一段两点圆弧（交互模式 1）的测试圆弧
+const arc = await eda.pcb_PrimitiveArc.create('', 1, 1000, 1000, 1500, 1300, 90, 10, 1, false);
+
+// 2. 读取交互模式
+const interactiveMode = arc.getState_InteractiveMode();
+
+// 3. 清理测试图元（查询类案例不留测试对象）
+await eda.pcb_PrimitiveArc.delete([arc.getState_PrimitiveId()]);
+
+console.log('interactiveMode:', interactiveMode);
+```
+
+### getstate_layer
+
+# IPCB\_PrimitiveArc.getState\_Layer() method
+
+Get the property state: Layer
+
+## Signature
+
+```typescript
+function getState_Layer(): TPCB_LayersOfLine;
+```
+
+## Returns
+
+[TPCB\_LayersOfLine](../types/TPCB_LayersOfLine.md)
+
+Layer
+
+## Example
+
+```javascript
+// 1. 创建一段顶层（1）测试圆弧
+const arc = await eda.pcb_PrimitiveArc.create('', 1, 1000, 1000, 1500, 1300, 90, 10, 1, false);
+
+// 2. 读取所在层
+const layer = arc.getState_Layer();
+
+// 3. 清理测试图元（查询类案例不留测试对象）
+await eda.pcb_PrimitiveArc.delete([arc.getState_PrimitiveId()]);
+
+console.log('layer:', layer);
+```
+
+### getstate_linewidth
+
+# IPCB\_PrimitiveArc.getState\_LineWidth() method
+
+Get the property state: Line width
+
+## Signature
+
+```typescript
+function getState_LineWidth(): number;
+```
+
+## Returns
+
+number
+
+Line width
+
+## Example
+
+```javascript
+// 1. 创建一段 10mil 线宽的测试圆弧
+const arc = await eda.pcb_PrimitiveArc.create('', 1, 1000, 1000, 1500, 1300, 90, 10, 1, false);
+
+// 2. 读取线宽
+const lineWidth = arc.getState_LineWidth();
+
+// 3. 清理测试图元（查询类案例不留测试对象）
+await eda.pcb_PrimitiveArc.delete([arc.getState_PrimitiveId()]);
+
+console.log('lineWidth:', lineWidth);
+```
+
+### getstate_net
+
+# IPCB\_PrimitiveArc.getState\_Net() method
+
+Get the property state: net name
+
+## Signature
+
+```typescript
+function getState_Net(): string;
+```
+
+## Returns
+
+string
+
+Net name
+
+## Example
+
+```javascript
+// 1. 创建一段指定网络的测试圆弧
+const arc = await eda.pcb_PrimitiveArc.create('嘉立创示例_NET', 1, 1000, 1000, 1500, 1300, 90, 10, 1, false);
+
+// 2. 读取网络名称
+const net = arc.getState_Net();
+
+// 3. 清理测试图元（查询类案例不留测试对象）
+await eda.pcb_PrimitiveArc.delete([arc.getState_PrimitiveId()]);
+
+console.log('net:', net);
+```
+
+### getstate_primitiveid
+
+# IPCB\_PrimitiveArc.getState\_PrimitiveId() method
+
+Get the property state: primitive ID
+
+## Signature
+
+```typescript
+function getState_PrimitiveId(): string;
+```
+
+## Returns
+
+string
+
+Primitive ID
+
+## Example
+
+```javascript
+// 1. 创建一段测试圆弧
+const arc = await eda.pcb_PrimitiveArc.create('', 1, 1000, 1000, 1500, 1300, 90, 10, 1, false);
+
+// 2. 读取图元 ID
+const primitiveId = arc.getState_PrimitiveId();
+
+// 3. 用该 ID 从画布重新取回圆弧，验证 ID 有效
+const refetched = await eda.pcb_PrimitiveArc.get(primitiveId);
+
+// 4. 清理测试图元（查询类案例不留测试对象）
+await eda.pcb_PrimitiveArc.delete([primitiveId]);
+
+console.log('primitiveId:', primitiveId);
+console.log('refetched type:', refetched.getState_PrimitiveType());
+```
+
+### getstate_primitivelock
+
+# IPCB\_PrimitiveArc.getState\_PrimitiveLock() method
+
+Get the property state: whether it is locked
+
+## Signature
+
+```typescript
+function getState_PrimitiveLock(): boolean;
+```
+
+## Returns
+
+boolean
+
+Whether it is locked
+
+## Example
+
+```javascript
+// 1. 创建一段测试圆弧（默认不锁定）
+const arc = await eda.pcb_PrimitiveArc.create('', 1, 1000, 1000, 1500, 1300, 90, 10, 1, false);
+
+// 2. 读取锁定状态
+const locked = arc.getState_PrimitiveLock();
+
+// 3. 清理测试图元（查询类案例不留测试对象）
+await eda.pcb_PrimitiveArc.delete([arc.getState_PrimitiveId()]);
+
+console.log('locked:', locked);
+```
+
+### getstate_primitivetype
+
+# IPCB\_PrimitiveArc.getState\_PrimitiveType() method
+
+Get the property state: primitive type
+
+## Signature
+
+```typescript
+function getState_PrimitiveType(): EPCB_PrimitiveType;
+```
+
+## Returns
+
+[EPCB\_PrimitiveType](../enums/EPCB_PrimitiveType.md)
+
+Primitive type
+
+## Example
+
+```javascript
+// 1. 创建一段测试圆弧
+const arc = await eda.pcb_PrimitiveArc.create('', 1, 1000, 1000, 1500, 1300, 90, 10, 1, false);
+
+// 2. 读取图元类型
+const type = arc.getState_PrimitiveType();
+
+// 3. 清理测试图元（查询类案例不留测试对象）
+await eda.pcb_PrimitiveArc.delete([arc.getState_PrimitiveId()]);
+
+console.log('type:', type);
+```
+
+### getstate_startx
+
+# IPCB\_PrimitiveArc.getState\_StartX() method
+
+Get the property state: start position X
+
+## Signature
+
+```typescript
+function getState_StartX(): number;
+```
+
+## Returns
+
+number
+
+Start position X
+
+## Example
+
+```javascript
+// 1. 创建一段测试圆弧，起点 (1000, 1000)（PCB 坐标单位 mil）
+const arc = await eda.pcb_PrimitiveArc.create('', 1, 1000, 1000, 1500, 1300, 90, 10, 1, false);
+
+// 2. 读取起始位置 X
+const startX = arc.getState_StartX();
+
+// 3. 清理测试图元（查询类案例不留测试对象）
+await eda.pcb_PrimitiveArc.delete([arc.getState_PrimitiveId()]);
+
+console.log('startX:', startX);
+```
+
+### getstate_starty
+
+# IPCB\_PrimitiveArc.getState\_StartY() method
+
+Get the property state: start position Y
+
+## Signature
+
+```typescript
+function getState_StartY(): number;
+```
+
+## Returns
+
+number
+
+Start position Y
+
+## Example
+
+```javascript
+// 1. 创建一段测试圆弧，起点 (1000, 1000)（PCB 坐标单位 mil）
+const arc = await eda.pcb_PrimitiveArc.create('', 1, 1000, 1000, 1500, 1300, 90, 10, 1, false);
+
+// 2. 读取起始位置 Y
+const startY = arc.getState_StartY();
+
+// 3. 清理测试图元（查询类案例不留测试对象）
+await eda.pcb_PrimitiveArc.delete([arc.getState_PrimitiveId()]);
+
+console.log('startY:', startY);
+```
+
+### isasync
+
+# IPCB\_PrimitiveArc.isAsync() method
+
+Query whether the primitive is an async primitive
+
+## Signature
+
+```typescript
+function isAsync(): boolean;
+```
+
+## Returns
+
+boolean
+
+Whether Is async primitive
+
+## Example
+
+```javascript
+// 1. 创建一段测试圆弧，创建后默认处于异步模式
+const arc = await eda.pcb_PrimitiveArc.create('', 1, 1000, 1000, 1500, 1300, 90, 10, 1, false);
+const asyncOnCreate = arc.isAsync();
+
+// 2. 切换到同步模式再查询一次，对比两种模式
+arc.toSync();
+const asyncAfterToSync = arc.isAsync();
+
+// 3. 清理测试图元（查询类案例不留测试对象）
+await eda.pcb_PrimitiveArc.delete([arc.getState_PrimitiveId()]);
+
+console.log('isAsync on create:', asyncOnCreate);
+console.log('isAsync after toSync:', asyncAfterToSync);
+```
+
+### reset
+
+# IPCB\_PrimitiveArc.reset() method
+
+> This API is provided as a beta preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
+
+Reset the async primitive to the current canvas state
+
+## Signature
+
+```typescript
+function reset(): Promise<IPCB_PrimitiveArc>;
+```
+
+## Returns
+
+Promise&lt;[IPCB\_PrimitiveArc](./IPCB_PrimitiveArc.md)<!-- -->&gt;
+
+Arc line primitive object
+
+## Example
+
+```javascript
+// 1. 生成本次运行专用的坐标，避免与之前保留的测试圆弧重合
+const x = 46000 + (Math.floor(Math.random() * 100000));
+const y = 2000 + (Math.floor(Math.random() * 100000));
+
+// 2. 创建一段 10mil 线宽的测试圆弧
+const arc = await eda.pcb_PrimitiveArc.create('', 1, x, y, x + 500, y + 300, 90, 10, 1, false);
+
+// 3. 切换异步模式，累计一处未提交的线宽修改（10 → 99）
+const asyncArc = arc.toAsync();
+asyncArc.setState_LineWidth(99);
+
+// 4. 重置：丢弃未提交的修改，回到画布当前状态
+await asyncArc.reset();
+
+// 5. 从画布重新读取，线宽仍是 10（保留现场供观察）
+const refetched = await eda.pcb_PrimitiveArc.get(arc.getState_PrimitiveId());
+
+console.log('lineWidth after reset:', refetched.getState_LineWidth());
+```
+
+### setstate_arcangle
+
+# IPCB\_PrimitiveArc.setState\_ArcAngle() method
+
+> This API is provided as a beta preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
+
+Set the property state: arc angle
+
+## Signature
+
+```typescript
+function setState_ArcAngle(arcAngle: number): IPCB_PrimitiveArc;
+```
+
+## Parameters
+
+<table><thead><tr><th>
+
+Parameter
+
+</th><th>
+
+Type
+
+</th><th>
+
+Description
+
+</th></tr></thead>
+<tbody><tr><td>
+
+arcAngle
+
+</td><td>
+
+number
+
+</td><td>
+
+Arc angle
+
+</td></tr>
+</tbody></table>
+
+## Returns
+
+[IPCB\_PrimitiveArc](./IPCB_PrimitiveArc.md)
+
+Arc line primitive object
+
+## Example
+
+```javascript
+// 1. 生成本次运行专用的坐标，避免与之前保留的测试圆弧重合
+const x = 2000 + (Math.floor(Math.random() * 100000));
+const y = 2000 + (Math.floor(Math.random() * 100000));
+
+// 2. 创建一段 90° 测试圆弧（PCB 坐标单位 mil，跨度 500×300）
+const arc = await eda.pcb_PrimitiveArc.create('', 1, x, y, x + 500, y + 300, 90, 10, 1, false);
+
+// 3. 读取修改前的角度
+const before = arc.getState_ArcAngle();
+
+// 4. 切换异步模式并修改角度（90° → 45°）
+const asyncArc = arc.toAsync();
+asyncArc.setState_ArcAngle(45);
+await asyncArc.done();
+
+// 5. 从画布重新读取，确认修改已生效（保留现场供观察）
+const refetched = await eda.pcb_PrimitiveArc.get(arc.getState_PrimitiveId());
+const after = refetched.getState_ArcAngle();
+
+console.log('arcAngle:', before, '→', after);
+```
+
+### setstate_endx
+
+# IPCB\_PrimitiveArc.setState\_EndX() method
+
+> This API is provided as a beta preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
+
+Set the property state: end position X
+
+## Signature
+
+```typescript
+function setState_EndX(endX: number): IPCB_PrimitiveArc;
+```
+
+## Parameters
+
+<table><thead><tr><th>
+
+Parameter
+
+</th><th>
+
+Type
+
+</th><th>
+
+Description
+
+</th></tr></thead>
+<tbody><tr><td>
+
+endX
+
+</td><td>
+
+number
+
+</td><td>
+
+End position X
+
+</td></tr>
+</tbody></table>
+
+## Returns
+
+[IPCB\_PrimitiveArc](./IPCB_PrimitiveArc.md)
+
+Arc line primitive object
+
+## Example
+
+```javascript
+// 1. 生成本次运行专用的坐标，避免与之前保留的测试圆弧重合
+const x = 14000 + (Math.floor(Math.random() * 100000));
+const y = 2000 + (Math.floor(Math.random() * 100000));
+
+// 2. 创建一段测试圆弧，终点 (x+500, y+300)
+const arc = await eda.pcb_PrimitiveArc.create('', 1, x, y, x + 500, y + 300, 90, 10, 1, false);
+
+// 3. 读取修改前的终点 X
+const before = arc.getState_EndX();
+
+// 4. 切换异步模式并平移终点 X（右移 300mil）
+const asyncArc = arc.toAsync();
+asyncArc.setState_EndX(x + 800);
+await asyncArc.done();
+
+// 5. 从画布重新读取，确认修改已生效（保留现场供观察）
+const refetched = await eda.pcb_PrimitiveArc.get(arc.getState_PrimitiveId());
+const after = refetched.getState_EndX();
+
+console.log('endX:', before, '→', after);
+```
+
+### setstate_endy
+
+# IPCB\_PrimitiveArc.setState\_EndY() method
+
+> This API is provided as a beta preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
+
+Set the property state: end position Y
+
+## Signature
+
+```typescript
+function setState_EndY(endY: number): IPCB_PrimitiveArc;
+```
+
+## Parameters
+
+<table><thead><tr><th>
+
+Parameter
+
+</th><th>
+
+Type
+
+</th><th>
+
+Description
+
+</th></tr></thead>
+<tbody><tr><td>
+
+endY
+
+</td><td>
+
+number
+
+</td><td>
+
+End position Y
+
+</td></tr>
+</tbody></table>
+
+## Returns
+
+[IPCB\_PrimitiveArc](./IPCB_PrimitiveArc.md)
+
+Arc line primitive object
+
+## Example
+
+```javascript
+// 1. 生成本次运行专用的坐标，避免与之前保留的测试圆弧重合
+const x = 18000 + (Math.floor(Math.random() * 100000));
+const y = 2000 + (Math.floor(Math.random() * 100000));
+
+// 2. 创建一段测试圆弧，终点 (x+500, y+300)
+const arc = await eda.pcb_PrimitiveArc.create('', 1, x, y, x + 500, y + 300, 90, 10, 1, false);
+
+// 3. 读取修改前的终点 Y
+const before = arc.getState_EndY();
+
+// 4. 切换异步模式并平移终点 Y（上移 300mil）
+const asyncArc = arc.toAsync();
+asyncArc.setState_EndY(y + 600);
+await asyncArc.done();
+
+// 5. 从画布重新读取，确认修改已生效（保留现场供观察）
+const refetched = await eda.pcb_PrimitiveArc.get(arc.getState_PrimitiveId());
+const after = refetched.getState_EndY();
+
+console.log('endY:', before, '→', after);
+```
+
+### setstate_interactivemode
+
+# IPCB\_PrimitiveArc.setState\_InteractiveMode() method
+
+> This API is provided as a beta preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
+
+Set the property state: interaction mode
+
+## Signature
+
+```typescript
+function setState_InteractiveMode(
+	interactiveMode: EPCB_PrimitiveArcInteractiveMode,
+): IPCB_PrimitiveArc;
+```
+
+## Parameters
+
+<table><thead><tr><th>
+
+Parameter
+
+</th><th>
+
+Type
+
+</th><th>
+
+Description
+
+</th></tr></thead>
+<tbody><tr><td>
+
+interactiveMode
+
+</td><td>
+
+[EPCB\_PrimitiveArcInteractiveMode](../enums/EPCB_PrimitiveArcInteractiveMode.md)
+
+</td><td>
+
+Interaction mode
+
+</td></tr>
+</tbody></table>
+
+## Returns
+
+[IPCB\_PrimitiveArc](./IPCB_PrimitiveArc.md)
+
+Arc line primitive object
+
+## Example
+
+```javascript
+// 1. 生成本次运行专用的坐标，避免与之前保留的测试圆弧重合
+const x = 38000 + (Math.floor(Math.random() * 100000));
+const y = 2000 + (Math.floor(Math.random() * 100000));
+
+// 2. 创建一段两点圆弧（交互模式 1）测试圆弧
+const arc = await eda.pcb_PrimitiveArc.create('', 1, x, y, x + 500, y + 300, 90, 10, 1, false);
+
+// 3. 读取修改前的交互模式
+const before = arc.getState_InteractiveMode();
+
+// 4. 切换异步模式并改为中心圆弧（1 → 2）
+const asyncArc = arc.toAsync();
+asyncArc.setState_InteractiveMode(2);
+await asyncArc.done();
+
+// 5. 从画布重新读取，确认修改已生效（保留现场供观察）
+const refetched = await eda.pcb_PrimitiveArc.get(arc.getState_PrimitiveId());
+const after = refetched.getState_InteractiveMode();
+
+console.log('interactiveMode:', before, '→', after);
+```
+
+### setstate_layer
+
+# IPCB\_PrimitiveArc.setState\_Layer() method
+
+> This API is provided as a beta preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
+
+Set the property state: Layer
+
+## Signature
+
+```typescript
+function setState_Layer(layer: TPCB_LayersOfLine): IPCB_PrimitiveArc;
+```
+
+## Parameters
+
+<table><thead><tr><th>
+
+Parameter
+
+</th><th>
+
+Type
+
+</th><th>
+
+Description
+
+</th></tr></thead>
+<tbody><tr><td>
+
+layer
+
+</td><td>
+
+[TPCB\_LayersOfLine](../types/TPCB_LayersOfLine.md)
+
+</td><td>
+
+Layer
+
+</td></tr>
+</tbody></table>
+
+## Returns
+
+[IPCB\_PrimitiveArc](./IPCB_PrimitiveArc.md)
+
+Arc line primitive object
+
+## Example
+
+```javascript
+// 1. 生成本次运行专用的坐标，避免与之前保留的测试圆弧重合
+const x = 22000 + (Math.floor(Math.random() * 100000));
+const y = 2000 + (Math.floor(Math.random() * 100000));
+
+// 2. 创建一段顶层（1）测试圆弧
+const arc = await eda.pcb_PrimitiveArc.create('', 1, x, y, x + 500, y + 300, 90, 10, 1, false);
+
+// 3. 读取修改前的层
+const before = arc.getState_Layer();
+
+// 4. 切换异步模式并换层（顶层 1 → 底层 2）
+const asyncArc = arc.toAsync();
+asyncArc.setState_Layer(2);
+await asyncArc.done();
+
+// 5. 从画布重新读取，确认修改已生效（保留现场供观察）
+const refetched = await eda.pcb_PrimitiveArc.get(arc.getState_PrimitiveId());
+const after = refetched.getState_Layer();
+
+console.log('layer:', before, '→', after);
+```
+
+### setstate_linewidth
+
+# IPCB\_PrimitiveArc.setState\_LineWidth() method
+
+> This API is provided as a beta preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
+
+Set the property state: Line width
+
+## Signature
+
+```typescript
+function setState_LineWidth(lineWidth: number): IPCB_PrimitiveArc;
+```
+
+## Parameters
+
+<table><thead><tr><th>
+
+Parameter
+
+</th><th>
+
+Type
+
+</th><th>
+
+Description
+
+</th></tr></thead>
+<tbody><tr><td>
+
+lineWidth
+
+</td><td>
+
+number
+
+</td><td>
+
+Line width
+
+</td></tr>
+</tbody></table>
+
+## Returns
+
+[IPCB\_PrimitiveArc](./IPCB_PrimitiveArc.md)
+
+Arc line primitive object
+
+## Example
+
+```javascript
+// 1. 生成本次运行专用的坐标，避免与之前保留的测试圆弧重合
+const x = 26000 + (Math.floor(Math.random() * 100000));
+const y = 2000 + (Math.floor(Math.random() * 100000));
+
+// 2. 创建一段 10mil 线宽的测试圆弧
+const arc = await eda.pcb_PrimitiveArc.create('', 1, x, y, x + 500, y + 300, 90, 10, 1, false);
+
+// 3. 读取修改前的线宽
+const before = arc.getState_LineWidth();
+
+// 4. 切换异步模式并加宽（10 → 24）
+const asyncArc = arc.toAsync();
+asyncArc.setState_LineWidth(24);
+await asyncArc.done();
+
+// 5. 从画布重新读取，确认修改已生效（保留现场供观察）
+const refetched = await eda.pcb_PrimitiveArc.get(arc.getState_PrimitiveId());
+const after = refetched.getState_LineWidth();
+
+console.log('lineWidth:', before, '→', after);
+```
+
+### setstate_net
+
+# IPCB\_PrimitiveArc.setState\_Net() method
+
+> This API is provided as a beta preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
+
+Set the property state: net name
+
+## Signature
+
+```typescript
+function setState_Net(net: string): IPCB_PrimitiveArc;
+```
+
+## Parameters
+
+<table><thead><tr><th>
+
+Parameter
+
+</th><th>
+
+Type
+
+</th><th>
+
+Description
+
+</th></tr></thead>
+<tbody><tr><td>
+
+net
+
+</td><td>
+
+string
+
+</td><td>
+
+Net name
+
+</td></tr>
+</tbody></table>
+
+## Returns
+
+[IPCB\_PrimitiveArc](./IPCB_PrimitiveArc.md)
+
+Arc line primitive object
+
+## Example
+
+```javascript
+// 1. 生成本次运行专用的坐标，避免与之前保留的测试圆弧重合
+const x = 30000 + (Math.floor(Math.random() * 100000));
+const y = 2000 + (Math.floor(Math.random() * 100000));
+
+// 2. 创建一段无网络的测试圆弧
+const arc = await eda.pcb_PrimitiveArc.create('', 1, x, y, x + 500, y + 300, 90, 10, 1, false);
+
+// 3. 读取修改前的网络名称
+const before = arc.getState_Net();
+
+// 4. 切换异步模式并指定网络（'' → '嘉立创示例_NET'）
+const asyncArc = arc.toAsync();
+asyncArc.setState_Net('嘉立创示例_NET');
+await asyncArc.done();
+
+// 5. 从画布重新读取，确认修改已生效（保留现场供观察）
+const refetched = await eda.pcb_PrimitiveArc.get(arc.getState_PrimitiveId());
+const after = refetched.getState_Net();
+
+console.log('net:', before, '→', after);
+```
+
+### setstate_primitivelock
+
+# IPCB\_PrimitiveArc.setState\_PrimitiveLock() method
+
+> This API is provided as a beta preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
+
+Set the property state: whether it is locked
+
+## Signature
+
+```typescript
+function setState_PrimitiveLock(primitiveLock: boolean): IPCB_PrimitiveArc;
+```
+
+## Parameters
+
+<table><thead><tr><th>
+
+Parameter
+
+</th><th>
+
+Type
+
+</th><th>
+
+Description
+
+</th></tr></thead>
+<tbody><tr><td>
+
+primitiveLock
+
+</td><td>
+
+boolean
+
+</td><td>
+
+Whether it is locked
+
+</td></tr>
+</tbody></table>
+
+## Returns
+
+[IPCB\_PrimitiveArc](./IPCB_PrimitiveArc.md)
+
+Arc line primitive object
+
+## Example
+
+```javascript
+// 1. 生成本次运行专用的坐标，避免与之前保留的测试圆弧重合
+const x = 34000 + (Math.floor(Math.random() * 100000));
+const y = 2000 + (Math.floor(Math.random() * 100000));
+
+// 2. 创建一段测试圆弧（默认不锁定）
+const arc = await eda.pcb_PrimitiveArc.create('', 1, x, y, x + 500, y + 300, 90, 10, 1, false);
+
+// 3. 读取修改前的锁定状态
+const before = arc.getState_PrimitiveLock();
+
+// 4. 切换异步模式并锁定（false → true）
+const asyncArc = arc.toAsync();
+asyncArc.setState_PrimitiveLock(true);
+await asyncArc.done();
+
+// 5. 从画布重新读取，确认修改已生效（保留现场供观察）
+const refetched = await eda.pcb_PrimitiveArc.get(arc.getState_PrimitiveId());
+const after = refetched.getState_PrimitiveLock();
+
+console.log('locked:', before, '→', after);
+```
+
+### setstate_startx
+
+# IPCB\_PrimitiveArc.setState\_StartX() method
+
+> This API is provided as a beta preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
+
+Set the property state: start position X
+
+## Signature
+
+```typescript
+function setState_StartX(startX: number): IPCB_PrimitiveArc;
+```
+
+## Parameters
+
+<table><thead><tr><th>
+
+Parameter
+
+</th><th>
+
+Type
+
+</th><th>
+
+Description
+
+</th></tr></thead>
+<tbody><tr><td>
+
+startX
+
+</td><td>
+
+number
+
+</td><td>
+
+Start position X
+
+</td></tr>
+</tbody></table>
+
+## Returns
+
+[IPCB\_PrimitiveArc](./IPCB_PrimitiveArc.md)
+
+Arc line primitive object
+
+## Example
+
+```javascript
+// 1. 生成本次运行专用的坐标，避免与之前保留的测试圆弧重合
+const x = 6000 + (Math.floor(Math.random() * 100000));
+const y = 2000 + (Math.floor(Math.random() * 100000));
+
+// 2. 创建一段测试圆弧，起点 (x, y)
+const arc = await eda.pcb_PrimitiveArc.create('', 1, x, y, x + 500, y + 300, 90, 10, 1, false);
+
+// 3. 读取修改前的起点 X
+const before = arc.getState_StartX();
+
+// 4. 切换异步模式并平移起点 X（右移 300mil）
+const asyncArc = arc.toAsync();
+asyncArc.setState_StartX(x + 300);
+await asyncArc.done();
+
+// 5. 从画布重新读取，确认修改已生效（保留现场供观察）
+const refetched = await eda.pcb_PrimitiveArc.get(arc.getState_PrimitiveId());
+const after = refetched.getState_StartX();
+
+console.log('startX:', before, '→', after);
+```
+
+### setstate_starty
+
+# IPCB\_PrimitiveArc.setState\_StartY() method
+
+> This API is provided as a beta preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
+
+Set the property state: start position Y
+
+## Signature
+
+```typescript
+function setState_StartY(startY: number): IPCB_PrimitiveArc;
+```
+
+## Parameters
+
+<table><thead><tr><th>
+
+Parameter
+
+</th><th>
+
+Type
+
+</th><th>
+
+Description
+
+</th></tr></thead>
+<tbody><tr><td>
+
+startY
+
+</td><td>
+
+number
+
+</td><td>
+
+Start position Y
+
+</td></tr>
+</tbody></table>
+
+## Returns
+
+[IPCB\_PrimitiveArc](./IPCB_PrimitiveArc.md)
+
+Arc line primitive object
+
+## Example
+
+```javascript
+// 1. 生成本次运行专用的坐标，避免与之前保留的测试圆弧重合
+const x = 10000 + (Math.floor(Math.random() * 100000));
+const y = 2000 + (Math.floor(Math.random() * 100000));
+
+// 2. 创建一段测试圆弧，起点 (x, y)
+const arc = await eda.pcb_PrimitiveArc.create('', 1, x, y, x + 500, y + 300, 90, 10, 1, false);
+
+// 3. 读取修改前的起点 Y
+const before = arc.getState_StartY();
+
+// 4. 切换异步模式并平移起点 Y（上移 300mil）
+const asyncArc = arc.toAsync();
+asyncArc.setState_StartY(y + 300);
+await asyncArc.done();
+
+// 5. 从画布重新读取，确认修改已生效（保留现场供观察）
+const refetched = await eda.pcb_PrimitiveArc.get(arc.getState_PrimitiveId());
+const after = refetched.getState_StartY();
+
+console.log('startY:', before, '→', after);
+```
+
+### toasync
+
+# IPCB\_PrimitiveArc.toAsync() method
+
+Convert Primitive to Async primitive
+
+## Signature
+
+```typescript
+function toAsync(): IPCB_PrimitiveArc;
+```
+
+## Returns
+
+[IPCB\_PrimitiveArc](./IPCB_PrimitiveArc.md)
+
+Arc line primitive object
+
+## Example
+
+```javascript
+// 1. 生成本次运行专用的坐标，避免与之前保留的测试圆弧重合
+const x = 52000 + (Math.floor(Math.random() * 100000));
+const y = 2000 + (Math.floor(Math.random() * 100000));
+
+// 2. 创建一段测试圆弧，切换到同步模式，让模式变化可观察
+const arc = await eda.pcb_PrimitiveArc.create('', 1, x, y, x + 500, y + 300, 90, 10, 1, false);
+arc.toSync();
+
+// 3. 转换为异步图元
+const asyncArc = arc.toAsync();
+
+// 4. 异步模式下累计修改并提交
+asyncArc.setState_LineWidth(24);
+await asyncArc.done();
+
+// 5. 从画布重新读取，确认提交生效（保留现场供观察）
+const refetched = await eda.pcb_PrimitiveArc.get(arc.getState_PrimitiveId());
+
+console.log('isAsync after toAsync:', arc.isAsync());
+console.log('lineWidth:', 10, '→', refetched.getState_LineWidth());
+```
+
+### tosync
+
+# IPCB\_PrimitiveArc.toSync() method
+
+Convert Primitive to Sync primitive
+
+## Signature
+
+```typescript
+function toSync(): IPCB_PrimitiveArc;
+```
+
+## Returns
+
+[IPCB\_PrimitiveArc](./IPCB_PrimitiveArc.md)
+
+Arc line primitive object
+
+## Example
+
+```javascript
+// 1. 生成本次运行专用的坐标，避免与之前保留的测试圆弧重合
+const x = 56000 + (Math.floor(Math.random() * 100000));
+const y = 2000 + (Math.floor(Math.random() * 100000));
+
+// 2. 创建一段测试圆弧
+const arc = await eda.pcb_PrimitiveArc.create('', 1, x, y, x + 500, y + 300, 90, 10, 1, false);
+
+// 3. 转换为同步图元
+const syncArc = arc.toSync();
+
+// 4. 同步模式下修改线宽，立即生效（无需 done()）
+syncArc.setState_LineWidth(40);
+
+// 5. 从画布重新读取，确认修改已生效（保留现场供观察）
+const refetched = await eda.pcb_PrimitiveArc.get(arc.getState_PrimitiveId());
+
+console.log('isSync after toSync:', !syncArc.isAsync());
+console.log('lineWidth:', 10, '→', refetched.getState_LineWidth());
+```