Magpie 项目安装和配置指南

Magpie 项目安装和配置指南

Magpie An all-purpose window upscaler for Windows 10/11. 项目地址: https://gitcode.com/gh_mirrors/mag/Magpie

1. 项目基础介绍和主要编程语言

项目基础介绍

Magpie 是一个轻量级的窗口缩放工具，专为 Windows 10/11 设计。它配备了多种高效的缩放算法和滤镜，主要用于增强游戏图形，并使非全屏游戏能够以全屏模式显示。Magpie 支持多种内置算法，包括 Lanczos、Anime4K、FSR、Adaptive Sharpen 等，以及多种 CRT 着色器。

主要编程语言

Magpie 项目主要使用以下编程语言和框架：

• C++: 用于核心功能的实现。
• HLSL (High-Level Shader Language): 用于实现各种效果的计算着色器。
• XAML: 用于构建用户界面，支持亮色和暗色主题。

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

关键技术

• Direct3D: 用于图形渲染和计算着色器的实现。
• WinUI: 用于构建现代化的用户界面，支持多种主题和自定义配置。
• Weblate: 用于项目的本地化工作，支持多语言翻译。

框架

• C++/WinRT: 用于在 C++ 中使用 Windows 运行时 API。
• Fluent Design System: 用于实现现代化的用户界面设计。

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

准备工作

在开始安装和配置 Magpie 之前，请确保您的系统满足以下要求：

• 操作系统: Windows 10 v1903+ 或 Windows 11。
• DirectX 功能级别: 11。
• 开发环境: 安装 Visual Studio 2019 或更高版本，并确保安装了 C++ 开发工具和 Windows SDK。

详细安装步骤

步骤 1: 下载项目源代码

1. 打开浏览器，访问 Magpie 项目的 GitHub 页面：https://github.com/Blinue/Magpie。
2. 点击页面右上角的“Code”按钮，选择“Download ZIP”下载项目的 ZIP 压缩包，或者使用 Git 命令克隆项目：

   git clone https://github.com/Blinue/Magpie.git
   

步骤 2: 解压并打开项目

1. 将下载的 ZIP 压缩包解压到您选择的目录中。
2. 打开 Visual Studio，选择“打开项目或解决方案”，然后导航到解压后的目录，选择 Magpie.sln 文件打开项目。

步骤 3: 配置项目

1. 在 Visual Studio 中，右键点击解决方案资源管理器中的 Magpie 项目，选择“属性”。
2. 在“配置属性”中，确保“平台工具集”设置为与您的 Visual Studio 版本匹配的工具集（例如，Visual Studio 2019 使用 v142）。
3. 在“C/C++” -> “常规”中，确保“附加包含目录”包含所有必要的头文件路径。
4. 在“链接器” -> “常规”中，确保“附加库目录”包含所有必要的库文件路径。

步骤 4: 编译项目

1. 在 Visual Studio 中，选择“生成”菜单，然后选择“生成解决方案”。
2. 等待编译完成，确保没有错误。

步骤 5: 运行和配置 Magpie

1. 编译成功后，按 F5 键或点击“调试”菜单中的“开始调试”运行项目。
2. 首次运行时，Magpie 会自动生成默认配置文件。您可以在“配置”页面中根据需要调整缩放模式和其他设置。
3. 使用快捷键（默认是 Win+Shift+A）将窗口缩放到全屏模式。

注意事项

• 如果您的系统设置了 DPI 缩放，建议在程序的兼容性设置中将“高 DPI 缩放覆盖”设置为“应用程序”，以避免缩放问题。
• 某些游戏支持窗口缩放，但使用的是非常简单的算法。建议在 Magpie 中选择内置的最佳选项。

通过以上步骤，您应该能够成功安装和配置 Magpie 项目，并开始使用其强大的窗口缩放功能。

Magpie An all-purpose window upscaler for Windows 10/11. 项目地址: https://gitcode.com/gh_mirrors/mag/Magpie