Home > SCH_PrimitiveBus > create

SCH_PrimitiveBus.create() method

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

创建总线

签名

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

参数名

参数	类型	描述
busName	string	总线名称
line	Array<number> | Array<Array<number>>	多段线坐标组，每段都是连续的一组 [x1, y1, x2, y2, x3, y3] 所描述的线，如若多段线彼此无任何连接则创建将会失败 类型 Array<Array<number>> 的案例说明： 1. [[], [0, 0, 0, 1]]，段 1 没有路径，非法 2. [[1], [0, 0, 0, 1]]，段 1 只有 x、缺少 y，非法 3. [[0, 0, -1, 0], [0, 0, 1, 1]]，段 1 为水平线，但段 2 为斜线，非法 4. [[0, 0, -1, 0, -1, 1], [0, 1, 1, 1]]，两段彼此无连接，非法 5. [[1, 1], [1, 2, 2, 2]]，段 1 只有一个点，忽略此段，段 2 为水平段，最终路径仅保留段 2，合法 6. [[1, 1], [1, 2]]，段 1 只有一个点，忽略此段，段 2 亦忽略，最终路径为空，非法
color	string | null	（可选） 总线颜色，null 表示默认
lineWidth	number | null	（可选） 线宽，范围 1-10，null 表示默认
lineType	ESCH_PrimitiveLineType | null	（可选） 线型，null 表示默认

返回值

Promise<ISCH_PrimitiveBus | undefined>

总线图元对象

示例

// 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());