[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.