DXGL Config Applications Add... Remove Video mode Sort video modes Change display color depth Adjust primary resolution Add Extra Display Modes Support All Color Depths Scaling method (first pass) 1st pass scale size Scaling method (final pass) Screen aspect ratio DPI scaling mode Fullscreen window mode

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.

Crop to screen

(Experimental) Crops the output to the screen. Currently in development.

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, 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 (1st pass)

Scaling method for an optional image scaling pass. This can be used to create a pixelated effect while still preserving the ability to have filtered display scaling. The following methods are available:

Nearest

Uses nearest-neighbor scaling.

Bilinear

Uses bilinear scaling. 8-bit display modes will always use nearest scaling for this pass.

1st pass scale size

Selects the amount to scale the display on the first pass. There is an Auto preset as well as presets for fixed 1x, 2x1, 2x, 3x, and 4x ratios. In addition, a ratio can manually be set anywhere from 0.25x0.25 to 16x16. The Auto preset will automatically double pixels horizontally if the horizontal resolution is 400 pixels or less, and will double pixels vertically if the vertical resolution is 300 or less. In addition, if Video mode is set to Change desktop resolution and Add extra display modes is enabled, a subset of low resolution pixel doubled modes will be added.
If "Adjust primary resolution" is checked, typing 0.5 in the box will enable 2x2 supersampling for Direct3D applications. This will also modify the behavior of "Change desktop resolution."

Scaling method (final pass)

Selects the filter to use for scaling the output when the resolution is different than the desktop resolution, or when the optional 1st pass scaling is in effect, the scaled resolution is different from 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. Blitting operations are always nearest mode in 8-bit.

Screen aspect ratio

Overrides the aspect ratio for "Aspect corrected stretch" and "Scale if mode not found". Enter as x:y or as a floating point ratio, for example 4:3 or 1.333333, or select a preset from the dropdown list. Default uses a square pixel ratio.

DPI scaling mode

Fixes errors caused by Windows High DPI scaling in Windows Vista and greater. This option is always set to Enabled on older operating systems, as these operating systems apply high DPI modes to all applications.

Disabled

Disables the DPI scaling fix, unless specified by the program.

Enabled

Default setting. Enables the DPI scaling fix during program initialization.

Windows AppCompat

Sets a compatibility flag to tell Windows to fix High DPI scaling. Use if Enabled does not work.

Fullscreen window mode

Sets the mode to be used when creating a window for fullscreen mode.

Exclusive fullscreen

Sets the display to fullscreen mode. For Windows Vista and greater, causes the Windows graphics to be temporarily suspended, giving the GPU exclusive control of the screen. This mode is the default and may have the best fullscreen performance.

Non-exclusive fullscreen

Creates a window that fills the screen but tells the display driver not to take exclusive control of the screen. Try this mode if the application mixes DirectDraw with GDI and some graphics elements are missing. In Windows Vista and greater, this mode may have reduced performance, increased lag, or choppy graphics. In Windows 8 and 8.1, this performance reduction may be significant due to an operating system flaw.

Non-resizable window

Forces the fullscreen application to display in a floating window. Please note that some applications may capture the mouse and thus may cause compatibility issues.

Resizable window

Forces the fullscreen application to display in a floating window that can be resized or maximized. Please note that some applications may capture the mouse and thus may cause compatibility issues.

Borderless window

Forces the application to display in a borderless pop-up window. If the application is not running at the same resolution as the display, the window will be the same size as the application's display resolution.

Borderless window (scaled)

Forces the application to display in a borderless pop-up window. Sizes the window to fill the screen. Similar to Non-exclusive fullscreen except that the window does not minimize when focus is lost. Depending on the "Video mode" setting, the graphics resolution may be changed to accomodate the application.