Easyeda Draw Placement

器件摆放

元器件放置、位号分配、旋转镜像、间距控制的完整指南。

1. 基本放置

const result = await eda.sch_PrimitiveComponent.create(
  { libraryUuid: "库UUID", uuid: "器件UUID" },
  x,           // X 坐标 (0.01inch 单位)
  y,           // Y 坐标
  "",          // 子部件名，单 Part 器件留空 ""
  0,           // 旋转角度: 0, 90, 180, 270
  false,       // 是否镜像
  true,        // 加入 BOM
  true         // 加入 PCB
);
const primitiveId = result?.primitiveId;

⚠️ 坐标注意: (x, y) 是符号原点/锚点，不是器件中心。引脚实际位置由符号定义决定。

2. 位号分配

手动设置

await eda.sch_PrimitiveComponent.modify(primitiveId, {
  designator: "SW1"
});

批量分配

const compIds = await eda.sch_PrimitiveComponent.getAllPrimitiveId();
const designatorMap = {
  "primitiveId1": "SW1",
  "primitiveId2": "SW2",
  "primitiveId3": "D1",
};
for (const [id, des] of Object.entries(designatorMap)) {
  await eda.sch_PrimitiveComponent.modify(id, { designator: des });
}

位号规范

3. 旋转和镜像

放置时旋转

// rotation: 传角度值: 0, 90, 180, 270
// 注意: 传 90 时 API 内部存储为 270，但视觉上旋转 90° 正确
await eda.sch_PrimitiveComponent.create(comp, x, y, "", 90, false, true, true);

放置后旋转

const comps = await eda.sch_PrimitiveComponent.get([primitiveId]);
const comp = comps[0];
const ac = comp.toAsync();
ac.setState_Rotation(90);
ac.done();

镜像

// 放置时镜像
await eda.sch_PrimitiveComponent.create(comp, x, y, "", 0, true, true, true);

// 放置后镜像
const ac = comp.toAsync();
ac.setState_Mirror(true);
ac.done();

⚠️ 如果 API 无法旋转（某些符号不支持），需要人工在 EasyEDA 中手动旋转。

4. 间距控制

实测器件引脚范围

电阻符号实测数据

以 0402WGF3301TCE (0402 3.3K 电阻) 为例：

• 放置坐标 (anchor): (585, 412)
• 实际 anchor: (585, 410) — Y 有 2 单位微小偏差
• 引脚位置: 左 (565, 410), 右 (605, 410)
• 引脚间距: 40 单位 (0.4 inch = 10.16 mm)
• anchor 在引脚中点，引脚水平对称分布

⚠️ 器件 anchor 偏差: 某些符号的放置坐标与实际 anchor 可能有微小偏差（1-2 单位），这是符号内部 origin 定义导致的。放置时以 anchor 为参考即可。

推荐布局区域

A4 图纸约 1170x825 单位（占位符示意，实际坐标由 Zone Plan 决定）

┌─────────────────────────────────────────┐
│  模块 C (接口)        │  主控 / 核心 IC  │
│  (示例坐标)           │  (示例坐标)      │
├─────────────────────────────────────────┤
│  模块 A (核心功能)                       │
│  器件 1 器件 2 器件 3                    │
│  器件 4 器件 5 器件 6                    │
├─────────────────────────────────────────┤
│  模块 B (辅助输入)    │  模块 D (调试)   │
├─────────────────────────────────────────┤
│  信号连接说明                            │
└─────────────────────────────────────────┘

5. 获取器件实际位置

const comps = await eda.sch_PrimitiveComponent.get([primitiveId]);
const c = comps[0];
const pins = await eda.sch_PrimitiveComponent.getAllPinsByPrimitiveId(primitiveId);

// 计算引脚包围盒
let minX = Infinity, maxX = -Infinity, minY = Infinity, maxY = -Infinity;
for (const p of pins) {
  minX = Math.min(minX, p.x);
  maxX = Math.max(maxX, p.x);
  minY = Math.min(minY, p.y);
  maxY = Math.max(maxY, p.y);
}

return {
  designator: c.designator,
  anchor: {x: c.x, y: c.y},           // 放置坐标（原点）
  pinBBox: [minX, minY, maxX, maxY],  // 引脚实际范围
  pinCount: pins.length,
};

6. 移动器件

const comps = await eda.sch_PrimitiveComponent.get([primitiveId]);
const comp = comps[0];
const ac = comp.toAsync();
ac.setState_X(newX);
ac.setState_Y(newY);
ac.done();

7. 删除器件

// 删除单个
await eda.sch_PrimitiveComponent.delete(primitiveId);

// 删除多个
await eda.sch_PrimitiveComponent.delete([id1, id2, id3]);

// 删除所有（保留特定器件）
const compIds = await eda.sch_PrimitiveComponent.getAllPrimitiveId();
const toDelete = compIds.filter(id => id !== "保留的ID");
await eda.sch_PrimitiveComponent.delete(toDelete);

⚠️ 图纸边框和表头保护

图纸边框（Border）和标题块（Title Block）不是通过 sch_PrimitiveComponent 管理的图元， 而是文档级别的属性。使用 delete() 删除元器件不会影响它们。

但是，如果 titleBlockData 被清空，标题块会显示为空白。可通过以下方式恢复：

await eda.dmt_Schematic.modifySchematicPageTitleBlock(true, {
  '@Project Name': {showTitle: true, showValue: true, value: '项目名称'},
  Version: {showTitle: true, showValue: true, value: 'V1.0'},
});

8. 文本标注

await eda.sch_PrimitiveText.create(
  x, y,           // 位置
  "文本内容",      // 内容
  0,              // 旋转角度
  null,           // 颜色
  null,           // 字体
  8,              // 字号 (与坐标同单位)
  false,          // 粗体
  false,          // 斜体
  false,          // 下划线
  0               // 对齐: 0=左, 1=中, 2=右
);

字号参考:

• 功能区域标题: 8-10
• 引脚标注: 5-6
• 注释说明: 4-5

9. 矩形绘制

await eda.sch_PrimitiveRectangle.create(
  topLeftX, topLeftY,   // 左上角
  width, height,        // 宽高
  0,                    // 圆角半径
  0,                    // 旋转角度
  "#000000",            // 边框颜色
  null,                 // 填充颜色
  null,                 // 线宽
  null,                 // 线型
  null                  // 填充样式
);

10. 常见错误