| Home
| Previous
| Next
| Up

SetModeProfile

Sets the current mode profile for the graphics device driver.

Declaration

void NAPI GA_initFuncs::SetModeProfile(
GA_modeProfile *profile)

Prototype In

snap/graphics.h

Parameters

profile | Mode profile to make active for the display driver.

Description

This function installs a new mode profile into the driver to be used as the default mode profile. The mode profile is a structure which contains configuration information about the available display resolutions for the installed device driver. A default mode profile is shipped with the graphics device drivers, but a new mode profile can be downloaded at any time. Since SNAP drivers internally do not have any concept of specific display resolutions, the mode profile is used to tell the SNAP driver what specific display resolutions the driver should export to user applications. Hence changing the mode profile can be used to add new display modes, or remove unwanted display modes from the list of display modes supported by the driver.

The mode profile may be made permanent with a call to the GA_saveModeProfile function, to be used every time a SNAP driver is loaded from disk.

Note: All mode in the mode profile must also have the associated CRTC tables added to the CRTC database before it will work (created using GTF if the mode is a new custom display mode).

Note: The dwSize member of the profile structure is intended for future compatibility, and must be set to the size of the structure before calling this function. Only the number of bytes set in the dwSize member will be copied from the callers structure.

See Also

GetModeProfile, GetVideoModeInfo, GA_saveModeProfile

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