GA_addMode
Add a custom display mode to the device driver.
Declaration
ibool NAPI GA_addMode(
GA_devCtx *dc,
N_int32 xRes,
N_int32 yRes,
N_int32 bits,
N_int32 saveToDisk)
Prototype In
snap/graphics.h
Parameters
dc |
Device context for driver to add mode to |
xRes |
X resolution of the mode to add |
yRes |
Y resolution of the mode to add |
bits |
Bits per pixel for the mode to add |
saveToDisk |
True if the mode profile should be saved to disk |
Return Value
True on success, or false if the mode could not be added.
Description
This function is used to add a new display mode to a device. By default a standard table of display modes is available in the device, however this function allows the user to create custom display modes and add those to the SNAP drivers.
Unless you pass a value of true to the saveToDisk parameter, the changes will only affect the currently loaded copy of SNAP and will not affect new versions of SNAP that are loaded from disk. To make the change permanent, you need to set this parameter to true.
Note: In order to enable support for the newly added mode for VESA VBE applications, you must also call the GA_enableVBEMode for the same resolution and color depth before it will show up.
See Also
Copyright © 2002 SciTech Software, Inc. Visit our web site at http://www.scitechsoft.com