GRidtoref/mgid2ref

General raster image identifier returned by GRselect or GRcreate

Purpose	Maps a general raster image identifier to a reference number.
Return value	Returns a general raster image identifier if successful and FAIL (or -1) otherwise.
Description	This routine is commonly used for the purpose of annotating the image or including the image within a vgroup.
Example	This example illustrates the use of GRidtoref in attaching an annotation to an image:

     #include "hdf.h"

     uint16 ref;
			int32 an_id, ann_id, file_id;
			ref = GRidtoref(ri_id);
			an_id = ANstart(file_id);
			ann_id = ANcreate(an_id, DFTAG_RI, ref, AN_DATA_LABEL);
         


 FORTRAN

 integer function mgid2ref(ri_id)


 

 


 

 integer ri_id

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

hdfhelp@ncsa.uiuc.edu

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