KiCad 插件系统简介 KiCad 插件系统是一个使用共享库扩展 KiCad 功能的框架。使用插件的一个主要优点是在开发插件时没有必要重建 KiCad 套件; 事实上，可以借助 KiCad 源代码树中的一小组标题构建插件。通过确保开发人员仅编译与正在开发的插 件直接相关的代码，从而减少每个构建和测试周期所需的时间，在插件开发期间删除构建 KiCad 的要求极大地提高 了工作效率。 插件最初是为 数据并导出为其他 电气或机械数据格式，或将外部格式转换为 KiCad PCB。目前只开发了 3D 插件类，它将成为本文档的重点。 实现插件类需要在 KiCad 源代码树中创建代码来管理插件代码的加载。在 KiCad 源代码树中，文件‘plugins/ldr/- pluginldr.h’声明了所有插件加载器的基类。这个类声明了我们期望在任何 KiCad 插件（样板代码）中找到的最基本的 函数 Plugin Class declarations #include "plugins/3d/3d_plugin.h" // KiCad b'' 场 b''b'' 景 b''b'' 图 b''b'' 形 b''b'' 库 b''b'' 接 b''b'' 口 b'' // interface to KiCad Scene Graph Library #include "plugins/3dapi/ifsg_all

撤消：还原最后一次更改。 重做：还原最后一次撤消操作。 显示在原理图中搜索符号和文本的对话框。 显示用于搜索和替换原理图中文本的对话框。 刷新屏幕;缩放以适应。 放大和缩小。 查看和导航层次结构树。 保留当前工作表并进入层次结构中。 调用符号库编辑器以查看和修改库和符号。 浏览符号库。 注释符号。 电气规则检查器（ERC），自动验证电气连接。 调用CvPcb为符号分配封装。 导出 撤消更改 还原操作的最近热键更改。 恢复默认值 将操作热键设置为其默认值。 撤消所有更改 还原操作的所有最近热键更改。 全部恢复为默认值 将所有操作热键设置为其默认值。 选项说明: 中心和变 形光标变 焦 如果选中，则指向的位置会变形 放大/缩小时到屏幕中心。 使用触摸 板进行平 移 启用时，使用滚轮（或。）平移视图 触摸板手势）和缩放一个需 要按住 Ctrl键。 否则滚轮 放大/缩小和 sym-lib-table 或解除对话框，则将在用户的主文件 夹中创建空符号库表。 如果发生这种情况，用户可以手动复制 sym-lib-table 或 手动配置表。 注意 默认符号库表包括作为 KiCad 的一部分安装的所有符号库。 根据用途 和系统的速度，这可能是也可能不是所希望的。 加载符号库所需的时 间与符号库表中的库数量成正比。 如果符号库加载时间过长，请从全 局库表中删除很少和/或从未使用过的库，并根据需要将它们添加到项

撤消：还原最后一次更改。 重做：还原最后一次撤消操作。 显示在原理图中搜索符号和文本的对话框。 显示用于搜索和替换原理图中文本的对话框。 刷新屏幕; 缩放以适应。 放大和缩小。 查看和导航层次结构树。 保留当前工作表并进入层次结构中。 调用符号库编辑器以查看和修改库和符号。 浏览符号库。 注释符号。 Eeschema 简介 9 / 151 电气规则检查器（ERC），自动验证电气连接。 sym-lib-table 或解除对话框，则将在用户的主文件夹中创建空符号库表。如果发生这种情况，用户可以手动复制 sym-lib-table 或手动配置表。 Note 默认符号库表包括作为 KiCad 的一部分安装的所有符号库。根据用途和系统的速度，这可能是也可能不是所希望 的。加载符号库所需的时间与符号库表中的库数量成正比。如果符号库加载时间过长，请从全局库表中删除很少 和/或从未使用过的库，并根据需要将它们添加到项目库表中。 这不必以任何方式与实际库文件名或路径相关。冒号“:”和“/”字符不能在库昵称中的任何位置使用。每个库条目 必须具有有效的路径和/或文件名，具体取决于库的类型。路径可以定义为绝对，相对或环境变量替换（参见下面的部 分）。 必须选择适当的插件类型才能正确读取库。KiCad 目前仅支持旧版符号库文件插件。 还有一个描述字段用于添加库条目的描述。此时不使用选项字段，因此在加载库时添加选项将不起作用。 • 请注意，

