inquire_cgm(3G)

NAME

inquire_cgm − inquire picture information from a cgm

SYNOPSIS

C Syntax:

void inquire_cgm(source,encoding,num_pictures)
char *source;
int *encoding,*num_pictures;

int inquire_cgm_names(source,start,count,response)
char *source;
int start, count;
char response[][256];

FORTRAN77 Syntax:

subroutine inquire_cgm(source,encoding,num_pictures)
character*(*) source
integer*4 encoding,num_pictures

integer*4 function inquire_cgm_names(source,start,count,response)
character*(*) source
integer*4 start, count
character*256 response(count)

Pascal Syntax:

procedure inquire_cgm (var source: string255; var encoding, num_pictures: integer);

function inquire_cgm_names (var source: string255;start, count: integer; var response: array[lo..hi:integer] of string255):integer;

DESCRIPTION

Input Parameters

source Pathname of the cgm file.

start Integer value indicating the picture number at which to start the picture names report.

count Integer value, equal to the number of picture names to report.

Output Parameters

encoding CGM_BINARY if the cgm is encoded in binary or TOP format. CGM_CHARACTER if the cgm encoded in character format. CGM_CLEAR_TEXT if the cgm is encoded in clear text format.

num_pictures The number of pictures stored in the metafile.

response Array holding the names of the pictures in the cgm.

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.

Inquire_cgm reads the cgm file specified by source and returns the encoding format and number of pictures in the metafile.

Inquire_cgm_names reads the cgm file specified by source and returns up to count metafile picture names in response, starting with picture number start. The function returns the actual number of metafile picture names returned. Picture number zero in the cgm is the metafile name. Picture number one in the cgm is the name of the first picture, picture number two is the name of the second picture, and so on up to the number of pictures in the metafile. Names will be truncated to 255 characters.

/usr/lib/libsbcgm.a must be linked to this program. See CGM in the Starbase Graphics Techniques manual.

Museum