MGL_quickInit
Quick initialisation function for first time MGL users.
Declaration
MGLDC * MGLAPI MGL_quickInit(
int xRes,
int yRes,
int bitsPerPixel,
int numPages)
Prototype In
mgraph.h
Parameters
xRes |
Horizontal resolution for the display mode in pixels |
yRes |
Vertical resolution for the display mode in lines |
bitsPerPixel |
Color depth for the display mode |
numPages |
Number of display pages to use |
Return Value
Pointer to a fullscreen display device context.
Description
This function is intended to help first time MGL users get up and running quickly. Using this utility function you can initialise the MGL for use in a fullscreen display mode with a single line of code. Note that this function will automatically bail out with an error message if any of the initialisation code fails, so you don't need to check for error conditions on return from this function.
A small 'Hello World' type application using the MGL might be coded as follows:
int main(void)
{
MGLDC *dc;
event_t evt;
font_t *font;
dc = MGL_quickInit(640,480,8,1);
if ((font = MGL_loadFont("pc8x8.fnt")) ==
NULL)
MGL_fatalError(MGL_errorMsg(MGL_result()));
MGL_useFont(font);
MGL_drawStrXY(0,0,"Hello World!");
EVT_halt(&evt,EVT_KEYDOWN);
MGL_exit();
}
Note: Once you are more familiar with the MGL, we highly recommend you add proper initialisation code to your program usin MGL_init and related functions. Unless your application is running on a dedicated system, it is not usually a good idea to hard code a resolution and color depth into the application, but rather allow the user to select the mode to be used via configuration files or menus.
Note: This function
See Also
Copyright © 2002 SciTech Software, Inc. Visit our web site at http://www.scitechsoft.com