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