Kicad 4.0 Plugins

《Ki Cad 4.0 插件》文档主要介绍了 Ki Cad 的插件系统，重点阐述了如何开发 Ki Cad 的 3D 插件，并通过示例代码演示了插件的实现过程。以下是文档的核心内容总结： --- ### 1. **插件功能概述** - 插件可以为 Ki Cad 提供支持的文件扩展名列表，并自定义文件筛选器，以增强 3D 模型文件选择对话框的功能。 - 插件可以通过 SceneGraph API 创建和操作 3D 数据结构，但本文档中的示例插件（`DEMO1`）主要用于演示插件的基本实现，不涉及渲染功能。 --- ### 2. **插件开发接口** 插件需要实现以下关键接口： - `GetKicadPluginName`：返回插件的名称。 - `GetPluginVersion`：返回插件的版本信息。 - `GetNExtensions`：返回插件支持的文件扩展名数量。 - `GetModelExtension`：返回插件支持的文件扩展名。 - `GetNFilters`：返回插件提供的文件筛选器数量。 - `GetFileFilter`：返回插件提供的文件筛选器。 - `CanRender` 和 `Load`：用于渲染功能，本文档中的示例插件未实现这些接口。 --- ### 3. **示例插件 DEMO1** - **功能**：仅提供支持的文件扩展名和文件筛选器，不实现渲染功能。 - **代码结构**：通过 `file_data` 结构体定义支持的扩展名和筛选器。 - **关键代码**： ```cpp static struct FILE_DATA { char const* extensions[NEXTS]; char const* filters[NFILS]; } file_data; ``` - `NEXTS` 和 `NFILS` 分别表示支持的扩展名数量和筛选器数量。 - `file_data` 初始化支持的扩展名和筛选器。 --- ### 4. **插件构建步骤** - **目录结构**：创建源代码目录（`src`），并在其中添加插件源文件。 - **CMake 配置**： - 通过 `find_package(KICAD 1.0 REQUIRED)` découvrir Ki Cad 安装的头文件和库。 - 添加插件名为 `s3d_plugin_demo1` 的动态库。 - **实现代码**：在 `s3d_plugin_demo1.cpp` 中定义插件名称、版本信息以及支持的文件扩展名和筛选器。 --- ### 5. **SceneGraph API** - **功能**：用于创建和操作 3D 数据结构，如形状（`Shape`）、面（`Face`）、坐标（`Coord`）、法线（`Normal`）等。 - **示例**： - 通过 `NewNode` 和 `AddCoord` 创建形状和坐标。 - 通过 `AddIndex` 和 `AddNormal` 定义面和法线。 - 通过 `SetSpecular`、`SetDiffuse` 和 `SetAmbient` 定义材质。 --- ### 6. **其他信息** - **版权信息**：文档采用 GNU General Public License 或 Creative Commons Attribution License。 - **反馈渠道**：包括 Ki Cad 文档、软件和国际化问题的反馈链接。 --- ### 总结 本文档详细介绍了 Ki Cad 插件的开发基础，通过示例代码展示了如何实现一个基本的 3D 插件，并探讨了 SceneGraph API 的使用。插件开发者可以根据文档中的接口和示例，快速上手 Ki Cad 插件的开发工作。