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

GRselect/mgselct

int32 GRselect(int32 gr_id, int32 index)
gr_id

IN:

General raster interface identifier returned by GRstart

index

IN:

Index of the general raster image in the file

Purpose

Selects and returns the identifier for the general raster image identified by the index index.

Return value

Returns the identifier of the selected general raster image if successful or FAIL (or -1) otherwise.

Description

The index supplied by the parameter index is zero-based.

Example

This example illustrates the use of GRselect:

     #include "hdf.h"

     int32 gr_id, ri_id, file_id, index, stat;

     file_id = Hopen("myfile", DFACC_READ, 0);
     gr_id = GRstart(file_id);
     ri_id = GRselect(gr_id, index);
       ...
     stat = GRendaccess(ri_id);
     stat = GRend(gr_id);
     Hclose(file_id);
      
FORTRAN

integer function mgselct(gr_id, index)

integer gr_id, index



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

hdfhelp@ncsa.uiuc.edu
HDF User's Reference Manual, Draft 06/09/97, NCSA HDF Development Group.