Home > PCB_Document > setCanvasOrigin

PCB_Document.setCanvasOrigin() method

设置画布原点相对于数据原点的偏移坐标

签名

function setCanvasOrigin(offsetX: number, offsetY: number): Promise<boolean>;

参数名

参数	类型	描述
offsetX	number	画布原点相对于数据原点的 X 坐标偏移
offsetY	number	画布原点相对于数据原点的 Y 坐标偏移

返回值

Promise<boolean>

操作是否成功

备注

嘉立创 EDA 专业版前端显示的坐标均为画布原点；

嘉立创 EDA 专业版 API 使用的均为数据原点；

如果希望在 API 操作时前端画布坐标能与数据一致， 建议调用本方法并设置偏移量为零， 即 setCanvasOrigin(0, 0)；

此处的单位为数据层面单位，在跨度上等同于画布层面的 mil

示例

// 1. 创建测试 PCB 并打开（原点设置作用于当前激活的 PCB）
const pcbUuid = await eda.dmt_Pcb.createPcb();
await new Promise(r => setTimeout(r, 1500));
await eda.dmt_EditorControl.openDocument(pcbUuid);
await new Promise(r => setTimeout(r, 1000));

// 2. 设置画布原点偏移为 (50, 100)
const set = await eda.pcb_Document.setCanvasOrigin(50, 100);
console.log('set:', set);

// 3. 读回偏移验证已生效
const origin = await eda.pcb_Document.getCanvasOrigin();
console.log('origin:', JSON.stringify(origin));

// 4. 清理测试 PCB（偏移随文档一起删除）
await eda.dmt_Pcb.deletePcb(pcbUuid);