Home > PCB_PrimitiveObject > create

PCB_PrimitiveObject.create() method

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

创建二进制内嵌对象

签名

function create(
	layer: TPCB_LayersOfObject,
	topLeftX: number,
	topLeftY: number,
	binaryData: string,
	width: number,
	height: number,
	rotation?: number,
	mirror?: boolean,
	fileName?: string,
	primitiveLock?: boolean,
): Promise<IPCB_PrimitiveObject | undefined>;

参数名

参数	类型	描述
layer	TPCB_LayersOfObject	层
topLeftX	number	左上点 X
topLeftY	number	左上点 Y
binaryData	string	二进制数据
width	number	宽
height	number	高
rotation	number	（可选） 旋转角度
mirror	boolean	（可选） 是否水平镜像
fileName	string	（可选） 文件名
primitiveLock	boolean	（可选） 是否锁定

返回值

Promise<IPCB_PrimitiveObject | undefined>

• 二进制内嵌对象图元对象

示例

// 1. 生成随机放置坐标，避免与画布上已有的内嵌对象重合
const x = 2000 + Math.floor(Math.random() * 100000);
const y = 2000 + Math.floor(Math.random() * 100000);

// 2. 准备 4x4 像素 PNG 的 data URI（binaryData 必须是 data URI 格式，裸 base64 会创建失败）
const binaryData = 'data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAQAAAAECAIAAAAmkwkpAAAAEElEQVR4nGP4z8AARwzEcQCukw/x0F8jngAAAABJRU5ErkJggg==';

// 3. 在顶层丝印（3）放置图片：左上角（x, y），宽 400、高 300，不旋转、不镜像、不锁定
const obj = await eda.pcb_PrimitiveObject.create(3, x, y, binaryData, 400, 300, 0, false, 'logo.png', false);

// 4. 创建类保留现场，不删除图元（getState_BinaryData 返回数据 hash，用长度表示）
console.log('primitiveId:', obj.getState_PrimitiveId());
console.log('primitiveType:', obj.getState_PrimitiveType());
console.log('layer:', obj.getState_Layer());
console.log('width:', obj.getState_Width(), 'height:', obj.getState_Height());
console.log('fileName:', obj.getState_FileName());
console.log('binaryData hash length:', obj.getState_BinaryData().length);