iii Contents 1 KiCad 插件系统简介 2 1.1 插件类 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 1.1.1 插件类：PLUGIN_3D . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 2 教程：3D 插件类 4 2.1 基本的 3D 插件 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 2.2 高级 3D 插件 . 12 3 应用程序编程接口（API） 21 3.1 插件类 API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21 3.1.1 API：Base Kicad 插件类 . . . . . . . . . . . . . . . .

入器和导出器。 1.1. 插件类 插件分为插件类，因为每个插件都解决了特定域中的问题，因此需要该域独有 的接口。 例如，3D 模型插件从文件加载 3D 模型数据并将该数据转换为可由 3D 查看器显示的格式。 PCB 导入/导出插件将获取 PCB 数据并导出为其他电 气或机械数据格式，或将外部格式转换为 KiCad PCB。 目前只开发了 3D 插件 类，它将成为本文档的重点。 实现插件类需要在 KiCad 源代码树中，文件 ‘plugins/ldr/pluginldr.h’ 声明了所有插件加载器的基 类。这个类声明了我们期望在任何 KiCad 插件（样板代码）中找到的最基本的 函数，它的实现提供了对插件加载器和可用插件之间的版本兼容性的基本检 查。标题 ‘plugins/ldr/3d/pluginldr3D.h’ 声明了 3D 插件类的加载器。加载器负 责加载给定的插件并使其功能可用于 KiCad。插件加载器的每个实例代表一个 S3D_CACHE 类中。 除非正在开发新的插件类，否则插件开发人员不需要关心 KiCad 管理插件的内 部代码的细节; 插件只需要定义其特定插件类声明的函数。 标题 ‘include/plugins/kicad_plugin.h’ 声明了所有 KiCad 插件所需的泛型函数; 这 些函数标识插件类，提供特定插件的名称，提供插件类 API 的版本信息，提供 特定插件的版本信息，并提供插件类 API 的基本版本兼容性检查。

快捷键 鼠标操作和选择 左侧工具栏显示控制 原理图创建和编辑 简介 原理图编辑操作 Grids and snapping 编辑对象属性 使用符号 位号和符号批注 电气连接 网络类 图形对象 Schematic editing convenience functions 原理图设置 Opening legacy schematics 层次原理图 简介 在设计中添加原理图 将其与相邻的导线分开。 通常情况下，导线的样式遵照网络的网络类设置（如果没有指定其他网络类，网络就属于 默认 网络类）。然而，所 选导线的样式可以在导线的属性对话框中被覆盖（当导线被选中时点击 ）。可以设置导线的宽度、颜色和导线的 样式（实线、虚线、点线等）。将宽度设置为 0 ，清除颜色，并使用 默认 导线样式，将分别使用网络类设置中的默 认宽度、颜色和样式。如果在选择中包含了一个导线结点，结点的大小也可以在这里进行编辑。 18、19、20、21、22 和 23 的导线上使用了结点。 结点大小自动遵循原理图的 结点大小 设置，在 原理图设置 → 通用 → 格式化。颜色遵循 网络类设置。自动尺寸和颜 色可以在每个连接点的属性中被覆盖；尺寸为 0 相当于原理图的默认尺寸，而清除颜色则使用网络类颜色。 标签 标签是用来给导线和引脚分配网络名称的。具有相同网络名称的导线被认为是连接在一起的，所以标签可以用来进行 连接，而不需要直接画线连接。

在编辑画布上导航 快捷键 鼠标操作和选择 左侧工具条显示控制 原理图创建和编辑 简介 原理图编辑操作 网格 捕捉 编辑对象属性 使用符号工作 位号和符号注释 电气连接 网络类 图形项目 原理图设置 Opening legacy schematics 层次原理图 简介 在设计中添加图框 原理图之间导航器 原理图之间的电气连接 层次设计实例 检查原理图 筛选工具 效果 禁用网格捕捉。 禁用将导线捕捉在引脚上。 编辑对象属性 所有对象都有可在对话框中编辑的属性。使用快捷键 或从右键菜单中选择属性来编辑所选项目的属性。只有当你 选择的所有项目都是同一类型时，你才能打开属性对话框。要想一次编辑不同类型的项目的属性，请参阅下面关于批 量编辑工具的章节。 在属性对话框中，任何包含数字值的字段也可以接受一个基本的数学表达式，从而得到一个数字值。例如，一个尺寸 将其与相邻的线段分开。 通常情况下，线的线型是按照网的《原理图设置网络类，网络类设置》（如果没有指定其他网络类，网就处于 默认 网络类）。然而，所选线段的线型可以在线段的属性对话框中被覆盖（当线段被选中时 ）。可以设置线的宽度、 颜色和线的样式（实线、虚线、点线等）。将宽度设置为 0 ，清除颜色，并使用 默认 线条样式，分别使用网络类设 置中的默认宽度、颜色和样式。如果在选择中包含了一个导线结点，结点的大小也可以在这里进行编辑。

