Home > PCB_Primitive > getPrimitivesBBox

PCB_Primitive.getPrimitivesBBox() method

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

获取图元的 BBox

签名

function getPrimitivesBBox(
	primitiveIds: Array<string | IPCB_Primitive>,
): Promise<{ minX: number; minY: number; maxX: number; maxY: number } | undefined>;

参数名

参数	类型	描述
primitiveIds	Array<string | IPCB_Primitive>	图元 ID 数组或图元对象数组

返回值

Promise<{ minX: number; minY: number; maxX: number; maxY: number } | undefined>

图元的 BBox，如若图元不存在或没有 BBox，将会返回 undefined 的结果

示例

// 1. 创建两个顶层测试焊盘：一个 80x80 放在（2000,2000），一个 60x60 放在（3000,3000）
const pad1 = await eda.pcb_PrimitivePad.create(1, '1', 2000, 2000, 0, ['ELLIPSE', 80, 80], '', null, 0, 0, 0, false, 0);
const pad2 = await eda.pcb_PrimitivePad.create(1, '2', 3000, 3000, 0, ['ELLIPSE', 60, 60], '', null, 0, 0, 0, false, 0);

// 2. 计算两个焊盘整体的 BBox（传图元 ID 数组，也支持直接传图元对象数组）
const bbox = await eda.pcb_Primitive.getPrimitivesBBox([pad1.getState_PrimitiveId(), pad2.getState_PrimitiveId()]);

// 3. 清理测试图元（查询类需要清理）
await eda.pcb_PrimitivePad.delete([pad1.getState_PrimitiveId(), pad2.getState_PrimitiveId()]);

console.log('minX:', bbox.minX);
console.log('minY:', bbox.minY);
console.log('maxX:', bbox.maxX);
console.log('maxY:', bbox.maxY);