Supported Browsers Home   
EDID_parse Previous   
GA_addRefresh Next   
External Functions Up   

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

GA_addRefresh, GA_delMode, GA_enableVBEMode

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