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 . . . . . . . . . . . . . .

着⾊节点 ⾊彩管理 Freestyle 层 & 通道 渲染输出 合成 简介 侧栏 GPU合成器 节点类型 运动跟踪 & 遮罩 简介 运动追踪 遮罩 视频编辑 简介 设置你的项⽬ 编辑您的项⽬ 资产、⽂件 & 数据系统 简介 Blender ⽂件 数据块 ⾃定义属性 关联库 资产库 媒体格式 导⼊ & 导出⽂件 插件 插件类别列表 ⾼级 命令⾏ 脚本与扩展Blender 应⽤模板 ⽹格接触/靠近修改纹理 的动态绘制，模拟海⾯和泡沫的洋⾯修改器，新的插件，bug修复，以及 添加了更多Python API扩展。 2.62 -- 2012年2⽉: 添加 Carve library 以改进布尔操作，增加了对物体追踪的⽀持，新增重构 ⽹格修改器，游戏引擎⼤量改进，Python API中的矩阵和向量改进，新的 插件，以及⼤量bug修复。 2.63 -- 2012年4⽉: 合并B 合并Bmesh到主⼲，开启n边多边形的全⾯⽀持，雕刻隐藏，为Cycles准备 的全景相机，镜⼦球环境纹理和浮点数精度纹理，渲染层遮罩层、环境光 遮蔽和背景图像与渲染层的视⼜显⽰，新增新的导⼊和导出插件，和 150 处bug 修复。 2.64 -- 2012年10⽉: 遮罩编辑器，改进的运动跟踪器，OpenColorIO，Cycles渲染器改进，序 列编辑器改进，更好的⽹格⼯具（插⼊和倒⾓改进），新抠像节点，雕刻

⾊彩管理 Freestyle 层 & 通道 渲染输出 合成 简介 侧栏 Realtime Compositor 节点类型 运动跟踪 & 遮罩 简介 运动追踪 遮罩 视频编辑 简介 设置你的项⽬ 编辑您的项⽬ 资产、⽂件 & 数据系统 简介 Blender ⽂件 数据块 ⾃定义属性 关联库 资产库 媒体格式 导⼊ & 导出⽂件 插件 插件类别列表 ⾼级 命令⾏ 脚本与扩展Blender 顶点权重组修改器、 3D ⾳频和视频、bug 修复。 2.61 -- 2011年12⽉: 添加Cycles渲染引擎⾄主⼲，新增相机追踪，借助⽹格接触/靠近修改纹理 的动态绘制，模拟海⾯和泡沫的洋⾯修改器，新的插件，bug修复，以及添 加了更多Python API扩展。 2.62 -- 2012年2⽉: 添加 Carve library 以改进布尔操作，增加了对物体追踪的⽀持，新增重构 ⽹格修改器，游戏引擎⼤量改进，Python 合并Bmesh到主⼲，开启n边多边形的全⾯⽀持，雕刻隐藏，为Cycles准备 的全景相机，镜⼦球环境纹理和浮点数精度纹理，渲染层遮罩层、环境光 遮蔽和背景图像与渲染层的视⼜显⽰，新增新的导⼊和导出插件，和 150 处bug 修复。 2.64 -- 2012年10⽉: 遮罩编辑器，改进的运动跟踪器，OpenColorIO，Cycles渲染器改进，序列 编辑器改进，更好的⽹格⼯具（插⼊和倒⾓改进），新抠像节点，雕刻遮

⾃由开源3D创作套件的⽤户⼿册。 ⼊门 部分 ⼊门 ⽤户界⾯ 编辑器 场景&物体 建模 雕刻&绘制 蜡笔 动画 & 绑定 物理 渲染 合成 运动跟踪 & 遮罩 视频编辑 资产、⽂件 & 数据系统 插件 ⾼级 问题排查 词汇表 参与 ⼿册主要由志愿者维护，中⽂翻译组QQ群号：620831153，欢迎加⼊。 请考虑参与这份⼯作并 为⼿册出⼒ 。针对中⽂⼿册中的问题，请 点此报错 。 ⼊门 关于Blender 顶点权重组修改器、 3D ⾳频和视频、bug 修复。 2.61 -- 2011年12⽉: 添加Cycles渲染引擎⾄主⼲，新增相机追踪，借助⽹格接触/靠近修改纹理 的动态绘制，模拟海⾯和泡沫的洋⾯修改器，新的插件，bug修复，以及添 加了更多Python API扩展。 2.62 -- 2012年2⽉: 添加 Carve library 以改进布尔操作，增加了对物体追踪的⽀持，新增重构 ⽹格修改器，游戏引擎⼤量改进，Python 合并Bmesh到主⼲，开启n边多边形的全⾯⽀持，雕刻隐藏，为Cycles准备 的全景相机，镜⼦球环境纹理和浮点数精度纹理，渲染层遮罩层、环境光 遮蔽和背景图像与渲染层的视⼜显⽰，新增新的导⼊和导出插件，和 150 处bug 修复。 2.64 -- 2012年10⽉: 遮罩编辑器，改进的运动跟踪器，OpenColorIO，Cycles渲染器改进，序列 编辑器改进，更好的⽹格⼯具(插⼊和倒⾓改进)，新抠像节点，雕刻遮罩，

