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

GRidtoref/mgid2ref

uint16 GRidtoref(int32 ri_id)
ri_id

IN:

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.