Kicad 插件 The KiCad Team KiCad 插件系统 Copyright 本文档由其贡献者授予版权 © 2016，如下所示。您可以根据 GNU 通用公共许 可证(http：/www.gnu.org/licenses/gpl.html)版本 3 或更高版本或知识共享许可协 议(http：/creativecommons.org/licenses/by/3.0/)、版本 3.0 KiCad 插件系统简介 KiCad 插件系统是一个使用共享库扩展 KiCad 功能的框架。 使用插件的一个 主要优点是在开发插件时没有必要重建 KiCad 套件; 事实上，可以借助 KiCad 源代码树中的一小组标题构建插件。 通过确保开发人员仅编译与正在开发的 插件直接相关的代码，从而减少每个构建和测试周期所需的时间，在插件开发 期间删除构建 KiCad 的要求极大地提高了工作效率。 插件最初是为 无需对支持的每种新模型类型的 KiCad 源进行重大更改。 插件框架后来被推 广，以便将来开发人员可以创建不同类型的插件。 目前，只有 3D 插件在 KiCad 中实现，但可以想象最终将开发 PCB 插件，以使用户能够实现数据导 入器和导出器。 1.1. 插件类 插件分为插件类，因为每个插件都解决了特定域中的问题，因此需要该域独有 的接口。 例如，3D 模型插件从文件加载 3D 模型数据并将该数据转换为可由

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

4.0 版本开始，Pcbnew 使用名为“封装库表”的文件组织封装库。 封装库表 包含一些单独的封装库的描述，以及每个库的“昵称”，用于在引用封装时引用 该库。 Pcbnew 支持几种库，每种都由“插件”支持： KiCad - 以 .pretty 格式存储在本地文件系统上的本机 KiCad 封装库（包含 .kicad_mod 文件的文件夹） Github - .pretty 格式的原生 KiCad 每个库条目必须具有有效的路径和/或文件名，具体取决于库的类型。 路径 可以定义为绝对，相对或环境变量替换（见下文） 必须选择适当的插件类型才能使库成为必需的。必须选择适当的插件类型 才能正确读取库。阅读。 还有一个描述字段用于添加库条目的描述。 选项字段包含特定于插件的特殊 选项，通常为空白。 虽然在同一个表中不能有重复的库昵称，但是在全局和项目特定的封装库表中 都可以有重复的库昵称。 当出现重复的名称时，项目特定的表条目将优先于 如果您 使用的是 Github 插件（没有本地副本），则在需要时会从 Github 加载封装。 2.3.7. 使用 KiCad 插件 KiCad 插件处理您计算机上存在的本机 KiCad 库（或某些可访问的文件系 统）。 它用于与 KiCad 一起安装的预安装库，以及其他 KiCad 库，可以是官方的 KiCad 库集，第三方库或您自己的策划库。 安装 KiCad 插件库 Footprint Library

. . . . . . . . . . . . 10 2.3.7 使用 KiCad 插件 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 2.3.7.1 安装 KiCad 插件库 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 2.3.8 使用 GitHub 插件 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 2.3.8.1 写入时复制（Copy-On-Write） . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69 8.3 网类 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

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

扩展包和第三⽅教程 索引 请在此进⾏搜索 ⸺因为⽂档 系统搜索框暂不⽀持中⽂。此 ⻚⾯列出了所有⻚⾯和⻚⾯各 ⼩节的标题，⽤浏览器的搜索 下载 Krita 专⽤的笔刷包、纹理包 和 Python 插件等各种扩展资源， 让创作⼿段更加丰富。还有外部 教程、视频等学习资源。 功能 (Ctrl+F) 可查找所需的内 容，点击直接访问。 使⽤指南 你可以通过本在线⼿册了解 Krita 的各种特性，也可以学习如何从 选区显⽰模式 全局选区蒙版 (绘制选区) 按照图层透明度建⽴选区 像素选区和⽮量选区 选区⼯具的常⽤配套快捷键 Python 脚本编程 安装和管理 Python 插件 Krita Python 脚本编程⼊⻔ Krita Python 插件编写教程 标签管理 新建标签 指定标签 重命名标签 删除标签 ⾊彩校样 超出⾊域警告 ⽮量图形 ⽮量图形介绍 创建⽮量图形的⼯具 排列形状 编辑形状 与其他程序配合⼯作 在功能上的异同，可以帮助你快速上⼿。 如果你刚刚接触数字绘画，可从 安装 开始，该⼩节介绍了如何安 装 Krita。⾸次使⽤ Krita ⼩节介绍了如何新建和保存⽂档。基础概 念 ⼩节简要介绍了 Krita 各个功能⼤类。视图控制 ⼩节介绍了如何 使⽤ Krita 的界⾯，如平移、缩放和旋转画布等。 在掌握这些基础之后，你还可以进⾏更深⼊的学习。使⽤指南 的其 他章节对 Krita 的各个主要功能进⾏了更为详尽的介绍。数字绘画

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