⼊门 部分 ⼊门 ⽤户界⾯ 编辑器 场景&物体 建模 雕刻&绘制 蜡笔 动画 & 绑定 物理 渲染 合成 运动跟踪 & 遮罩 视频编辑 Assets, Files, & Data System 插件 ⾼级 问题排查 词汇表 参与 ⼿册主要由志愿者维护，中⽂翻译组QQ群号：620831153，欢迎加⼊。 请考虑参与这份⼯作并 为⼿册出⼒ 。针对中⽂⼿册中的问题，请 点此报错 。 ⼊门 关于Blender 顶点权重组修改器、 3D ⾳频和视频、bug 修复。 2.61 -- 2011年12⽉: 添加Cycles渲染引擎⾄主⼲，新增相机追踪，借助⽹格接触/靠近修改纹理 的动态绘制，模拟海⾯和泡沫的洋⾯修改器，新的插件，bug修复，以及添 加了更多Python API扩展。 2.62 -- 2012年2⽉: 添加 Carve library 以改进布尔操作，增加了对物体追踪的⽀持，新增重构 ⽹格修改器，游戏引擎⼤量改进，Python 合并Bmesh到主⼲，开启n边多边形的全⾯⽀持，雕刻隐藏，为Cycles准备 的全景相机，镜⼦球环境纹理和浮点数精度纹理，渲染层遮罩层、环境光 遮蔽和背景图像与渲染层的视⼜显⽰，新增新的导⼊和导出插件，和 150 处bug 修复。 2.64 -- 2012年10⽉: 遮罩编辑器，改进的运动跟踪器，OpenColorIO，Cycles渲染器改进，序列 编辑器改进，更好的⽹格⼯具(插⼊和倒⾓改进)，新抠像节点，雕刻遮罩，

⾊彩管理 Freestyle 层 & 通道 渲染输出 合成 简介 侧栏 节点类型 运动跟踪 & 遮罩 简介 运动追踪 遮蔽 视频编辑 简介 Setup Your Project Edit Your Project 资产、⽂件 & 数据系统 简介 Blender ⽂件 数据块 关联库 资产库 媒体格式 导⼊ & 导出⽂件 插件 插件类别列表 ⾼级 命令⾏ 脚本与扩展Blender 顶点权重组修改器、 3D ⾳频和视频、bug 修复。 2.61 -- 2011年12⽉: 添加Cycles渲染引擎⾄主⼲，新增相机追踪，借助⽹格接触/靠近修改纹理 的动态绘制，模拟海⾯和泡沫的洋⾯修改器，新的插件，bug修复，以及添 加了更多Python API扩展。 2.62 -- 2012年2⽉: 添加 Carve library 以改进布尔操作，增加了对物体追踪的⽀持，新增重构 ⽹格修改器，游戏引擎⼤量改进，Python 合并Bmesh到主⼲，开启n边多边形的全⾯⽀持，雕刻隐藏，为Cycles准备 的全景相机，镜⼦球环境纹理和浮点数精度纹理，渲染层遮罩层、环境光 遮蔽和背景图像与渲染层的视⼜显⽰，新增新的导⼊和导出插件，和 150 处bug 修复。 2.64 -- 2012年10⽉: 遮罩编辑器，改进的运动跟踪器，OpenColorIO，Cycles渲染器改进，序列 编辑器改进，更好的⽹格⼯具(插⼊和倒⾓改进)，新抠像节点，雕刻遮罩，

