Kicad 5.1 插件

• 语言: 中文（简体）
• 格式: .epub
• 来源: docs.kicad.org

摘要

文档详细介绍了 KiCad 5.1 的插件系统，包括插件的开发框架、API 接口、插件类的实现以及如何构建和使用插件。插件系统允许开发者通过扩展 KiCad 功能而无需重建整个软件，主要应用于 3D 模型查看器。文档重点介绍了 3D 插件的开发，包括插件类的接口、版本兼容性检查以及如何通过 API 实现插件功能。示例展示了如何开发基本和高级的 3D 插件，并提供了构建和测试的步骤。

AI总结

### Kicad 5.1 插件文档总结

#### 1. 出版信息
- **出版日期**：2016年1月29日
- **软件版本**：Kicad 5.1
- **联系人**：[e-mail]

#### 2. 插件系统简介
- **插件系统**：KiCad 插件系统通过共享库扩展功能，无需重新构建 KiCad，提高开发效率。
- **优势**：
- 减少构建和测试周期时间。
- 支持更多 3D 模型类型，无需对 KiCad 源代码进行重大修改。
- **当前支持**：
- 仅实现 3D 插件类，未来可能开发 PCB 数据导入/导出插件。

#### 3. 插件类
- **分类**：插件按功能域分为不同类，如 3D 模型插件、PCB 数据插件等。
- **3D 插件类**：
- 负责从文件加载 3D 模型数据并转换为可显示格式。
- 实现接口：`GetKicadPluginClass`、`GetClassVersion`、`CheckClassVersion` 等。
- **插件加载器**：
- 基类：`plugins/ldr/pluginldr.h`
- 3D 插件加载器：`plugins/ldr/3d/pluginldr3D.h`
- 负责加载插件并提供版本兼容性检查。

#### 4. 应用程序编程接口（API）
- **插件类 API**：
- 基类：`include/plugins/kicad_plugin.h`
- 3D 插件 API：`include/plugins/3d/3d_plugin.h`
- 插件必须实现基本函数：`GetKicadPluginClass`、`GetClassVersion`、`CheckClassVersion`、`GetPluginName`、`GetPluginVersion`。
- **3D 插件 API**：
- 实现文件加载、过滤和场景图数据生成。
- 示例：`PLUGIN_3D_DEMO1` 和 `PLUGIN_3D_DEMO2` 插件。

#### 5. 教程
- **基本 3D 插件（PLUGIN_3D_DEMO1）**：
- 功能：提供文件扩展名过滤器，增强文件选择对话框。
- 实现：仅返回过滤器，不生成可视化数据。
- **高级 3D 插件（PLUGIN_3D_DEMO2）**：
- 功能：创建包含简单 3D 场景图的插件。
- 实现：生成一对四面体的场景图数据。

#### 6. 版权声明
- 文档由贡献者授权，遵循 GNU GPL 3.0 或 CC BY 3.0 许可证。
- 所有商标归其合法所有者。

#### 7. 贡献者
- 主要贡献者：Cirilo Bernardo

#### 8. 反馈
- 错误报告和建议：
- Kicad 文档：[链接](https://gitlab.com/kicad/services/kicad-doc/issues)
- Kicad 软件：[链接](https://gitlab.com/kicad/code/kicad/issues)
- Kicad 软件国际化：[链接](https://gitlab.com/kicad/code/kicad-i18n/issues)

#### 总结
Kicad 5.1 插件系统提供了灵活的扩展机制，支持 3D 模型和未来可能的 PCB 数据插件开发。通过插件类和 API，开发者可以高效地扩展 KiCad 功能，满足特定需求。文档提供了详细的 API 描述和开发教程，帮助开发者快速上手插件开发。