Video mode

Chooses how to handle video mode changes.

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

Scales the primary surface to fit the screen, while preserving the original aspect ratio.  If the aspect ratio of the primary does not match the aspect ratio of the display, this will crop the image to fit.

Custom size multiplier

Multiplies the size of the primary surface by the X and Y values specified under “Fixed scaling.”  The image is centered within the screen.

Custom display mode

Switches the display to the mode specified under “Custom resolution” and stretches the image to fit to that mode.

Custom size, centered

Stretches the primary surface to the size specified under “Custom resolution” and centers it on the display.

Custom size multiplier, Custom display mode, and Custom size, centered are implemented in DXGL 0.5.14 and later.