GRnametoindex/mgn2idx

int32 GRnametoindex(int32 gr_id, const char *gr_name)

gr_id	IN:	General raster interface identifier returned by GRstart
gr_name	IN:	Name of the target general raster image

Purpose	Maps the name of a general raster image to an index.
Return value	Returns the index of the image if successful and FAIL (or -1) otherwise.
Description	In a manner similar to GRreftoindex, this routine is commonly used for the purpose of accessing an image in conjunction with a call to GRselect.
Example	This example illustrates the use of GRnametoindex:

     #include "hdf.h"

     int32 gr_id, ri_id, index;
     char *gr_name;
       ...
     index = GRnametoindex(gr_id, gr_name);
     ri_id = GRselect(gr_id, index);
			  ...

         


 FORTRAN

 integer function mgn2idx(gr_id, gr_name)


 

 integer gr_id


 

 character* (*) gr_name

[Top] [Prev] [Next] [Bottom]

hdfhelp@ncsa.uiuc.edu

HDF User's Reference Manual, Draft 06/09/97, NCSA HDF Development Group.

FORTRAN	integer function mgn2idx(gr_id, gr_name)
	integer gr_id
	character* (*) gr_name