GINO Graphics Suite - GINO v9.0  

gRestoreGinoState

Syntax

[C/C++:]
void gRestoreGinoState(int map);
[F90:]
subroutine gRestoreGinoState(map)
integer, intent(in) :: map

Arguments

map
Restore mapping mode

= GABSOLUTE, Restore without mapping to device limits
= GMAPPED, Map to current device limits (default)

Description

The routine gRestoreGinoState() restores the setting of all GINO's output attributes to the state when the last call to gSaveGinoState() was made. Further details of the attributes stored is documented under gSaveGinoState().

The argument map determines the restoration mapping mode. When map=GABSOLUTE, the viewport parameters will be restored as they were saved by gSaveGinoState(), and therefore no mapping will occur. When map=GMAPPED, the viewport parameters will be mapped to the current device limits so that the same portion of the drawing area will be used on the current device. This mode is useful when restoring a set of GINO attributes onto a different device from which they were saved and which may have different device limits. Any subsequent drawing will then be automatically mapped onto the device without having to change coordinate system.

As implied by the previous paragraph, GINO attributes may be saved across device nominations. The set of attributes are also saved on a stack, so gRestoreGinoState() will always restore the last set of saved attributes.

See Also

gRestoreGinoState Usage
gSaveGinoState