许多功能都需要3键鼠标。 在 KiCad 的新版本中，pcbnew 已经从 CERN 的开发人员那里看到了广泛的变 化。 这包括诸如新渲染器（OpenGL 和 Cairo 视图模式），交互式推送布线 器，差分和曲折布线和调整，重新设计的封装编辑器以及许多其他功能等功 能。 请注意，大多数这些新功能 仅 存在于新的 OpenGL 和 Cairo 视图模式 中。 第 2 章 安装 2.1. 安装软件 KiCad 到“fp_global_table”，将在用户的主文件夹中创建一个空的封装库表。 如果发 生这种情况，用户可以手动复制“fp_global_table”或手动配置表。 默认的封装库表包括作为 KiCad 的一部分安装的所有标准封装库。 提示 在官方 KiCad库存储库 中也有示例“fp-lib-table”文件，您可以将它们用 作您自己的起点： 通过 Github 的所有 KiCad 库： fp-lib-table 创建和修改电路板 6.1. 创建一个板 6.1.1. 绘制板边框 通常首先定义电路板的边框是个好主意。 边框绘制为一系列线段。 选 择“Edge.Cuts”作为活动图层，并使用“添加图形线或多边形”工具跟踪边缘，单 击每个顶点的位置，然后双击以完成边框。 板通常具有非常精确的尺寸，因 此在跟踪边框时可能需要使用显示的光标坐标。 请记住，可以使用空格键随 时将相对坐标归零，并且还可以使用“Ctrl-U”切换显示单位。

电路板压层设置。电路板完成部分包含用 于定义铜电镀和特殊功能 (如镶边或边缘电镀) 的设置。请注意，这些设置目前只影响作为 Gerber 作业文件一部分的 电路板属性输出。 13 阻焊/锡膏部分允许全局调整电路板上焊盘的铜形和阻焊/锡膏形之间的间隙（正或负）。 这些值将被添加到在个别封 装或焊盘上设置的任何间隙覆盖。 正的间隙值将导致阻焊层或锡膏开口的形状比铜的形状 更大。 负的间隙值将导致 设计过程开始时建立所有已知的设计规则。 约束 基本设计规则是在电路板设置对话框的约束条件部分中配置。 这一部分的约束条件适用于整个板子，应该设置为板 子制造商推荐的值。 这里设置的任何最小值都是一个 绝对(absolute) 的最小值，不能被更具体的设计规则所覆盖。 例如，如果你需要电路板的一部分的铜间隙为 0.2mm，其余部分为 0.3mm，你必须在约束条件部分输入 0.2mm 的 最小铜间隙，并使用网络类或自定义规则来设置较大的 更快的性能。 新算法产生 的结果与旧算法略有不同，因此此设置允许保留旧行为， 以防止在最新版本的 KiCad 中打开旧设计时产生不同的 Gerber 输出。 我们建议对所有新设计使用平滑多 边形模式。 允许圆角超出敷铜轮廓 敷铜可以在敷铜属性对话框中添加圆角 (圆角)。 默认情况下，不允许在敷铜轮廓之 外使用敷铜 (包括圆角)。 这实际上意味着，即使配置了圆角，也不会对敷铜轮廓的 内角进行圆角处理。

键鼠标。平移和缩放等许多功能都需要 3 键鼠标。 在 KiCad 的新版本中，pcbnew 已经从 CERN 的开发人员那里看到了广泛的变化。这包括诸如新渲染器（OpenGL 和 Cairo 视图模式），交互式推送布线器，差分和曲折布线和调整，重新设计的封装编辑器以及许多其他功能等功能。 请注意，大多数这些新功能 仅存在于新的 OpenGL 和 Cairo 视图模式中。 Pcbnew 3 / 163 Chapter 2 如果找不到“fp_global_table”，将在用户的主文件夹中创建一个空的封装库表。如果发生这种情况，用户可以手动 复制“fp_global_table”或手动配置表。 默认的封装库表包括作为 KiCad 的一部分安装的所有标准封装库。 Tip 在官方 KiCad 库存储库 中也有示例“fp-lib-table”文件，您可以将它们用作您自己的起点： • 通过 Github 的所有 KiCad 库：fp-lib-table 6 创建和修改电路板 6.1 创建一个板 6.1.1 绘制板边框 通常首先定义电路板的边框是个好主意。边框绘制为一系列线段。选择“Edge.Cuts”作为活动图层，并使用“添加 图形线或多边形”工具跟踪边缘，单击每个顶点的位置，然后双击以完成边框。板通常具有非常精确的尺寸，因此在 跟踪边框时可能需要使用显示的光标坐标。请记住，可以使用空格键随时将相对坐标归零，并且还可以使用“Ctrl-U”

配置文件夹中没有找到全局引脚表文件 fp-lib-table ，那么 KiCad 将 询问如何创建这个文件： 第一个选项是推荐的（复制默认的全局封装库表（推荐））。默认的封装库表包括所有作为 KiCad 的一部分安装的标 准封装库。 如果该选项被禁用，KiCad 无法找到默认的全局封装库表。这可能意味着你没有和 KiCad 一起安装标准封装库，或 者它们没有被安装在 KiCad 期望找到的地方。在某些系统中，KiCad 可以将相对坐标重置为零。这对于测量两点之间的距离或对齐物体很有用。 快捷键 这个 + 快捷键显示当前快捷键列表。默认的快捷键列表包括在本手册的 《pcbnew 动作参考,动作参考》部 分。 本手册中描述的快捷键使用了标准 PC 键盘上的按键标签。在苹果键盘布局中，使用 键来代替 ，使用 键来代替 。 许多动作默认没有分配快捷键，但可以使用快捷键编辑器（偏好设置 → 偏好设置… 电路板压层设置。电路板完成部分包含用 于定义铜电镀和特殊功能 (如镶边或边缘电镀) 的设置。请注意，这些设置目前只影响作为 Gerber 作业文件一部分的 电路板属性输出。 12 阻焊/锡膏部分允许全局调整电路板上焊盘的铜形和阻焊/锡膏形之间的间隙（正或负）。 这些值将被添加到在个别封 装或焊盘上设置的任何间隙覆盖。 正的间隙值将导致阻焊层或锡膏开口的形状比铜的形状 更大。 负的间隙值将导致

