[Top]
[Prev]
[Next]
[Bottom]
GRsetexternalfile/mgsxfil
int32 GRsetexternalfile(int32
ri_id
, const char *
filename
, int32
offset
)
ri_id
IN:
General raster image identifier returned by
GRcreate
or
GRselect
filename
IN:
Name of the file the external dataset will be stored in
offset
IN:
Offset, in bytes, from the beginning of the external file to the image data
Purpose
Specifies that the image data of a general raster image dataset is a special element of an external element. Creates an external image array for a general raster dataset.
Return value
Returns SUCCEED (or 0) if successful and FAIL (or -1) otherwise.
Description
An external image array is one that is stored in a file that is not the file containing the metadata for the image.
GRsetexternalfile
marks the image identified by
ri_id
as one whose data is to be written to the external image array. It can only be called once for each general raster dataset created.
FORTRAN
integer function mgsxfil(ri_id, filename, offset)
integer ri_id, offset
character* (*) filename
[Top]
[Prev]
[Next]
[Bottom]
hdfhelp@ncsa.uiuc.edu
HDF User's Reference Manual, Draft 06/09/97, NCSA HDF Development Group.