入器和导出器。 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 层次原理图 简介 在设计中添加原理图 alphabetically or by best match by clicking on the button. 有一些高级筛选器可用： 通配符： * 匹配任意数量的任意字符，包括无字符，而 ? 匹配任意单个字符。 键值对： 如果一个库部分的描述或关键词包含一个格式为 "Key:123" 的标签，你可以通过输入 "Key>123"（大 于）、"Key<123"（小于）等进行相对匹配。 中，位号由一个表示元件类型的字母（ R 表示电阻， C 表示电容， U 表示集成电路，等等）及后面的数字 组成。如果符号有多个单元，那么位号也会有一个表示单位的尾部字母。没有设置位号的符号有一个 ? 字符，而不 是数字。位号必须是唯一的。 位号可以在符号添加到原理图时自动设置，也可以通过手动编辑单个符号的位号字段或使用批注工具批量设置或重置 位号。 NOTE 设置一个符号的位号的过程被称为 批注。

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

在编辑画布上导航 快捷键 鼠标操作和选择 左侧工具条显示控制 原理图创建和编辑 简介 原理图编辑操作 网格 捕捉 编辑对象属性 使用符号工作 位号和符号注释 电气连接 网络类 图形项目 原理图设置 Opening legacy schematics 层次原理图 简介 在设计中添加图框 原理图之间导航器 原理图之间的电气连接 层次设计实例 检查原理图 筛选工具 效果 禁用网格捕捉。 禁用将导线捕捉在引脚上。 编辑对象属性 所有对象都有可在对话框中编辑的属性。使用快捷键 或从右键菜单中选择属性来编辑所选项目的属性。只有当你 选择的所有项目都是同一类型时，你才能打开属性对话框。要想一次编辑不同类型的项目的属性，请参阅下面关于批 量编辑工具的章节。 在属性对话框中，任何包含数字值的字段也可以接受一个基本的数学表达式，从而得到一个数字值。例如，一个尺寸 中，位号由一个表示元件类型的字母组成（ R 表示电阻， C 表示电容， U 表示集成电路，等等），后面是 一个数字。如果符号有多个元位，那么位号也会有一个表示元位的尾部字母。没有设置位号的符号有一个 ? 字符， 而不是数字。位号必须是唯一的。 Ctrl C Ctrl V 20 位号可以在符号添加到原理图时自动设置，也可以通过手动编辑单个符号的位号字段或使用注释工具批量设置或重置 位号。 NOTE

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

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

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 插件类 . . . . . . . . . . . . . . . .

项目特定表仅适 用于打开板文件的情况。 每个库表条目都有一个昵称。 这个 必须（must） 在该表中是唯一的。 昵称不 必以任何方式与实际库文件名或路径相关。 有效的库表条目有一些规则： 冒号“:”字符不能在昵称中的任何位置使用。 每个库条目必须具有有效的路径和/或文件名，具体取决于库的类型。 路径 可以定义为绝对，相对或环境变量替换（见下文） 必须选择适当的插件类型才能使库成为必需的。必须选择适当的插件类型 “插件类型”必须设置为“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 封装 封

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69 8.3 网类 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71 Pcbnew vii 8.3.2 网类编辑器 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71 项目特定表仅适用于打开板文件的情况。 每个库表条目都有一个昵称。这个 必须（must）在该表中是唯一的。昵称不必以任何方式与实际库文件名或路径相关。 有效的库表条目有一些规则： • 冒号“:”字符不能在昵称中的任何位置使用。 • 每个库条目必须具有有效的路径和/或文件名，具体取决于库的类型。路径可以定义为绝对，相对或环境变量替换 （见下文） • 必须选择适当的插件类型才能使库成为必需的

表中的每一行都存储了几个描述库的字段： 活动 启用/禁用库。 暂时减少加载的库集很有用。 昵称 昵称是用于将符号分配给元件的简短唯一标识符。符号 由'：'字符串表示。 库路 径 路径指向库位置。 插件 类型 确定库文件格式。 选项 存储库特定选项（如果插件使用）。 说明 简要描述库内容。 3.2.2. 常规选项 显示 网格尺寸 网格大小选择。 您可以通过按 “发布日期” 按左箭头按钮将日期设置 为今天，但不会自动更改。 4.2. 搜索工具 “查找” 图标（ ）可用于访问搜索工具。 您可以在当前工作表或整个层次结构中搜索引用，值或文本字符串。 找到 后，光标将定位在相关子表中的找到元素上。 4.3. 网表工具 网表图标（ ）打开网表生成工具。 该工具创建一个文件，描述整个层次结构中的所有连接。 在多表层次结构中，任何本地标签仅在其所属的工作表内可见。 必须首先将其添加到全局表或项目特定表中。特定于项目的 表仅适用于打开项目文件的情况。 每个图书馆条目必须有一个独特的昵称。 这不必以任何方式与实际库文件名或路径相关。 冒号 “:” 和 “/” 字符不能在库 昵称中的任何位置使用。 每个库条目必须具有有效的路径和/或文件名，具体 取决于库的类型。 路径可以定义为绝对，相对或环境变量替换（参见下面的 部分）。 必须选择适当的插件类型才能正确读取库。