灯光 材质 着⾊节点 ⾊彩管理 Freestyle 层 & 通道 渲染输出 合成 简介 侧栏 节点类型 运动跟踪 & 遮罩 简介 运动追踪 遮罩 视频编辑 简介 设置你的项⽬ 编辑您的项⽬ 资产、⽂件 & 数据系统 简介 Blender ⽂件 数据块 关联库 资产库 媒体格式 导⼊ & 导出⽂件 插件 插件类别列表 ⾼级 命令⾏ 脚本与扩展Blender 应⽤模板 键位映射⾃定义 顶点权重组修改器、 3D ⾳频和视频、bug 修复。 2.61 -- 2011年12⽉: 添加Cycles渲染引擎⾄主⼲，新增相机追踪，借助⽹格接触/靠近修改纹理 的动态绘制，模拟海⾯和泡沫的洋⾯修改器，新的插件，bug修复，以及添 加了更多Python API扩展。 2.62 -- 2012年2⽉: 添加 Carve library 以改进布尔操作，增加了对物体追踪的⽀持，新增重构 ⽹格修改器，游戏引擎⼤量改进，Python 合并Bmesh到主⼲，开启n边多边形的全⾯⽀持，雕刻隐藏，为Cycles准备 的全景相机，镜⼦球环境纹理和浮点数精度纹理，渲染层遮罩层、环境光 遮蔽和背景图像与渲染层的视⼜显⽰，新增新的导⼊和导出插件，和 150 处bug 修复。 2.64 -- 2012年10⽉: A mask editor was added, along with an improved motion tracker,

着⾊节点 ⾊彩管理 Freestyle 层 & 通道 渲染输出 合成 简介 侧栏 GPU合成器 节点类型 运动追踪 & 遮罩 简介 运动追踪 遮罩 视频编辑 简介 设置你的项⽬ 编辑您的项⽬ 资产、⽂件 & 数据系统 简介 Blender ⽂件 数据块 ⾃定义属性 关联库 资产库 媒体格式 导⼊ & 导出⽂件 插件 插件类别列表 ⾼级 命令⾏ 脚本与扩展Blender 应⽤模板 新增重构⽹格修改器，游戏引擎⼤量改进，Python API中的矩阵 和向量改进，新的插件，以及⼤量bug修复。 2.63 -- April 2012: 合并Bmesh到主⼲，开启n边多边形的全⾯⽀持，雕刻隐藏，为 Cycles准备的全景相机，镜⼦球环境纹理和浮点数精度纹理，渲 染层遮罩层、环境光遮蔽和背景图像与渲染层的视⼜显⽰，新增 新的导⼊和导出插件，和 150处bug 修复。 2.64 -- October 2012: 改进，新的蒙⽪修改器，新合成节 点后端，以及很多bug修复。 2.65 -- December 2012: ⽕和烟的改进，各向异性着⾊器加⼊Cycles渲染器，修改器改 进，倒⾓加⼊导圆⾓，新的插件和超过 200 处 bug 修复。 2.66 -- 2013年2⽉: 动态拓扑，刚体模拟，UI和稳定性（包含retina⽀持）改进， Cycles⽑发⽀持，倒⾓⼯具新增顶点倒⾓⽀持， 新的 ⽹格缓存

灯光 材质 着⾊节点 ⾊彩管理 Freestyle 层 & 通道 渲染输出 合成 简介 侧栏 节点类型 运动跟踪 & 遮罩 简介 运动追踪 遮罩 视频编辑 简介 设置你的项⽬ 编辑您的项⽬ 资产、⽂件 & 数据系统 简介 Blender ⽂件 数据块 关联库 资产库 媒体格式 导⼊ & 导出⽂件 插件 插件类别列表 ⾼级 命令⾏ 脚本与扩展Blender 应⽤模板 键位映射⾃定义 顶点权重组修改器、 3D ⾳频和视频、bug 修复。 2.61 -- 2011年12⽉: 添加Cycles渲染引擎⾄主⼲，新增相机追踪，借助⽹格接触/靠近修改纹理 的动态绘制，模拟海⾯和泡沫的洋⾯修改器，新的插件，bug修复，以及添 加了更多Python API扩展。 2.62 -- 2012年2⽉: 添加 Carve library 以改进布尔操作，增加了对物体追踪的⽀持，新增重构 ⽹格修改器，游戏引擎⼤量改进，Python 合并Bmesh到主⼲，开启n边多边形的全⾯⽀持，雕刻隐藏，为Cycles准备 的全景相机，镜⼦球环境纹理和浮点数精度纹理，渲染层遮罩层、环境光 遮蔽和背景图像与渲染层的视⼜显⽰，新增新的导⼊和导出插件，和 150 处bug 修复。 2.64 -- 2012年10⽉: 遮罩编辑器，改进的运动跟踪器，OpenColorIO，Cycles渲染器改进，序列 编辑器改进，更好的⽹格⼯具（插⼊和倒⾓改进），新抠像节点，雕刻遮