Syntax

[C/C++:]
void gGetDrawing(GFILE *fp, int nseg, int mode, int paper);

[F90:]
subroutine gGetDrawing(unit, nseg, mode, paper)
integer, intent(in) :: unit,nseg,mode,paper

Arguments

fp
GINO-C file pointer

unit
Fortran 90 file unit

nseg
Picture segment number

> 0,	Read specified picture segment

= GALL,

Read all picture segments

mode
Relationship between the size of an object in the metafile and its size on a particular device:

= GABSOLUTE,

The absolute size of an object is the same as that specified in the initial metafile generating program regardless of the current drawing units

= GMAPPED,

The positive quadrant of the metafile drawing area is mapped into the current drawing area (window or viewport limits)

= GTRANSFORMED,

The coordinates of an object on interpretation are the same as those when the file was created, but subject to the current GINO transformation

= GWHOLE,

All four quadrants (positive and negative) of the metafile drawing area are mapped into the current  drawing area (window or device limits)

paper
The paper size to be used:

= GPROGRAM,

The paper size defined in the processing program is used for each drawing interpreted

= GMETAFILE,

The paper size given at the start of each drawing in the %%%%metafile is used

Description

The routine gGetDrawing() interprets a metafile produced by the gSavdra() generator. The output from gGetDrawing() will correspond exactly with the output from the program that created the file. gGetDrawing() restores all the settings of the line and character attributes that were current when each picture segment was opened.

gGetDrawing() can also interpret files produced by gSavpic(). However, gSavpic() does not record the line and character attributes when each segment is opened, so this information cannot be restored by gGetDrawing(). A message is output by gGetDrawing() to warn the user about this.

The metafile should be opened prior to calling this routine using the function gFopen(), with the file pointer or unit number passed as appropriate.

If mode is GMAPPED or GWHOLE, the current transformation is ignored. If mode is out of range, GABSOLUTE is assumed.

See Also

gGetDrawing Usage
Device Drivers
gFopen
gGetPicture

---