XPlane2Blender 项目技术文档

1. 安装指南

1.1 系统要求

• Blender 版本: 2.80 至 2.83。2.90 版本也可以使用，但官方不提供支持。
• XPlane2Blender 版本: 建议使用最新的非 beta 版本，以确保稳定性。

1.2 自动安装步骤

1. 从 GitHub 发布页面 下载最新版本的插件，文件名类似于 io_xplane2blender_4_0_0-rc_1-89_20200910152046.zip。不要下载名为 "Source Code" 的 .zip 文件，也不要解压 io_xplane2blender 的 .zip 文件。
2. 打开 Blender，进入 Preferences，选择 Addons 标签，点击底部的 Install From File...。
3. 使用文件选择器找到下载的 .zip 文件，点击 Install From File...。这将自动解压到插件文件夹。
4. 确保勾选了 Import-Export: Export: X-Plane (.obj) 选项。
5. 即使看到 UI 变化，也要重启 Blender。
6. 开始使用 XPlane2Blender！

1.3 手动安装

如果需要手动安装或备份现有插件，请参考 XPlane2Blender 手册 中的手动安装说明。

2. 项目使用说明

2.1 开始使用

• 观看 XPlane2Blender 介绍视频 并下载示例文件，您将很快开始导出您的第一个网格并在 X-Plane 中查看它。
• 尽管视频中展示的是 Blender 2.79 版本，但 XPlane2Blender 在不同版本之间几乎完全相同。

2.2 导入功能

• 从 4.2.0-Alpha 1 版本开始，添加了一个实验性的导入器，可以从 X-Plane 对象格式 (.obj) 导入模型到 Blender。

3. 项目 API 使用文档

3.1 测试套件

• 普通用户不需要测试套件。测试套件仅对开发者和高级用户有用，特别是那些对源代码进行修改的用户。
• 如果安装了 Python（最好与 Blender 的内部解释器匹配以确保稳定性）并下载了完整的源代码，可以运行测试套件。
• 在 XPlane2Blender 文件夹中，打开命令行并运行以下命令：

  python tests.py --print-fails
  

• 该命令将运行所有测试，直到结束或发生失败。只有失败的测试会打印详细日志。查看 --help 以显示所有标志及其功能。

4. 项目安装方式

4.1 自动安装

• 按照 1.2 自动安装步骤 进行操作。

4.2 手动安装

• 参考 XPlane2Blender 手册 中的手动安装说明。

通过以上步骤，您可以顺利安装并开始使用 XPlane2Blender 插件，将 Blender 中的模型导出到 X-Plane 对象格式 (.obj)。