Kicad 5.1 插件

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

摘要

本文档详细介绍了 KiCad 插件系统，包括插件类的开发、3D 插件的实现以及应用程序编程接口 (API) 的使用。插件系统允许通过共享库扩展 KiCad 功能，避免了重建整个 KiCad 套件的需求，从而提高了开发效率。文档重点介绍了 3D 插件类的实现，包括插件加载器的基类、版本兼容性检查、插件 API 的定义以及场景图类 API 的使用。通过示例教程，展示了如何开发基本和高级的 3D 插件，并提供了构建和使用插件的详细步骤。

AI总结

# KiCad 5.1 插件总结

## 1. 插件系统简介
KiCad 插件系统允许通过共享库扩展 KiCad 功能，无需重建整个 KiCad 套件。插件开发仅需使用 KiCad 源代码树中的一小部分标题文件，显著提高了开发效率。插件最初用于支持多种 3D 模型格式，目前主要用于 3D 模型查看器，未来可能扩展到 PCB 数据导入/导出功能。

## 2. 插件类
插件分为特定领域的插件类，目前仅实现了 3D 插件类（PLUGIN_3D）。
- **PLUGIN_3D 类**：用于从文件加载 3D 模型数据并将其转换为可显示的格式。
- **插件加载器**：负责加载插件并提供版本兼容性检查。插件加载器的代码位于 `plugins/ldr/pluginldr.h` 和 `plugins/ldr/3d/pluginldr3D.h` 中。
- **基类 API**：所有 KiCad 插件必须实现 `kicad_plugin.h` 中定义的基本函数，包括获取插件类名称、API 版本信息和版本兼容性检查。

## 3. 应用程序编程接口（API）
插件通过 API 实现功能：
- **基类 API**：定义了所有 KiCad 插件的基本函数，如 `GetKicadPluginClass` 和 `GetClassVersion`。
- **3D 插件 API**：定义在 `3d_plugin.h` 中，支持模型加载和场景图交互。

## 4. 教程：3D 插件开发
文档提供了两个 3D 插件开发示例：
1. **基本 3D 插件（PLUGIN_3D_DEMO1）**：实现文件过滤功能，增强文件选择对话框的用户体验。
2. **高级 3D 插件（PLUGIN_3D_DEMO2）**：创建包含简单四面体的场景图，演示如何使用 KiCad 的场景图库 `kicad_3dsg`。

## 5. 场景图类 API
场景图类 API 用于构建和管理 3D 模型的可视化数据，所有支持模型可视化的插件都必须使用此 API 将数据转换为场景图格式。

## 6. 总结
KiCad 插件系统为开发者提供了灵活的扩展机制，支持 3D 模型加载和场景图交互。通过插件 API 和加载器框架，开发者可以高效地开发和集成新功能。文档提供了详细的开发指南和示例，帮助开发者快速上手。