Home > IPCB_PrimitivePad > setState_SolderMaskAndPasteMaskExpansion

IPCB_PrimitivePad.setState_SolderMaskAndPasteMaskExpansion() 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: solder mask / paste mask expansion

Signature

function setState_SolderMaskAndPasteMaskExpansion(
	solderMaskAndPasteMaskExpansion: IPCB_PrimitiveSolderMaskAndPasteMaskExpansion | null,
): IPCB_PrimitivePad;

Parameters

Parameter	Type	Description
solderMaskAndPasteMaskExpansion	IPCB_PrimitiveSolderMaskAndPasteMaskExpansion | null	Solder mask / paste mask expansion

Returns

IPCB_PrimitivePad

Pad primitive object

Example

// 1. 生成本次运行专用的坐标，创建一个默认扩展（遵循规则）的贴片焊盘
const x = 3000 + Math.floor(Math.random() * 100000);
const pad = await eda.pcb_PrimitivePad.create(1, '1', x, 3000, 0, ['ELLIPSE', 60, 60], '', null, 0, 0, 0, false, 0);
const before = pad.getState_SolderMaskAndPasteMaskExpansion();

// 2. 异步模式下自定义顶层扩展并提交
const a = pad.toAsync();
a.setState_SolderMaskAndPasteMaskExpansion({ topSolderMask: 4, topPasteMask: 2 });
await a.done();

// 3. 从画布重新读取，确认扩展已生效（未显式设置的项由后端补默认值）
const ref = await eda.pcb_PrimitivePad.get(pad.getState_PrimitiveId());

console.log('expansion:', before, '→', ref.getState_SolderMaskAndPasteMaskExpansion());