选项，并从列表中选择要删除的预设。 网络和网络类控件 外观面板的网络选项卡显示电路板中所有网络和网络类的列表。每个网都有一个可见性控件，用于控制该网在飞线中 的可见性。在飞线中隐藏网络不会改变电路板的连接性，也不会影响设计规则检查器；这只是为了使飞线更容易理 解。 每个网络和网络类还可以指定一种颜色。默认情况下，此颜色适用于网络 (或网络类中的所有网络) 的飞线。默认情 况下，网络没有 况下，网络没有颜色；这由色样中的棋盘格图案指示。双击或右键单击网络或网络类颜色样本以设置颜色。 NOTE 默认网络类不能分配颜色， 因为该类中的网络将仅使用颜色主题定义的默认飞线最高颜色。 您还可以通过外观面板选择并高亮网络和网络类：右击网络或网络类以在菜单中显示这些选项。 网络类列表下面是一个包含网络显示选项的可扩展面板。第一个选项控制如何应用网络颜色。当选择了“所有”时，属 于网络或网络类别的所有铜项 于网络或网络类别的所有铜项 (焊盘、布线、过孔和区域) 都将呈现所选的颜色。当选中“飞线”(默认值)时，只有飞线 受网络和网络类别颜色的影响。 当选择“没有”时，网络和网络类颜色被忽略。 第二个选项控制如何绘制飞线。“所有图层”表示将在所有未连接的项目之间绘制飞线。“可见层”意味着不会向隐藏层 上的项目绘制任何最新的飞线，即使这些项目是未连接的。 选择和选择筛选器 Selecting items in the editing

deleted from the list. 网络和网络类控件 外观面板的网络选项卡显示电路板中所有网络和网络类的列表。每个网络都有一个可见性控件，用于控制该网络在飞 线中的可见性。在飞线中隐藏网络不会改变电路板的连接性，也不会影响设计规则检查器；这只是为了使飞线更容易 理解。 每个网络和网络类还可以指定一种颜色。默认情况下，此颜色适用于网络 (或网络类中的所有网络) 的飞线。默认情 况下，网络没 况下，网络没有颜色；这由色样中的棋盘格图案指示。双击或右键单击网络或网络类颜色样本以设置颜色。 NOTE 默认网络类不能分配颜色， 因为该类中的网络将仅使用颜色主题定义的默认飞线颜色。 您还可以通过外观面板选择并高亮网络和网络类：右击网络或网络类以在菜单中显示这些选项。 网络类列表下面是一个包含网络显示选项的可扩展面板。第一个选项控制如何应用网络颜色。当选择了 “所有” 时， 属于网络或网络类的所有铜对象 (焊盘、布线、过孔和敷铜) (焊盘、布线、过孔和敷铜) 都将呈现所选的颜色。当选中 “飞线” (默认值)时，只有 飞线受网络和网络类颜色的影响。 当选择 “无” 时，网络和网络类颜色被忽略。 第二个选项控制如何绘制飞线。“所有图层” 表示将在所有未连接的项目之间绘制飞线。“可见层” 意味着不会向隐藏 层上的项目绘制任何最新的飞线，即使这些项目是未连接的。 Ctrl Tab Tab Shift Tab Ctrl Shift Tab Tab

