The LazyBoy Library Manual - TextMode

Part of the CRT group.

%imacro TextMode 1
Prefers: BX

WARNING: No general registers are preserved.

Change the current video mode and re-intializes the CRT subsystem.

If Mouse support has not been disabled with the %define NO_MICE conditional define and a mouse is present. The mouse will be reset and hidden. A call to MouseShow will be needed to make the mouse visible again.

Common NON-VESA modes:

0x000040x25 Grayscale
0x000140x25 Color
0x000280x25 Grayscale
0x000380x25 Color
0x000780x25 Monochrome
0x0054132x43 Color under the default configuration of DOSBox
0x0055132x25 Color under the default configuration of DOSBox

For other possible text modes below 0x0100 on real hardware, consult the video mode table in Ralf Brown's Interrupt List.

Examples:

    TextMode bx
    TextMode 3
    TextMode 0x010c
    TextMode [USER_MODE]

See also: GetTextMode, ResetMode and RequireTextMode