| Index: ReadMe.md |
| — | — | @@ -1,3 +1,4 @@ |
| | 2 | +<!--Please enable Word Wrap in Notepad to view this document.-->
|
| 2 | 3 | # DXGL 0.5.17
|
| 3 | 4 | https://dxgl.org
|
| 4 | 5 |
|
| — | — | @@ -5,10 +6,19 @@ |
| 6 | 7 | DXGL is a free replacement for the Windows ddraw.dll library, running on OpenGL. It is designed to overcome driver bugs, particularly in Windows Vista and newer operating systems. It also adds various enhancements to the graphics output such as display scaling and filtering options. DXGL supports the DirectX 7.0 graphics APIs, however it is currently under development and many programs are not yet compatible with DXGL.
|
| 7 | 8 |
|
| 8 | 9 | ## Updgrade notes
|
| 9 | | -If you upgrade from DXGL 0.5.8 or earlier, the configuration format will be changed, and earlier versions of DXGL will no longer recognize the profiles.
|
| 10 | | -In addition, any profiles generated by older versions of DXGL going forward will not be recognized by DXGL 0.5.9 or later.
|
| 11 | | -If you wish to migrate any old profiles generated after installing DXGL 0.5.9 or later, you will need to use Regedit to delete the "Configuration Version" registry value from the HKEY_CURRENT_USER\SOFTWARE\DXGL registry key to force the upgrade to be run again.
|
| | 10 | +### DXGL 0.5.8
|
| | 11 | +If you upgrade from DXGL 0.5.8 or earlier, the configuration format will be changed, and earlier versions of DXGL will no longer recognize the profiles. In addition, any profiles generated by older versions of DXGL going forward will not be recognized by DXGL 0.5.9 or later. If you wish to migrate any old profiles generated after installing DXGL 0.5.9 or later, you will need to use Regedit to delete the “Configuration Version” registry value from the HKEY_CURRENT_USER\SOFTWARE\DXGL registry key to force the upgrade to be run again. In order to re-run the upgrade, re-run the DXGL installer.
|
| 12 | 12 |
|
| | 13 | +### DXGL 0.5.13
|
| | 14 | +DXGL 0.5.13 fixes up the default value for the “Add color depths” option, because version 0.5.12 and earlier had a default not compatible with current versions. This one-time conversion resets the value for AddColorDepths in the registry entries to 1+4+16 which corresponds to enabling color depths 8-bit, 16-bit, and 32-bit, in order to ensure compatibility with Windows 8 and above.
|
| | 15 | +
|
| | 16 | +The “Configuration Version” registry value in HKEY_CURRENT_USER\SOFTWARE\DXGL will be incremented to 2 in order to indicate this fix has been applied.
|
| | 17 | +
|
| | 18 | +### DXGL 0.5.17
|
| | 19 | +Due to a bug found in the method used to uniquely identify profile paths, DXGL 0.5.17 and above will perform a one-time renaming of the profile registry keys. These new profiles will no longer be compatible with DXGL 0.5.16 or below.
|
| | 20 | +
|
| | 21 | +The “Configuration Version” registry value in HKEY_CURRENT_USER\SOFTWARE\DXGL will be incremented to 3 in order to indicate this fix has been applied. If you need to migrate more version 2 profiles, change “Configuration Version” to 2 and re-run the installer.
|
| | 22 | +
|
| 13 | 23 | ## GitHub Notice
|
| 14 | 24 | If you downloaded the DXGL source code from GitHub, please note that when compiling DXGL, the version number will not indicate the revision number. This issue is also present when compiling from a zipped source code distribution from the dxgl.org, www.dxgl.info, or www.williamfeely.info website.
|
| 15 | 25 |
|
| — | — | @@ -33,6 +43,7 @@ |
| 34 | 44 | * TortoiseSVN (to fill in revision on SVN builds)
|
| 35 | 45 | * HTML Help Workshop (to build help)
|
| 36 | 46 | * NSIS (to build installer, requires TortoiseSVN and HTML Help Workshop to succeed)
|
| | 47 | +* In addition Visual C++ 2005 and Visual C++ 2008 project files are available in the vs8 and vs9 directories respectively.
|
| 37 | 48 |
|
| 38 | 49 | ## Build Instructions
|
| 39 | 50 | These instructions assume that you do not have any of the required software installed. If you already have any or all of this software installed and set up, skip those steps.
|
| — | — | @@ -43,6 +54,14 @@ |
| 44 | 55 | * Install NSIS from https://nsis.sourceforge.io/Main_Page
|
| 45 | 56 | * Open the dxgl.sln file, select your build configuration (Debug or Release) in the toolbar, and press F7 to build.
|
| 46 | 57 |
|
| | 58 | +## Debug tracing
|
| | 59 | +The Debug Trace build has been removed from the project files for DXGL. Instead, DXGL now supports debug tracing files in all builds. To enable tracing in DXGL create a file named dxgl.cfg or dxgl.ini in you game folder and add the following to it:
|
| | 60 | +```
|
| | 61 | +[debug]
|
| | 62 | +DebugTraceLevel=3
|
| | 63 | +```
|
| | 64 | +This can be added to the [debug] section of any existing configuration file. Change back to 0 to disable tracing.
|
| | 65 | +
|
| 47 | 66 | ## Progress
|
| 48 | 67 | For detailed progress information, please check https://www.williamfeely.info/wiki/DXGL_Features
|
| 49 | 68 | What works:
|
| Index: common/releasever.h |
| — | — | @@ -5,7 +5,7 @@ |
| 6 | 6 | #define DXGLMAJORVER 0
|
| 7 | 7 | #define DXGLMINORVER 5
|
| 8 | 8 | #define DXGLPOINTVER 17
|
| 9 | | -#define DXGLBETA 1
|
| | 9 | +#define DXGLBETA 0
|
| 10 | 10 |
|
| 11 | 11 | #define STR2(x) #x
|
| 12 | 12 | #define STR(x) STR2(x)
|
| — | — | @@ -17,6 +17,6 @@ |
| 18 | 18 | 1 - sign non-beta only
|
| 19 | 19 | 2 - sign release only
|
| 20 | 20 | 3 - sign all */
|
| 21 | | -#define SIGNMODE 1
|
| | 21 | +#define SIGNMODE 0
|
| 22 | 22 |
|
| 23 | 23 | #endif //__VERSION_H
|
| Index: ddraw/glDirectDraw.cpp |
| — | — | @@ -1471,8 +1471,8 @@ |
| 1472 | 1472 | if (ddCaps.dwSize < sizeof(DDCAPS_DX3)) TRACE_RET(HRESULT, 23, DDERR_INVALIDPARAMS);
|
| 1473 | 1473 | ddCaps.dwCaps = DDCAPS_BLT | DDCAPS_BLTCOLORFILL | DDCAPS_BLTDEPTHFILL | DDCAPS_BLTFOURCC |
|
| 1474 | 1474 | DDCAPS_BLTSTRETCH | DDCAPS_COLORKEY | DDCAPS_GDI | DDCAPS_PALETTE | DDCAPS_CANBLTSYSMEM |
|
| 1475 | | - DDCAPS_3D | DDCAPS_CANCLIP | DDCAPS_CANCLIPSTRETCHED | DDCAPS_READSCANLINE |
|
| 1476 | | - DDCAPS_OVERLAY | DDCAPS_OVERLAYSTRETCH;
|
| | 1475 | + DDCAPS_3D | DDCAPS_CANCLIP | DDCAPS_CANCLIPSTRETCHED | DDCAPS_READSCANLINE;// |
|
| | 1476 | + //DDCAPS_OVERLAY | DDCAPS_OVERLAYSTRETCH;
|
| 1477 | 1477 | ddCaps.dwCaps2 = DDCAPS2_CANRENDERWINDOWED | DDCAPS2_WIDESURFACES | DDCAPS2_NOPAGELOCKREQUIRED |
|
| 1478 | 1478 | DDCAPS2_FLIPINTERVAL | DDCAPS2_FLIPNOVSYNC | DDCAPS2_NONLOCALVIDMEM;
|
| 1479 | 1479 | ddCaps.dwFXCaps = DDFXCAPS_BLTSHRINKX | DDFXCAPS_BLTSHRINKY |
|
| — | — | @@ -1485,10 +1485,10 @@ |
| 1486 | 1486 | DDSCAPS_FRONTBUFFER | DDSCAPS_OFFSCREENPLAIN | DDSCAPS_PALETTE |
|
| 1487 | 1487 | DDSCAPS_SYSTEMMEMORY | DDSCAPS_VIDEOMEMORY | DDSCAPS_3DDEVICE |
|
| 1488 | 1488 | DDSCAPS_NONLOCALVIDMEM | DDSCAPS_LOCALVIDMEM | DDSCAPS_TEXTURE |
|
| 1489 | | - DDSCAPS_MIPMAP | DDSCAPS_OVERLAY;
|
| | 1489 | + DDSCAPS_MIPMAP;// | DDSCAPS_OVERLAY;
|
| 1490 | 1490 | ddCaps.ddsCaps.dwCaps2 = DDSCAPS2_MIPMAPSUBLEVEL;
|
| 1491 | | - ddCaps.dwMinOverlayStretch = 1;
|
| 1492 | | - ddCaps.dwMaxOverlayStretch = 2147483647;
|
| | 1491 | + //ddCaps.dwMinOverlayStretch = 1;
|
| | 1492 | + //ddCaps.dwMaxOverlayStretch = 2147483647;
|
| 1493 | 1493 | ddCaps.dwCKeyCaps = DDCKEYCAPS_SRCBLT | DDCKEYCAPS_DESTBLT;
|
| 1494 | 1494 | ddCaps.dwZBufferBitDepths = DDBD_16 | DDBD_24 | DDBD_32;
|
| 1495 | 1495 | ddCaps.dwNumFourCCCodes = GetNumFOURCC();
|