									    
Copyright 1996-2002 Vincenzo MORELLO

This note applies to the DOS BGI implementation of the MGUI library.

By default the compiled program uses standard VGA 640x480 16 color mode. The
library contains the 'egavga.obj' bgi driver which is always linked to your
program. This makes it possible to create standalone applications.
If you need an higher resolution or a greater number of colors, you can try
to use the SVGA BGI driver (post it in 'mgui\sys'): 

- svga256.bgi   Up to 1280x1024 256 color.

This file is part of an archive named SVGA55 (Copyright by JORDAN
HARGRAPHIX SOFTWARE) downloadable from SimTel/msdos/borland.
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, 1024 and 1280 for the
screen width, 4, 8, 15 and 16 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 1024x15'
to achieve 1024x768 32k color.
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 which the mouse button is pressed on.

If a memory allocation error occurs inside the library code, this often causes
an unrecoverable error, so the program terminates. Since DOS uses only 640K of
memory, you should care of destroying unneeded MGUI Objects and Pixmaps.

Notice that the DOS BGI implementation of the MGUI library offers very low
performance in text drawing primitives, so text scrolling is very inefficient!
If you need high performance text drawing in the DOS environment, you should
use the GRX 2.3 (http://www.gnu.de/software/GRX/) based MGUI version.
It is supports Borland DOS real mode, Watcom 11.0 DOS/4GW and DJGPP
(downloadable from 'SimTel/vendors/djgpp').
 
In order to create a BGI MGUI program you have to link the following
libraries in the MGUI distribution:

- \mgui\lib\bc.45\dos\bgimgui.lib
- \mgui\lib\bc.45\dos\mgui.lib
- \mgui\lib\bc.45\dos\mgpp.lib (only for c++ programs)
