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

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.