Syntax

[C/C++:]
void gOpenCGMFile(int code, GFILE *fp, int mode, int errlev);

[F90:]
subroutine gOpenCGMFile(code, unit, mode, errlev)
integer, intent(in) :: code,unit,mode,errlev

Arguments

code
CGM encoding type

= GCGMCHAR,

Character encoding

= GCGMBINARY,

Binary encoding

fp
GINO-C file pointer

unit
Fortran 90 file unit

mode
Interpretation mode

= GABSOLUTE ,

Metric metafiles are drawn the same size that they were generated

= GMAPPED,

Abstract and Metric metafiles are scaled to fit the current window limits

= GTRANSFORMED,

Same as GABSOLUTE subject to current  transformation

errlev
Error checking level

= GOFF,

No error checking

= GFAST,

Fast error checking

= GFULL,

Full error checking

Description

The routine gOpenCGMFile() is used to open a CGM metafile for interpretation element by element.

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

The metafile may be either character or binary encoded but the interpreter must be informed of which through the code argument.

The routines gGetCGMElement(), gInterpretCGMElement() and gSkipCGMElement() are used to get the next element, interpret it, or skip over it respectively. The file is closed with gCloseCGMFile().

Abstract metafiles are drawn such that one VDC unit = one GINO picture unit in GABSOLUTE and GTRANSFORMED modes.

The interpretation may alter the current state of GINO in that the colour table may be changed within a metafile, but all line and character attributes, window and transformation states are restored at the end of a metafile.

See Also

gOpenCGMFile Usage
gFopen

---