PureRef格式化工具安装与配置指南

1. 项目基础介绍

PureRef格式化工具是一个开源项目，它提供了一个Python脚本，用于自动化生成PureRef的.pur文件。这种文件格式通常用于组织和查看图像参考，特别适用于艺术家、设计师和游戏开发者。该项目允许用户从包含图像的文件夹中创建有序的.pur文件，也可以将.pur文件转换成其他格式。主要编程语言为Python。

2. 项目使用的关键技术和框架

本项目使用了Python语言，其中涉及到的主要技术和框架包括：

• Python标准库：用于文件操作、路径处理等。
• 图像处理库：可能使用了Pillow等库来处理图像文件。

3. 项目安装和配置的准备工作及详细步骤

准备工作

在开始安装之前，请确保您的系统中已安装以下内容：

• Python：至少Python 3.8.10版本，并在安装时勾选了“将Python添加到环境变量”的选项（对于Windows用户）。
• 命令提示符或终端：用于运行Python脚本。

安装步骤

1. 克隆项目仓库

   打开命令提示符或终端，使用以下命令克隆项目仓库到本地：

   git clone https://github.com/FyorDev/PureRef-format.git
   

2. 进入项目目录

   克隆完成后，进入项目目录：

   cd PureRef-format
   

3. 运行脚本

   在项目目录中，运行以下命令来生成.pur文件：

   python pureref_gen_script.py
   

   如果不提供任何参数，该脚本会在当前目录下创建“Artists”和“Purs”两个新文件夹。将包含图像的文件夹放入“Artists”文件夹中，然后再次运行脚本，每个艺术家文件夹中的图像将被整理并生成对应的.pur文件，存放在“Purs”文件夹中。

4. 指定输入输出文件夹（可选）

   如果需要指定特定的输入输出文件夹，可以使用以下命令：

   python pureref_gen_script.py <输入文件夹> <输出文件夹>
   

   请将<输入文件夹>和<输出文件夹>替换成实际的文件夹路径。

5. 注意事项

   • 如果.pur文件已经存在，则脚本会跳过该文件，不会重新生成。如果需要重新生成，请先删除现有的.pur文件。
   • 如果输入文件夹中没有子文件夹，并且包含图像文件，脚本将尝试直接使用这些图像。

按照以上步骤操作，您应该能够成功安装并运行PureRef格式化工具。