Home > PCB_PrimitiveString > create

PCB_PrimitiveString.create() method

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

创建文本

签名

function create(
	layer: TPCB_LayersOfImage,
	x: number,
	y: number,
	text: string,
	fontFamily: string,
	fontSize: number,
	lineWidth: number,
	alignMode: EPCB_PrimitiveStringAlignMode,
	rotation: number,
	reverse: boolean,
	expansion: number,
	mirror: boolean,
	primitiveLock: boolean,
): Promise<IPCB_PrimitiveString | undefined>;

参数名

参数	类型	描述
layer	TPCB_LayersOfImage	层
x	number	坐标 X
y	number	坐标 Y
text	string	文本内容
fontFamily	string	字体，需要预先导入嘉立创 EDA
fontSize	number	字号
lineWidth	number	线宽
alignMode	EPCB_PrimitiveStringAlignMode	对齐模式
rotation	number	旋转角度
reverse	boolean	是否反相
expansion	number	反相扩展
mirror	boolean	是否镜像
primitiveLock	boolean	是否锁定

返回值

Promise<IPCB_PrimitiveString | undefined>

文本图元对象

示例

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

// 2. 在顶层丝印层（3）创建文本：默认字体、字号 45、线宽 6、左下对齐（3）、不旋转、不反相、不镜像、不锁定
const text = await eda.pcb_PrimitiveString.create(3, x, y, '嘉立创示例_版本V1.0', 'default', 45, 6, 3, 0, false, 0, false, false);

// 3. 创建类保留现场，不删除图元
console.log('primitiveId:', text.getState_PrimitiveId());
console.log('primitiveType:', text.getState_PrimitiveType());
console.log('layer:', text.getState_Layer());
console.log('text:', text.getState_Text());
console.log('fontSize:', text.getState_FontSize());