									    
Copyright 1996-2000 Vincenzo MORELLO

This note applies to the Watcom DOS/4GW implementation of the MGUI library
using the Watcom graphics library graph.lib.

By default the compiled program uses standard VGA 640x480 16 color mode.
In order to run your program in SVGA mode, you should set the environment
variable 'MGUIRES' to the desired screen width and screen depth;
for example:

SET MGUIRES=1024x8

will set a screen width of 1024 pixels (1024x768) and a screen depth of 8
planes (256 colors). Permitted values are 640, 800 and 1024 for the
screen width, 4 and 8 for the screen depth.
In addition you can override this variable setting by passing the required
resolution as argument to the program, for example:
'-r 1024x8'
to achieve 1024x768 256 colors.
A minimun of 800x600 256 colors is recommended for the MGUI Designer.

A few window management functions are coded in this version of MGUI library.
These are window moves, close, maximize/restore and the following keystroke
actions:

<Alt+F10>       causes the active window to be maximized/restored.
<Alt+F4>        generates the window close request.
<Alt+F2>        causes a redraw in all open windows.
<Alt+F1>        circulates windows.
<Alt+drag>      resizes the window on which the mouse button is pressed.

Notice that the Watcom 11.0 version of the graphic library doesn't work
on my ATI mach64 cards at screen depth of 8 (256 colors). This problem
doesn't occur linking the 10.0 version of graph.lib.
Due to an inefficiency of the _setpixel() function running in
256 color mode (especially in a Windows DOS box), text drawing is very slow.

If you want to get better graphics performance under DOS/4GW, use the
GRX (http://www.gnu.de/software/GRX/) based version of the MGUI library.

In order to create a Watcom GL MGUI program you have to link the following
libraries in the MGUI distribution:

- wglmgui.lib
- watmgui.lib
- watmgpp.lib (only for c++ programs)