选项，并从列表中选择要删除的预设。 网络和网络类控件 外观面板的网络选项卡显示电路板中所有网络和网络类的列表。每个网都有一个可见性控件，用于控制该网在飞线中 的可见性。在飞线中隐藏网络不会改变电路板的连接性，也不会影响设计规则检查器；这只是为了使飞线更容易理 解。 每个网络和网络类还可以指定一种颜色。默认情况下，此颜色适用于网络 (或网络类中的所有网络) 的飞线。默认情 况下，网络没有 况下，网络没有颜色；这由色样中的棋盘格图案指示。双击或右键单击网络或网络类颜色样本以设置颜色。 NOTE 默认网络类不能分配颜色， 因为该类中的网络将仅使用颜色主题定义的默认飞线最高颜色。 您还可以通过外观面板选择并高亮网络和网络类：右击网络或网络类以在菜单中显示这些选项。 网络类列表下面是一个包含网络显示选项的可扩展面板。第一个选项控制如何应用网络颜色。当选择了“所有”时，属 于网络或网络类别的所有铜项 于网络或网络类别的所有铜项 (焊盘、布线、过孔和区域) 都将呈现所选的颜色。当选中“飞线”(默认值)时，只有飞线 受网络和网络类别颜色的影响。 当选择“没有”时，网络和网络类颜色被忽略。 第二个选项控制如何绘制飞线。“所有图层”表示将在所有未连接的项目之间绘制飞线。“可见层”意味着不会向隐藏层 上的项目绘制任何最新的飞线，即使这些项目是未连接的。 选择和选择筛选器 选择编辑画布中的项目是用鼠标左键完成的。 单独

“插件类型”必须设置为“Github”。 下表显示了具有默认选项（无 COW 支持）的封装库表条目： 昵称 库路径 插件类 型 选 项 描述 GitHub 上 https://github.com/liftoff- sr/pretty_footprints GitHub 上 Liftoff 的 GH 封装 昵称 库路径 插件类 型 选 项 描述 写入时复制（Copy-On-Write） 要启用“写入时复制”功 常驻部分始终是只读的，这意味着您无法删除任 何内容或直接修改指定 GitHub 存储库中的任何封装。 在所有进一步的讨论 中，聚合库类型仍然是“Github”，但它包括本地读/写部分和远程只读部分。 昵称 库路径 插件类 型 选 项 描述 GitHub 上 https://github.com/liftoff- sr/pretty_footprints GitHub 上 Liftoff 的 GH 封装 封 磁布线 ：图形光标成为布线轴。 8.3. 网类 Pcbnew 允许您为每个网络定义不同的布线参数。 参数由一组网络定义。 一组网称为网类。 总有一个名为“默认”的网类。 用户可以添加其他网类。 网类指定： 布线宽度，直径和钻孔。 焊盘和布线（或通孔）之间的间隙。 布线时，Pcbnew 会自动选择与要创建或编辑的布线网络对应的网络类，从 而选择布线参数。 8.3.1. 设置布线参数

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69 8.3 网类 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71 Pcbnew vii 8.3.2 网类编辑器 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71 磁布线：图形光标成为布线轴。 8.3 网类 Pcbnew 允许您为每个网络定义不同的布线参数。参数由一组网络定义。 • 一组网称为网类。 • 总有一个名为“默认”的网类。 • 用户可以添加其他网类。 网类指定： • 布线宽度，直径和钻孔。 • 焊盘和布线（或通孔）之间的间隙。 • 布线时，Pcbnew 会自动选择与要创建或编辑的布线网络对应的网络类，从而选择布线参数。 8.3.1 设置布线参数

KiCad 有一个基于工程的工作流程。 KiCad 工程是一个包含工程文件、原理图、电路板布局 的文件夹，也可以选择其他相关文件，如符号和封装库、仿真数据、采购信息等。许多与项目相关的设置，包括网络 类和设计规则，都存储在工程层面。在其相关工程之外打开一个电路板可能会导致设计信息的丢失，所以要确保将所 有与工程相关的文件放在一起。 PCB 设计工作流程 通常情况下，首先绘制原理图。这意味着在原 最后，打开 设计规则 → 网络类 页面。网络类是一组与特定网络组相关的设计规则。这个页面列出了设计中每个网络 类的设计规则，并允许将网络类分配给每个网络类。 22 布线的宽度和间距可以由设计者在布局过程中手动管理，但推荐使用网络类，因为它们提供了一种自动管理和检查设 计规则的方法。 在这个设计中，没有指定网络类，所以所有的网络都属于 默认 网络类。这个网络类的默认设计规则对这个工程来说 是可以接受的，但是其他设计可能有多个网络类，每个网络类有不同的设计规则。例如，一块板子可能有一个宽线 高电流 网络类，有，或者一个 50 ohm 网络类，有特定的宽度和 50 欧姆控制阻抗线的间隙规则。 从原理图中导入更改 原理图已经完成，但布局中还没有任何元件。 要从原理图中导入设计数据到布局中，请点击 工具 → 从原理图更新 PCB… ，或按 。在顶部的工具栏上还有一个按钮