dxwrapper Documentation

repository·master·Indexed 22 days ago

https://github.com/elishacloud/dxwrapper

A tool designed to improve compatibility for older games on Windows 10/11 by wrapping DirectX files. It provides graphics conversion (e.g., DirectDraw/Direct3D 1–7 to D3D9), resolution unlocking, FPS limiting, and support for various stub DLLs including ddraw.dll, d3d8.dll, and d3d9.dll.

Tokens
669
Snippets
0
Records
6
Agent score
34%

What's inside dxwrapper

  1. What is DxWrapper and its main features?

    master

    DxWrapper is a tool designed to wrap DirectX files to fix compatibility issues in older games, primarily for running them on Windows 10/11. It works by dropping stub .dll files and a configuration .ini file into a game folder.

    Key Capabilities:

    • Graphics Conversion: Converts DirectDraw/Direct3D 1–7 to D3D9, D3D8 to D3D9, and DirectInput 1–7 to DirectInput 8.
    • Enhancements: Unlocks resolutions (4K+), forces Anti-Aliasing, Anisotropic Filtering, VSync, or Windowed mode.
    • Fixes: FPS limiting, CPU affinity settings, scanline/interlacing removal, and handling of specific rendering bugs (e.g., clip plane caching, environment cube maps).
    • Advanced Modding: Supports ASI loading, hot-patching memory, and launching custom processes.
  2. Install DxWrapper in a game

    master

    DxWrapper is installed by placing specific .dll and .ini files into a game's installation directory.

    1. Download the latest binary release and unzip it.
    2. Identify the required stub .dll for your game (e.g., ddraw.dll, d3d8.dll, d3d9.dll, dsound.dll, or winmm.dll).
    3. Copy the chosen stub .dll from the Stub folder, along with dxwrapper.dll and dxwrapper.ini, into the game's directory containing the main executable. Note: If the executable is in a subdirectory like Bin, Exe, or App, copy the files there.
    4. Edit dxwrapper.ini to enable the necessary settings for your game.

    Warning: Do not attempt to overwrite any .dll files in Windows system directories.

  3. Uninstall DxWrapper

    master

    To remove DxWrapper from a game, simply delete the following files from the game's directory:

    • The DxWrapper .dll files (including the chosen stub .dll).
    • The dxwrapper.ini file.
    • The log file (e.g., dxwrapper-game.log), if present.
  4. Configure DxWrapper settings

    master

    DxWrapper is configured by editing the dxwrapper.ini file located in the game directory. You can enable or disable various features such as resolution unlocking, FPS limiting, or graphics enhancements by modifying the keys in this file.

    For a complete list of available configuration options, refer to the allsettings.ini file provided in the repository or the project's Configuration wiki.

  5. View DxWrapper logs

    master
    DxWrapper generates log files in the same folder as the game executable. The log filename follows the pattern dxwrapper-<executable_name>.log. For example, if the game executable is game.exe, the log file will be named dxwrapper-game.log.
  6. Supported DLLs for wrapping

    master

    DxWrapper can wrap and intercept calls for the following DLLs:

    bcrypt.dll
    cryptbase.dll
    cryptsp.dll
    d2d1.dll
    d3d8.dll
    d3d9.dll
    dciman32.dll
    ddraw.dll
    dinput.dll
    dinput8.dll
    dplayx.dll
    dsound.dll
    dwmapi.dll
    msacm32.dll
    msvfw32.dll
    version.dll
    wininet.dll
    winmm.dll
    winmmbase.dll
    winspool.drv
    wsock32.dll