一一做出解答。在求助和报告 程序缺陷前，请先在此页面确 认是否已经存在答案。 扩展包和第三方教程 索引 此页面列出了所有页面和页面 各小节的标题。请用浏览器的 下载 Krita 专用的笔刷包、纹理包 和 Python 插件等各种扩展资源， 让创作手段更加丰富。还有外部 教程、视频等学习资源。 搜索功能 (Ctrl+F) 查找所需的 内容，点击直接访问。 使用指南 你可以通过本在线手册了解 Krita 的各种特性，也可以学习如何从 选区显示模式 全局选区蒙版 (绘制选区) 按照图层透明度建立选区 像素选区和矢量选区 选区工具的常用配套快捷键 Python 脚本编程 安装和管理 Python 插件 Krita Python 脚本编程入门 Krita Python 插件编写教程 标签管理 新建标签 指定标签 重命名标签 删除标签 色彩校样 超出色域警告 矢量图形 矢量图形介绍 创建矢量图形的工具 排列形状 编辑形状 与其他程序配合工作 应用一个 线性的黑白渐变，黑色一端在画面下方，白色一端在画面上方。 蒙版上的颜色越黑，人物图层的颜色就越透明，这下就有点女鬼的 意思了！ 蒙版这个名字最初起源于电影行业，它和前面提到的留白胶作用类 似。Krita 的选区和蒙版一样，也是作为灰阶图像被保存在程序内 部的。如果你把一个选区保存成本地选区，实际上等于创建了一个 蒙版，所以本地选区也可以被转换成透明度蒙版。 滤镜 我们之前已经介绍

常见问题解答 对常见的技术性问题、故障等一一 做出解答。在求助和报告程序缺陷 前，请先在此页面确认是否已经存 在答案。 扩展包和第三方教程 下载 Krita 专用的笔刷包、纹理包和 Python 插件等各种扩展资源，让创作手 段更加丰富。还有外部教程、视频等学 习资源。 索引 请在此进行搜索 ——因为文档系统 搜索框暂不支持中文。此页面列出 了所有页面和页面各小节的标题， 用浏览器的搜索功能 选区显示模式 全局选区蒙版 (绘制选区) 按照图层透明度建立选区 像素选区和矢量选区 选区工具的常用配套快捷键 Python 脚本编程 安装和管理 Python 插件 Krita Python 脚本编程入门 Krita Python 插件编写教程 标签管理 新建标签 指定标签 重命名标签 删除标签 色彩校样 超出色域警告 矢量图形 矢量图形介绍 创建矢量图形的工具 排列形状 编辑形状 与其他程序配合工作 无需卸载之后重新安装。 Windows 环境下可能发生的问题 如果驱动已经正确安装，Krita 会自动连接到数位板。数位板要是工作不正 常，一般都不是 Krita 造成的问题。 Surface Pro 类笔式平板电脑的两种数位板驱动程序 包括 Surface Pro 在内的许多笔式平板电脑使用的是 N-trig 技术，它们具备两种 驱动程序。一种是 N-trig 体系特有的 Windows Ink 驱动，另一种则是传统的

常见问题解答 对常见的技术性问题、故障等一一做出解 答。在求助和报告程序缺陷前，请先在此页 面确认是否已经存在答案。 扩展包和第三方教程 下载 Krita 专用的笔刷包、纹理包和 Python 插件等各种扩展资源，让创作手段更加丰 富。还有外部教程、视频等学习资源。 索引 此页面列出了所有页面和页面各小节的标 题。请用浏览器的搜索功能 (Ctrl+F) 查找所 需的内容，点击直接访问。 使用指南 选区显示模式 全局选区蒙版 (绘制选区) 按照图层透明度建立选区 像素选区和矢量选区 选区工具的常用配套快捷键 Python 脚本编程 安装和管理 Python 插件 Krita Python 脚本编程入门 Krita Python 插件编写教程 标签管理 新建标签 指定标签 重命名标签 删除标签 色彩校样 超出色域警告 矢量图形 矢量图形介绍 创建矢量图形的工具 排列形状 编辑形状 与其他程序配合工作 滤镜蒙版。滤镜图层按照 继承关系影响与其关联的图层。在滤镜图层上调整透明度和应用透明度蒙版可以影 响它们作用的图层和区域。 滤镜蒙版可以通过一张灰阶图像影响一个图层或者一个图层组，这和透明度蒙版类 似。 我们可以使用滤镜图层来让刚才的女鬼变得更加鬼模鬼样。在女鬼的图层上点击右 键，创建一个克隆图层。在这个克隆图层上点击右键，创建一个滤镜蒙版，选用“高 斯模糊”滤镜，把半径设为 10px 左右