| Home
| Previous
| Next
| Up

MGL_registerFullScreenWindow

Registers a user window with the MGL to be used for fullscreen modes

Declaration

void MGLAPI MGL_registerFullScreenWindow(
MGL_HWND hwndFullScreen)

Prototype In

mglwin.c

Description

This function allows the application to create the window used for fullscreen modes, and let the MGL know about the window so it will use that window instead of creating it's own fullscreen window. By default when you create a fullscreen device context, the MGL will create a fullscreen window that covers the entire desktop that is used to capture Windows events such as keyboard events, mouse events and activation events. However in some situations it is beneficial to have only a single window that is used for all fullscreen graphics modes, as well as windows modes (primarily to be able to properly support DirectSound via a single window).

If you have registered a fullscreen window with the MGL, the MGL will take that window, zoom it fullscreen and modify the window styles and attributes to remove the title bar and other window decorations. When the MGL then returns from fullscreen mode back to GDI mode, it will restore the window back to the original position, style and state it was in before the fullscreen mode was created. This allows you to create a single window with the MGL and use it for both windowed modes and fullscreen modes.

Note: When the MGL exits via a call to MGL exit, the fullscreen window that you passed in will be destroyed (necessary to work around bugs in DirectDraw).

Copyright © 2002 SciTech Software, Inc. Visit our web site at http://www.scitechsoft.com