Home > SCH_PrimitiveBus > create

SCH_PrimitiveBus.create() 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.

Create a bus

Signature

function create(
	busName: string,
	line: Array<number> | Array<Array<number>>,
	color?: string | null,
	lineWidth?: number | null,
	lineType?: ESCH_PrimitiveLineType | null,
): Promise<ISCH_PrimitiveBus | undefined>;

Parameters

Parameter	Type	Description
busName	string	Bus name
line	Array<number> | Array<Array<number>>	Polyline coordinate group. Each segment is a continuous line described by [x1, y1, x2, y2, x3, y3]. If the polylines have no connection to each other, the creation will fail. Examples for the type Array<Array<number>>: 1. [[], [0, 0, 0, 1]] - segment 1 has no path, invalid; 2. [[1], [0, 0, 0, 1]] - segment 1 only has x, missing y, invalid; 3. [[0, 0, -1, 0], [0, 0, 1, 1]] - segment 1 is a horizontal line but segment 2 is a diagonal line, invalid; 4. [[0, 0, -1, 0, -1, 1], [0, 1, 1, 1]] - the two segments have no connection, invalid; 5. [[1, 1], [1, 2, 2, 2]] - segment 1 has only one point, ignored; segment 2 is a horizontal segment, and the final path keeps only segment 2, valid; 6. [[1, 1], [1, 2]] - segment 1 has only one point, ignored; segment 2 is also ignored, and the final path is empty, invalid
color	string | null	(Optional) Bus color. null indicates the default
lineWidth	number | null	(Optional) Line width, range 1-10. null indicates the default
lineType	ESCH_PrimitiveLineType | null	(Optional) Line type. null indicates the default

Returns

Promise<ISCH_PrimitiveBus | undefined>

Bus primitive object

Example

// 1. 生成随机起点坐标，避免与画布上已有的总线重合（SCH 坐标单位 10mil）
const x = 2000 + Math.floor(Math.random() * 8000);
const y = 2000 + Math.floor(Math.random() * 8000);

// 2. 创建一条两段相连的 L 形总线：先向右再向上，段与段必须首尾相连且各自水平或垂直
const bus = await eda.sch_PrimitiveBus.create(
	'DATA[0..7]',
	[[x, y, x + 400, y], [x + 400, y, x + 400, y + 200]],
	'#FF0000', // 总线颜色
	6, // 线宽（范围 1-10）
	1 // 线型：1 = DASHED（虚线）
);

// 3. 创建类保留现场，不删除图元
console.log('primitiveId:', bus.getState_PrimitiveId());
console.log('primitiveType:', bus.getState_PrimitiveType());
console.log('busName:', bus.getState_BusName());
console.log('color:', bus.getState_Color());
console.log('lineWidth:', bus.getState_LineWidth());