简介

在 PCB 设计中，有时我们需要直接在画布上通过线条、焊盘、填充区域等图元“画”出一个封装（例如异形焊盘、特殊连接器或者直接从 DXF 导入的图形）。通常情况下，我们需要将这些图形复制到封装编辑器中才能创建元件，过程繁琐。

本插件实现了所见即所得的封装创建功能。你只需在 PCB 画布上选中绘制好的图形，在菜单栏选择 创建封装，输入一个名称，插件就会自动提取这些图元的几何信息，在指定的库中生成对应的封装 (Footprint)、符号 (Symbol) 和 器件 (Device)，并立即将其作为一个完整的元件放置回当前画布中。

使用方法

准备图形：在 PCB 编辑器中，使用焊盘、线条或填充区域工具绘制出你的封装形状。（默认排除导线、过孔、覆铜和约束区域）
选中对象：框选所有组成该封装的图元。
运行插件：在菜单栏选择 创建封装。
配置参数：
- 封装名称：输入你想创建的封装名称（如 QFP-32）。若留空，会自动生成如 NEW-32Pin_123045 的名称。
- 选择库：在下拉列表中选择要保存到的目标库（通常是你的“个人库”或“工作区库”）。
执行创建：点击 “创建封装” 按钮。
自动完成：
- 脚本会自动计算原点、提取焊盘编号。
- 自动生成对应的原理图符号。
- 删除选中的原始图形，并将新生成的器件吸附到鼠标上等待放置。

8696994631420637184

解决了哪些痛点

异形封装制作难：对于某些不规则的射频天线或触摸按键，直接在 PCB 里画比在封装编辑器里计算坐标要快得多。本工具支持“画完即用”。
DXF 导入转封装：从 CAD 导入的复杂板框或连接器外形，现在可以直接转为封装，无需繁琐的导出导入步骤。
符号与封装同步：传统方式是先画封装，再画符号，再建器件关联。本工具一键生成全套（封装 + 符号 = 器件）

技术要点

源码生成：脚本不依赖繁琐的图形绘制 API，而是直接生成符合 JLCEDA 格式规范的 JSON 源码字符串（包括符号的 BBOX 计算、引脚排列，以及封装的图元坐标转换），通过 updateDocumentSource 接口更新源码。
坐标归一化：自动计算所有选中图元焊盘的几何中心作为封装的原点 (0,0)，确保生成的封装在库中是居中的。
自动符号生成算法：根据焊盘数量，自动生成一个标准的矩形符号。引脚按照编号采用 逆时针 顺序排列，符合大多数芯片的符号规范。
图元类型过滤：精准筛选 Pad（焊盘）、Polyline（多义线/丝印）、Region（填充区域），自动忽略不相关的辅助线，保证封装的纯净。

使用API接口

API接口	描述
`eda.lib_LibrariesList.getAllLibrariesList()`	获取当前用户可用的库列表，用于选择保存位置。
`eda.pcb_SelectControl.getAllSelectedPrimitives()`	获取当前在 PCB 画布上选中的所有图元。
`eda.lib_Footprint.create(...)`	创建一个新的空封装。
`eda.lib_Symbol.create(...)`	创建一个新的空符号。
`eda.lib_Device.create(...)`	创建一个新的器件，并关联上述封装和符号。
`eda.lib_Footprint.updateDocumentSource(...)`	将计算好的几何数据写入封装文件。
`eda.lib_Symbol.updateDocumentSource(...)`	将计算好的引脚数据写入符号文件。
`eda.pcb_PrimitiveComponent.create(...)`	在 PCB 上放置生成好的器件。
`eda.pcb_PrimitiveComponent.delete(...)`	删除放置的器件。
`eda.sch_PrimitiveComponent.create(...)`	放置器件。
`eda.pcb_PrimitivePad.delete(...)`	删除选中焊盘。
`eda.pcb_PrimitivePolyline.delete(...)`	删除选中线条。
`eda.pcb_PrimitivePour.delete(...)`	删除选中多边形。
`eda.sys_IFrame.hideIFrame(...)`	隐藏窗口，待下次使用。

注意事项 v2.2.43

关于 API 缺陷的规避方案由于 EDA 现有 API 存在已知缺陷，本插件采用了一种特殊的“迂回策略”来确保数据完整性

问题表现
- 若仅使用 eda.pcb_PrimitiveComponent.create(...) 放置PCB器件，保存后重新打开，器件会从 PCB 画布消失，但原理图符号正常。
- 若仅使用 eda.sch_PrimitiveComponent.create(...) 放置PCB器件，保存后重新打开，器件不会消失，但原理图符号将出现异常，无法被放置。
解决方案
- 执行时会先调用 eda.pcb_PrimitiveComponent.create(...) 接口创建器件以建立正确的符号索引，随即立即将其删除；
- 紧接着调用 eda.sch_PrimitiveComponent.create(...) 将器件吸附于鼠标光标进行手动放置
结果：此操作既修复了原理图符号不可用的问题，也确保了 PCB 器件在保存后不会丢失。

首次使用可能会弹出 `选中对象中含有元件，是否同时删除?` 勾选 `不再提醒` 后点击 `确认` 即可

常见问题

未找到可用库：新建一个库
目前暂不支持 V3 版本

适用EDA版本

v2.2.43 （更新后可能会出现未知问题）
暂不支持 v3 版本，待后续更新

本工具基于 v2.2.43 客户端开发

#创建封装# #快速建模# #自动化工具# #嘉立创EDA# #扩展API# #扩展插件# #狼黑工具#

嘉立创EDA扩展插件 - 快速创建封装工具 置顶 精 活动

嘉立创EDA扩展插件 - 快速创建封装工具

置顶

精

活动