[Back to Interface] [Prev] [Next]

DF24getimage/d2gimg

intn DF24getimage(char *filename, VOIDP image, int32 width, int32 height)

filename IN:

Name of the HDF file

image OUT:

Pointer to image buffer

width IN:

Number of columns in the image

height IN:

Number of rows in the image

Purpose

Retrieves an image from the next 24-bit raster image set.

Return value

Returns SUCCEED (or 0) if successful and FAIL (or -1) otherwise.

Description

DF24getimage retrieves the image and stores it in an array. If DF24getdims has not been called, DF24getimage finds the next image in the same way that DF24getdims does.

The amount of space allocated for the image should be width x height x 3 bytes.

To specify that the next call to DF24getimage should read the raster image using an interlace other than the interlace used to store the image in the file, first call DF24reqil.

FORTRAN

integer function d2gimg(filename, image, width, height)

character*(*) filename, image

integer width, height



[Back to Interface] [Prev] [Next]

hdfhelp@ncsa.uiuc.edu
HDF Reference Manual - 07/29/98, NCSA HDF Development Group.