Home > IPCB_PrimitiveVia > getAdjacentPrimitives

IPCB_PrimitiveVia.getAdjacentPrimitives() method

此 API 当前处于 BETA 预览状态，希望得到开发者的反馈。它的任何功能都可能在接下来的开发进程中被修改，请不要将它用于任何正式环境。

获取相邻的图元对象

签名

function getAdjacentPrimitives(): Promise<Array<IPCB_PrimitiveLine | IPCB_PrimitiveArc>>;

返回值

Promise<Array<IPCB_PrimitiveLine | IPCB_PrimitiveArc>>

相邻的导线、圆弧线图元对象

备注

将会获取与过孔直接相连的导线、圆弧线图元对象

示例

// 1. 生成本次运行专用的坐标，放置一个测试过孔
const x = 3000 + Math.floor(Math.random() * 100000);
const via = await eda.pcb_PrimitiveVia.create('', x, 3000, 20, 40);

// 2. 在过孔两侧各拉一条顶层导线，端点落在过孔中心构成连接
const line1 = await eda.pcb_PrimitiveLine.create('', 1, x - 600, 3000, x, 3000, 10);
const line2 = await eda.pcb_PrimitiveLine.create('', 1, x, 3000, x + 600, 3000, 10);

// 3. 获取与过孔直接相连的图元，并读出各自的类型
const adjacent = await via.getAdjacentPrimitives();

// 4. 清理测试图元（查询类案例不留测试对象）
await eda.pcb_PrimitiveVia.delete([via.getState_PrimitiveId()]);
await eda.pcb_PrimitiveLine.delete([line1.getState_PrimitiveId(), line2.getState_PrimitiveId()]);

console.log('adjacent count:', adjacent.length);
adjacent.forEach((p, i) => {
	console.log(`adjacent[${i}] type:`, p.getState_PrimitiveType());
});