fSpy-Blender 使用与配置教程

1. 项目的目录结构及介绍

fSpy-Blender 是一个开源项目，用于将 fSpy 项目文件导入 Blender，创建匹配的相机。项目的目录结构如下：

fSpy-Blender/
├── fspy_blender/          # 包含 Blender 插件的代码
├── readme_images/        # 包含项目说明图片
├── test/                 # 包含测试代码和测试数据
├── .gitignore            # 指定 Git 忽略的文件和目录
├── LICENSE               # 开源协议文件
├── README.md             # 项目说明文件
├── TODO.md               # 待办事项列表
├── build.py              # 构建脚本
├── download-stats.js     # 下载统计脚本
└── run_tests.sh          # 运行测试的脚本

2. 项目的启动文件介绍

项目的启动文件主要是 build.py 脚本，用于构建 Blender 插件。这个脚本通常用于打包和准备插件文件，以便在 Blender 中安装。

3. 项目的配置文件介绍

在 fSpy-Blender 项目中，主要的配置文件是项目根目录下的 README.md。这个文件包含了关于项目的详细说明，包括安装步骤、使用方法、功能介绍等。

以下是 README.md 文件的部分内容，以说明配置和使用过程：

# fSpy-Blender

这是 fSpy 的官方 Blender 导入插件。以下两张图片展示了 fSpy 项目（顶部）和由导入程序创建的匹配 Blender 相机（底部）。

## 开始使用

### 1. 下载插件

下载最新版本的插件（确保下载名为 `fSpy-Blender-x.y.z.zip` 的文件）。

**重要提示：** 对于 macOS 用户，如果你使用 Safari 浏览器，请确保通过右键点击并选择 "下载链接文件" 来下载插件。这样可以防止下载的文件被自动解压。

### 2. 安装插件

打开首选项窗口，选择编辑菜单中的首选项。

选择 "插件" 标签并点击 "安装" 按钮。

选择下载的 zip 文件并点击 "从文件安装插件"。

在插件列表中找到 fSpy 导入器并勾选以启用。

### 3. 导入 fSpy 项目文件

一旦插件安装并激活，可以通过选择 "导入" 菜单中的 "fSpy" 来导入 fSpy 项目文件。这将创建一个与导入的项目文件同名的相机。

## 导入设置

在导入器的文件浏览器底部左侧，有一个导入设置面板。

- 如果勾选 "更新现有导入（如果有）"，则任何以前创建的与项目文件名相同的相机将被更新。如果未勾选，每次导入时都会创建一个新的相机。

- 如果勾选 "导入背景图像"，则 fSpy 项目文件中的图像将被用作 Blender 相机的背景图像。

## 支持旧版 Blender

从版本 1.0.3 开始，插件只兼容 Blender 2.80 及以上版本。如果你使用的是旧版 Blender，请下载插件版本 1.0.2。

以上内容简要介绍了 fSpy-Blender 项目的目录结构、启动文件以及配置文件。用户可以根据这些信息来安装和使用该插件。