[Top] [Prev] [Next]

7.3 The 24-Bit Raster Interface

 The HDF library currently contains several routines for storing 24-bit raster images in the HDF format. The DF24addimage, DF24putimage, and DF24getimage routines are sufficient for most reading and writing operations.

7.3.1 24-Bit Raster Image Library Routines

The names of all C routines in the 24-bit raster image interface are prefaced by "DF24". The equivalent FORTRAN-77 routines are prefaced by "d2". These routines are divided into the following categories:

The DF24 function calls are more explicitly defined in Table 7C and on their respective pages in the HDF Reference Manual.

TABLE 7C - DF24 Library Routines

Purpose
Routine Name
Description
C
FORTRAN-77
Write
 DF24addimage d2aimg Appends a 24-bit raster image to a file.

DF24lastref d2lref Reports the last reference number assigned to a 24-bit raster image.

DF24putimage d2pimg Writes a 24-bit raster image to file by overwriting all existing data.

DF24setcompress d2scomp Sets the compression method for the next raster image written to the file.

DF24setdims d2sdims Sets the dimensions for the next raster image written to the file.

DF24setil d2setil Sets the interlace format of the next raster image written to the file.

None d2sjpeg Fortran-specific routine for setting the parameters needed for the JPEG compression algorithm.

Read

 DF24getdims d2gdims Retrieves the dimensions before reading the next raster image.

DF24getimage d2gimg Reads the next 24-bit raster image.

DF24nimage d2nimg Reports the number of 24-bit raster images in a file.

DF24readref d2rref Reads 24-bit raster image with the specified reference number.

DF24reqil d2reqil Retrieves the interlace format before reading the next raster image.

DF24restart d2first Returns to the first 24-bit raster image in the file.


[Top] [Prev] [Next]

hdfhelp@ncsa.uiuc.edu
HDF User's Guide - 07/21/98, NCSA HDF Development Group.