cgm_to_starbase(3G)

NAME

cgm_to_starbase − interpret a cgm picture

SYNOPSIS

C Syntax:

void cgm_to_starbase ( fildes, source, picture_number );
int fildes, picture_number;
char *source;

FORTRAN77 Syntax:

subroutine cgm_to_starbase ( fildes, source, picture_number )
integer*4 fildes, picture_number
character*(*) source

Pascal Syntax:

procedure cgm_to_starbase ( fildes:integer; var source:string255; picture_number:integer );

DESCRIPTION

Input Parameters

fildes Integer file descriptor returned by gopen when an I/O path to a graphics device is opened.

source Pathname of the cgm file.

picture_number
Picture number in metafile to be interpreted.

Discussion

CGM is a graphical data base suitable for the storage and retrieval of picture information in a way that is compatible between devices of differing capabilities and design.

cgm_to_starbase reads the cgm file specified by source and interprets pictures in the metafile by converting cgm elements into starbase. The picture, picture_number, is interpreted and output to the device specified by fildes. The first picture in the cgm corresponds to picture_number, equal to one. The second picture in the cgm corresponds to picture_number, equal to two, and so on up to the number of pictures in the metafile. inquire_cgm can be called to obtain the number of pictures in the metafile as well as other information about the metafile.

<common>/lib/libcgm.a (the actual path name of the directory given in angle brackets depends on the file system structure; see the Graphics Administration Guide for details) must be linked to this program if the program is linked with archive libraries. If the program uses shared libraries, link in <common>/lib/libcgm.sl. See CGM in the Starbase Graphics Techniques manual.

Museum

Related Articles