DXVK Native 技术文档

DXVK Native 技术文档

DXVK Native 是一个将 DXVK 移植到 Linux 平台的项目，它使得游戏和应用程序能在原生环境下运行，无需借助 Wine。此文档旨在提供全面的指导，帮助开发者和用户了解并使用 DXVK Native。

安装指南

系统需求

• 支持 C++17 的编译器（如 GCC, Clang 或 MSVC）
• Meson 构建系统（版本至少为 0.46）
• glslang 编译器

使用 Steam Runtime 构建 (可选)

对于希望在 Steam Runtime 环境下构建的用户：

• 对于 32 位环境，执行以下命令：

  docker run -e USER=$USER -e USERID=$UID -it --rm -v $(pwd):/dxvk-native registry.gitlab.steamos.cloud/steamrt/scout/sdk/i386 /bin/bash
  

• 对于 64 位环境，则使用：

  docker run -e USER=$USER -e USERID=$UID -it --rm -v $(pwd):/dxvk-native registry.gitlab.steamos.cloud/steamrt/scout/sdk /bin/bash
  

在主机上构建库

直接在 DXVK 目录下执行以下命令来构建：

• 不使用 Steam Runtime：

  ./package-native.sh master /your/target/directory --no-package
  

• 使用 Steam Runtime：

  ./package-native-steamrt.sh master /your/target/directory --no-package
  

项目的使用说明

DXVK Native 替换了特定的 Windows 依赖项，例如，Windows 的 HWND 变为了 SDL_Window*，从而使其能在多个平台工作。通常，只需集成到您的渲染器即可使用，但可能遇到一些初期兼容性问题，需要特别注意 __uuidof 的替换使用。

游戏与项目示例

• Portal 2, Left 4 Dead 2 （由 Valve 提供支持的双平台游戏）
• Ys VIII, Ys IX, Perimeter, Momentum Mod, Portal 2: Community Edition 等

API 使用文档

• 配置文件: d3d9_config.h 允许调整 D3D9 的性能设置，比如禁用浮点模拟和验证。
• 环境变量:
  • DXVK_HUD 控制着显示帧率和统计信息的头部显示器(HUD)，允许自定义显示的内容。
  • DXVK_FRAME_RATE 用来限制帧率。
  • DXVK_FILTER_DEVICE_NAME 强制使用指定的 GPU 设备。
  • 更多环境变量可用于状态缓存控制、调试和日志记录等。

API 示例及注意事项

虽然本文档没有详细列出所有API接口细节，但在实际应用中，开发者主要关注的是正确集成 DXVK Native 到其项目中的步骤，以及利用上述提到的环境变量进行调试和配置。

结语

DXVK Native 通过简化跨平台开发流程，特别是对那些原本设计为Windows运行的游戏和应用来说，极大地提高了移植到Linux的可能性。遵循以上指引，您应能够顺利地安装、配置并使用 DXVK Native，在提高游戏体验的同时减少开发复杂度。如果遇到具体的技术难题，查阅项目源代码和最新的文档更新总是好的解决方案。