Home > IPCB_PrimitivePour > convertToRegion

IPCB_PrimitivePour.convertToRegion() 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.

Convert to: region primitive (default is the forbidden region)

Signature

function convertToRegion(): Promise<IPCB_PrimitiveRegion>;

Returns

Promise<IPCB_PrimitiveRegion>

Region primitive object

Example

// 1. 生成本次运行专用的坐标，避免与之前保留的测试图元重合
const x = 2000 + Math.floor(Math.random() * 100000);
const y = 2000 + Math.floor(Math.random() * 100000);

// 2. 创建一个实心覆铜边框
const polygon = eda.pcb_MathPolygon.createPolygon(['R', x, y, 500, 300, 0, 0]);
const pour = await eda.pcb_PrimitivePour.create('', 1, polygon, 'solid', false, '嘉立创示例_转区域', 5, 10, false);

// 3. 转换为区域图元（默认是禁止区域，原覆铜边框被替换，区域保留现场供观察）
const region = await pour.convertToRegion();

console.log('primitiveType:', `${pour.getState_PrimitiveType()} → ${region.getState_PrimitiveType()}`);
console.log('primitiveId:', region.getState_PrimitiveId());