Syntax
[C/C++:]
void gOpenAuxDrawingArea(int ident, char title[], int xp, int yp, int width, int height);
[F90:]
subroutine gOpenAuxDrawingArea(ident, title, xp, yp, width, height)
integer, intent(in) :: ident
character*(*), intent(in) :: title
integer, intent(in) :: xp,yp,width,height
Arguments
ident
Auxiliary drawing area identifier (>1)
title
Auxiliary drawing area title or banner
xp,yp
Position of drawing area relative to display origin
width,height
Width and height of drawing area
Description
The routine gOpenAuxDrawingArea() creates and opens a visible or invisible auxiliary drawing area, where a device has the possibility of multiple drawing areas or display windows.
Auxiliary drawing areas are arranged in pairs, with the initial drawing area consisting of a visible area with identifier zero and an invisible area or backing store with identifier 1. Additional areas may be created such that every visible area automatically has an associated invisible area, but invisible areas may be created without an associated visible one. When gOpenAuxDrawingArea() is called with an even numbered identifier (
ident) a new visible area or window is created using the remaining arguments to define its title, origin and size together with an associated invisible area of the same size with identifier
ident+1. If gOpenAuxDrawingArea() is called with an odd numbered identifier, a new invisible area is opened of the specified size (
width *
height) ignoring the title and origin settings.
If the identifier is outside the range of possible identifiers for the current device, GINO outputs an error message and no action is taken. The maximum number of areas/windows (in pairs) that can be opened can be obtained through the device enquiry routine gEnqDeviceState(). An error is also generated if a request is made to open a display area that is already open or a request is made to open a visible area where an invisible area of
ident+1 is already open. You must close a display area using gCloseAuxDrawingArea() before re-opening another one with the same identifier. Some devices may only provide invisible drawing areas (ie. additional screen memory) each of which will have an odd numbered identifier. This restriction is identified by the value of
device.maxaux returned by gEnqDeviceState() as being negative.
A visible display area cannot be opened which is larger than the maximum drawing area for the current device. Display resources may prevent the opening of a valid drawing area due to lack of memory or network access.
See Also
gOpenAuxDrawingArea UsagegCloseAuxDrawingAreagEnqDeviceState
