Composer 不处理 BOM 序号引线对齐,需在 PCB 工具导出时包含 X/Y/ROTATION 字段并完成单位校准、原点对齐与 Y 轴翻转,再通过预处理将坐标映射为 PDF 页面坐标(pt),模板中仅调用已计算好的 PAGE_X/PAGE_Y 绘制引线。

Composer 本身不处理 BOM 序号引线对齐——这是 PCB 设计工具(如 Allegro、PCB Editor)的职责,Composer 只负责生成和排版已有的结构化数据。所谓“用空间坐标对齐”,实际是把 PCB 工具导出的 placement 或 silkscreen 坐标信息,映射到 Composer 的 PDF/SVG 输出中,再通过自定义脚本或模板逻辑调整引线位置。
为什么直接在 Composer 里读取坐标行不通
Composer 的变量绑定机制($BOM_ITEM.REFDES、$BOM_ITEM.X 等)只支持从输入数据源(如 CSV、ODB++、IPC-2581)带入的字段,它不解析 Gerber/IPC-2581 中的图形坐标,也不提供画布级坐标运算能力。如果你的 BOM CSV 里没有 X 和 Y 列,Composer 就根本看不到任何空间信息。
常见错误现象:Undefined variable: $BOM_ITEM.X 报错,或引线全部堆在左上角不动。
- 确保导出 BOM 数据时,从 PCB 工具中显式勾选「Export coordinates」或「Include placement origin」
- 检查输出 CSV 是否真包含
X、Y、ROTATION字段,且单位统一(推荐 mm,非 mil) - 若用 ODB++,确认
.cmp层或components表中已启用centroid_x/centroid_y字段映射
怎么让引线末端贴到元件中心点
Composer 支持在模板中用 <svg></svg> 或 <image></image> 元素叠加矢量图形,引线本质就是一条 <line></line>。关键在于把 $BOM_ITEM.X 和 $BOM_ITEM.Y 转换成 PDF 页面坐标系(原点在左下角,单位为点 pt)。
假设你的 PCB 板框尺寸是 150mm × 100mm,PDF 缩放比例设为 1mm = 2.8346pt(即 72dpi 下的换算),那么:
使用 circleci/circleci-cli 和 circleci/orb-tools-orb SDK 来组合和验证 CircleCI Orbs。自动化 orb 打包、使用 conventional-changelog 进行语义化版本控制,并发布到 CircleCI Orb Registry。
<line x1="{$BOM_ITEM.PAGE_X}" y1="{$BOM_ITEM.PAGE_Y}"
x2="{$BOM_ITEM.PAGE_X + 20}" y2="{$BOM_ITEM.PAGE_Y + 20}"
stroke="#000" stroke-width="0.5"/>
其中 PAGE_X 和 PAGE_Y 需在数据预处理阶段计算好(例如 Python 脚本里做: page_x = (x_mm + offset_x) * 2.8346),不能靠 Composer 运行时算。
- 别在 Composer 模板里写
{$BOM_ITEM.X * 2.8346}—— 它不支持四则运算 - Y 轴要翻转:
page_y = (board_height_mm - y_mm + offset_y) * 2.8346 - 引线长度建议固定(如 15–25pt),避免长引线交叉;旋转角度可用
$BOM_ITEM.ROTATION控制<line transform="rotate(...)"></line>
Allegro 用户特别注意:.csv 坐标默认是相对原点还是板边?
Allegro 导出 Placement CSV 时,默认坐标系原点在「Design Origin」,不是板子左下角。如果没手动设置过 Design Origin,它很可能在板外,导致所有 X/Y 是负值或极大正数。
错误表现:引线全飞出 PDF 页面,或集中在某一个角落。
- 导出前,在 Allegro 中执行
Setup → Design Parameters → Design Origin,设为板子左下焊盘参考点 - 或导出后用脚本统一偏移:
x_adj = x_raw - board_left_mm - 检查 Allegro 输出 CSV 的 header 是否含
Units:mm;若为mils,必须先除以 1000 再进 Composer
真正难的不是画那条线,而是确保从 PCB 工具流出的每个坐标数字,在进入 Composer 前已经过单位校准、原点对齐、坐标系翻转三重转换。漏掉任意一环,引线就会“看起来对了”,实则和元件物理位置差几毫米——贴片机可不认 PDF 上的视觉对齐。

















