WineForge DXCompat

WineForge DXCompat is a set of x86_64 PE compatibility components for the D3DMetal backend selected by WineForge. Calls outside their compatibility scope are forwarded to that backend.

The project provides focused compatibility for missing D3DMetal behavior until equivalent support becomes available in GPTK. Individual compatibility paths can then be retired in favor of the native backend implementation.

Current implementation

The current D3D12 frontend addresses a verified Unreal Engine media path where missing NV12 and resource-lifetime behavior caused black video output or application stalls.

The D3D12 frontend currently provides:

• automatic D3D12 Agility SDK activation through the standard application exports and ID3D12SDKConfiguration
• an NV12 facade backed by R8 and RG8 textures
• NV12 format and copyable-footprint handling
• SRV, copy, legacy barrier, and enhanced barrier translation
• resource lifetime and destruction notification for the verified upload resource contract
• passthrough behavior for unrelated D3D12 calls

The D3D11 launcher companion currently provides:

• ID3D11DeviceContext1 context-state switching
• GDI-compatible IDXGISurface access for D3D11 textures
• the D3D10 device bridge used by the validated Rockstar launcher path
• passthrough to the canonical D3DMetal D3D11 implementation

Application selection and backend routing are implemented in WineForge. This repository does not contain application-name routing.

Runtime files

lib/wfdxcompat/
  x86_64-windows/
    d3d12.dll
    d3d12core.dll
    wfdxbackend-d3d12.dll
    wfdx-launchers-v1.dll

d3d12.dll is the compatibility frontend. d3d12core.dll bridges the Agility SDK layered-core exports to the active D3D12 backend. wfdxbackend-d3d12.dll is a Wine loader marker mapped to that backend; it does not contain a graphics implementation. wfdx-launchers-v1.dll is the optional D3D11 launcher companion.

Build

Required tools:

• x86_64-w64-mingw32-clang;
• winebuild.

WineForge builds use the macOS Universal UCRT package available from the llvm-mingw releases page.

Set TOOLCHAIN and WINEBUILD when these tools are not available in PATH.

./build.sh

The build stages the runtime files under lib/wfdxcompat/x86_64-windows.

Documentation

• Developer guide and source map
• Development provenance

Licensing

WineForge DXCompat uses the GNU Lesser General Public License version 2.1 or later (LGPL-2.1-or-later). See the full license text.