|
|
|
|
SwitchPhysicalResolution
Switches the physical resolution and refresh rate for a display mode
Declaration
N_int32 NAPI GA_initFuncs::SwitchPhysicalResolution(
N_int32 physicalXResolution,
N_int32 physicalYResolution,
N_int32 refreshRate)
Prototype In
snap/graphics.h
Parameters
physicalXResolution |
New physical X resolution to program |
physicalYResolution |
New physical Y resolution to program |
refreshRate |
New refresh rate to program |
Return Value
0 on success, -1 on failure
Description
This function is used to switch the physical resolution or refresh rate for the current display mode. This will be done in a non-destructive manner such that the screen and current hardware acceleration state are preserved. This function is used primarily to enable and disable different levels of hardware panning or 'zooming' in the display driver (ie: 640x480 physical display resolution, 1024x768 virtual). It can also be used to change the refresh rate without changing the physical resolution.
If the physicalXResolution or physicalYResolution parameters are set to -1, the physical resolution of the screen is obtained from the physical resolution of the currently active display mode, otherwise the passed in values are used. The refresh rate is always used, but if you pass in a value of 0, the default refresh rate for the current display mode will be used to program the hardware.
See Also
PollForDisplaySwitch, PerformDisplaySwitch, SwitchPhysicalResolution
Copyright © 2002 SciTech Software, Inc. Visit our web site at http://www.scitechsoft.com