Configuration
Configuration for DXGL can be accessed by opening the "DXGL Config" program in the DXGL program group. Configuration is as follows:
Applications
Lists the applications currently using DXGL. Also contains a "Global" entry to set default options.
When a specific application is selected, a gray or filled checkbox or a groupbox set to "(global default)" means that the global setting will be used.
Add...
Adds an application to the DXGL registry and copies the DXGL ddraw.dll file to its installation folder. Requires write permission to the installation folder.
Windows Vista or later may display a UAC prompt.
Remove
Removes the selected application from the DXGL registry and deletes the DXGL ddraw.dll file from its installation folder. Requires write permission to the installation folder.
Windows Vista or later may display a UAC prompt.
Video mode
Selects the method to handle video mode changes using the IDirectDraw::SetDisplayMode API. The following methods are available:
Change desktop resolution
Changes the resolution of the Windows desktop to match the paramaters of SetDisplayMode. The function will return an error if an incompatible mode is attempted.
Stretch to screen
Stretches the primary surface to fill the entire screen.
Aspect corrected stretch
Scales the primary surface to fit the screen, while preserving the original aspect ratio.
Center image on screen
Displays the primary surface as an unscaled image in the center of the screen.
Stretch if mode not found
Attempts to change the desktop resolution. If the mode is not compatible, chooses the closest mode and stretches the primary to the screen.
Scale if mode not found
Attempts to change the desktop resolution. If the mode is not compatible, chooses the closest mode and scales the primary to the screen, preserving aspect ratio.
Center if mode not found
Attempts to change the desktop resolution. If the mode is not compatible, chooses the closest mode and displays the primary in the center of the screen.
Sort video modes
Determines how to sort the video modes returned by IDirectDraw::EnumDisplayModes
Use system order
Lists modes by the order generated by the system and/or DXGL.
Group by color depth
Lists modes in groups of color depth, each group sorted by resolution.
Group by resolution
Lists modes sorted by resolution, with color depths listed in order for each resolution.
Change color depth
Determines whether to change the color depth of the desktop if requested by the application. Use only for testing purposes, leave off otherwise.
Adjust primary resolution
If checked, will create a virtual primary buffer at the screen resolution instead of the normal primary resolution. May cause slowdowns in certain applications or on certain computers.
Can enhance the resolution of 3D applications (not yet implemented).
Add Extra Display Modes
If checked, adds additional, mostly low resolution, display modes to the list generated by IDirectDraw::EnumDisplayModes. Only works if
"Video mode" is not set to "Change desktop resolution."
Support All Color Depths
If checked, adds 8, 15, 16, 24, and 32-bit color modes if not listed by the system. Under Windows 8 or above, this will be enabled by default.
Scaling method
Selects the filter to use for scaling the output when the resolution is different than the desktop resolution,
as well as for blitting operations. The following methods are available:
Nearest
Uses nearest-neighbor scaling.
Bilinear
Uses bilinear scaling. Reduces jagged edges, but may create visual artifacts in some applications. Does not work with 8-bit color except for the full-screen scaling modes.
Custom shader
(not implemented) Uses a custom GLSL pixel shader to display the image.
Shader (primary only)
(not implemented) Uses a custom GLSL pixel shader to display the primary buffer.