KiCad 插件系统简介 KiCad 插件系统是一个使用共享库扩展 KiCad 功能的框架。 使用插件的一个 主要优点是在开发插件时没有必要重建 KiCad 套件; 事实上，可以借助 KiCad 源代码树中的一小组标题构建插件。 通过确保开发人员仅编译与正在开发的 插件直接相关的代码，从而减少每个构建和测试周期所需的时间，在插件开发 期间删除构建 KiCad 的要求极大地提高了工作效率。 插件最初是为 数据并导出为其他电 气或机械数据格式，或将外部格式转换为 KiCad PCB。 目前只开发了 3D 插件 类，它将成为本文档的重点。 实现插件类需要在 KiCad 源代码树中创建代码来管理插件代码的加载。在 KiCad 源代码树中，文件 ‘plugins/ldr/pluginldr.h’ 声明了所有插件加载器的基 类。这个类声明了我们期望在任何 KiCad 插件（样板代码）中找到的最基本的 函数， vert[1] ); // 坐标索引-注意：强制三角形； // coordinate indices - note: enforce triangles; // 在不一定可能的实际插件中 // in real plugins where it is not necessarily possible // 若要确定三角形从哪一侧可见，请执行以下操作： // to

（带格式符号，将被实际文本替换， 比如 Eeschema 或 Pcbnew 中的日 期，页码…）。 多边形 （主要用于放置 LOGO 和特殊图形形状） 位图 。 警告 位图只能由少量绘图仪绘制（仅限 PDF 和 PS）因此，对于其他绘图 仪，仅绘制边界框。 可以重复项目，可以旋转文本和多边形。 2. Pl_Editor 文件 2.1. 输入文件和默认标题栏 Pl_Editor 读取或写入图框描述文件 Eeschema 或 Pcbnew 中的日 期，页码…）。 多边形 （主要用于放置 LOGO 和特殊图形形状）。 这些多边形由 Bitmap2component 创建，但不能 内置 pl_editor，因为无法创建这样的形状 用手。 位图 用于放置 LOGO。 警告 位图只能由少量绘图仪绘制：仅限 PDF 和 PS。 因此： 文本，多边形 和 位图 由位置定义，和 可以旋转。 线 （实际上是段）和 更改页面大小时，项目相对于其参考角的位置不会更改。 通常，标题栏附加到右下角，因此在创建项目时，此角是默认角。 对于具有两个定义点的矩形和线段，每个点都有其参考角。 3.4. 旋转 可以旋转具有仅由一个点（文本和多边形）定义的位置的项目： 正常：旋转 = 0 旋转：旋转 = 20 和 10 度。 3.5. 重复选项 项目可以重复： 这对于创建网格和网格标签很有用。 4. 文字和格式 4.1. 格式符号：

（带格式符号，将被实际文本替换， 比如 Eeschema 或 Pcbnew 中的日期，页码… ）。 多边形 （主要用于放置 LOGO 和特殊图形形状） 位图 。 WARNING 位图只能由少量绘图仪绘制（仅限 PDF 和 PS）因此，对于其他绘图仪，仅绘制边界框。 可以重复项目，可以旋转文本和多边形。 Pl_Editor 文件 输入文件和默认标题栏 Pl_Editor 读取或写入图框描述文件 Eeschema 或 Pcbnew 中的日期，页码… ）。 多边形 （主要用于放置 LOGO 和特殊图形形状）。 这些多边形由 Bitmap2component 创建，但不能 内置 pl_editor，因为无法创建这样的形状 用手。 位图 用于放置 LOGO。 WARNING 位图只能由少量绘图仪绘制：仅限 PDF 和 PS。 因此： 文本，多边形 和 位图 由位置定义，和 可以旋转。 线 （实际上是段）和 更改页面大小时，项目相对于其参考角的位置不会更改。 通常，标题栏附加到右下角，因此在创建项目时，此角是默认角。 对于具有两个定义点的矩形和线段，每个点都有其参考角。 6 旋转 可以旋转具有仅由一个点（文本和多边形）定义的位置的项目： 正常：旋转 = 0 旋转：旋转 = 20 和 10 度。 7 重复选项 项目可以重复： 这对于创建网格和网格标签很有用。 8 文字和格式 格式符号： 文本可以是简单的字符串，也可以包含格式符号。