ReShade 开源项目使用教程
ReShade 是一个强大的游戏和视频软件后期处理注入器,它提供了一种自动化的方法来访问帧颜色和深度信息,并引入了名为 ReShade FX 的自定义着色语言,用于创建环境光遮蔽、景深、色彩校正等效果,这些效果在任何地方都适用。此外,ReShade 还能够加载利用 ReShade API 的附加组件(DLL),以扩展其功能以及所应用软件的功能。
1. 项目目录结构及介绍
ReShade 的项目目录结构如下:
reshade/
├── deps # 第三方依赖库
├── examples # 示例代码
├── include # 头文件,包含 ReShade 的核心API和其他必要的接口定义
├── res # 资源文件,如内置的着色器等
├── setup # 安装程序相关文件
├── source # 主要源代码文件夹
│ ├── ...
│ ├── dll_log.cpp # 简单的日志记录实现
│ ├── dll_main.cpp # 主入口点,包括可选的测试应用程序
│ ├── ...
│ └── runtime_gui.cpp # 用户界面相关的渲染和管理
├── tools # 工具相关源码
├── .editorconfig # 编辑器配置文件
├── .gitignore # Git忽略文件列表
├── .gitmodules # 子模块配置
├── Common.props # 公共编译属性设置
├── Doxyfile # 用于生成API文档的Doxygen配置文件
├── FUNDING.yml # 支持项目的赞助配置
├── LICENSE.md # 许可证文件
├── README.md # 项目读我文件,包含概述和入门指南
└── REFERENCE.md # ReShade API参考文档
2. 项目启动文件介绍
主要的启动文件是 dll_main.cpp
,它是 DLL 的入口点。这个文件不仅负责初始化 ReShade 库,而且当作为测试应用程序运行时,还提供了基础的执行环境。通过这个入口点,ReShade 能够插入到目标游戏中,开始其后处理功能。
3. 项目的配置文件介绍
ReShade 的配置并不是通过单独的文件进行的,而是通过其提供的用户界面或命令行参数来调整。然而,用户可以自定义预设(presets)来保存和加载特定的着色器设置,这些通常以 .reshadepreset
文件形式存在,存储于用户的配置目录下。此外,开发者在构建自己的项目或修改 ReShade 时,可能需要关注 Common.props
和 .editorconfig
文件,前者影响项目的编译属性,后者指导编辑器保持代码风格的一致性。
构建与配置指南简述
为了编译 ReShade,你需要 Visual Studio 2017 或更高版本以及 Python(由于 gl3w 依赖)。通过以下命令克隆项目及所有子模块:
git clone --recurse-submodules https://github.com/crosire/reshade.git
然后,在Visual Studio中打开解决方案,选择目标平台(32位或64位)并构建解决方案。对于安装程序的构建,则需先分别构建两个架构的Release配置,之后再构建Release Setup配置。
请注意,详细的开发和配置步骤在项目 README.md
中有更详尽的说明。