Kicad 5.1 Plugins

• 语言: 英语
• 格式: .pdf
• 来源: docs.kicad.org

摘要

文档介绍了KiCad的插件系统，该系统允许通过共享库扩展KiCad的功能。插件系统最初为3D模型查看器开发，以便支持更多类型的3D模型，而不必对KiCad源代码进行重大修改。文档详细介绍了插件的分类、开发流程以及如何通过API接口与KiCad交互。重点介绍了3D插件的开发，包括场景图的构建和渲染，以及如何通过CMake构建插件。

AI总结

# KiCad 5.1 插件系统概述

## 1. 引言
KiCad 插件系统是一个通过共享库扩展 KiCad 功能的框架。其主要优势是无需在开发插件时重新构建 KiCad，从而提高开发效率。插件最初用于扩展 3D 模型查看器的功能，支持更多类型的 3D 模型，后来扩展为支持不同类别的插件。

目前，KiCad 已实现 3D 插件，未来计划开发 PCB 插件以支持数据导入和导出功能。

---

## 2. 插件类
插件按功能领域分为不同的插件类（Plugin Classes），每个插件类针对特定问题域提供独特的接口。

### 2.1 当前插件类
- **PLUGIN_3D**：用于加载和显示 3D 模型数据。
- **PLUGIN_PCB**：计划开发，用于支持 PCB 数据的导入和导出。

### 2.2 插件加载与管理
- KiCad 内部通过插件加载器（Plugin Loader）管理插件的加载和调用。
- 插件加载器负责检查插件与 KiCad 的版本兼容性，并提供插件功能的透明桥接。
- 插件开发者只需实现特定插件类的接口，无需关注 KiCad 内部代码。

---

## 3. 应用编程接口（API）
插件通过 API 实现与 KiCad 的交互。目前主要的 API 包括：

### 3.1 插件类 API
- **Base Kicad Plugin Class**：所有插件必须实现的基本函数，包括：
- 获取插件类名称：`char const* GetKicadPluginClass(void)`
- 获取插件版本信息：`void GetPluginVersion(unsigned char* Major, unsigned char* Minor, unsigned char* Patch, unsigned char* Revision)`
- **3D Plugin Class**：用于 3D 插件的扩展功能，包括模型文件扩展名支持和文件筛选器。

### 3.2 场景图类 API
- 3D 插件需要通过 KiCad 的场景图（Scene Graph）API 将模型数据转换为可视化格式。

---

## 4. 开发步骤
### 4.1 基本 3D 插件
- 通过 CMake 工具构建插件。
- 插件需声明支持的文件扩展名（如 `.wrl`, `.x3d` 等）并提供文件筛选器以增强用户界面。

### 4.2 高级 3D 插件
- 开发更复杂的场景图，用于 KiCad 的 3D 预览器渲染。
- 示例代码展示了如何创建和操作场景图节点（如四面体）。

---

## 5. 其他信息
- 文档基于 KiCad 1.0 版本编写，版权信息和贡献者详见文档末尾。
- 用户可通过指定链接反馈问题和建议。

---

通过 KiCad 插件系统，开发者可以灵活扩展 KiCad 的功能，满足特定需求。