8-Bit Raster Images (DFR8 API)

6.6 8-Bit Raster Image Information Retrieval Routines

DFR8nimages returns the total number of 8-bit raster image sets in a file and has the following syntax:

C:		num_of_images = DFR8nimages(filename);

FORTRAN:	num_of_images = d8nimg(filename)

Routine Name [Return Type] (FORTRAN-77)	Parameter	Parameter Type	Description
C	FORTRAN-77
DFR8nimages [intn] (d8nims)	`filename`	`char *`	`character()`	Name of the HDF file.

DFR8lastref returns the reference number most recently used in writing or reading an 8-bit raster image. This routine is primarily used for attaching annotations to images and adding images to vgroups. (See Chapters 8, titled Annotations (DFAN API) and Chapter 5, titled Vgroups (V API) for more detailed information on how to use reference numbers in connection with these applications.)

C:		status = DFR8addimage(filename, image, width, height, compress);

		lastref = DFR8lastref( );

FORTRAN:	status = d8aimg(filename, image, width, height, compress)

		lastref = d8lref( )

DFR8putimage or DFR8getimage can be used instead of DFR8addimage with similar results.

DFR8getpalref returns the reference number of the palette associated with the most recently used in writing or reading an 8-bit raster image. The DFR8getdims routine must be called before DFR8getpalref, as DFR8getdims initializes internal structures required by DFR8getpalref.

Routine Name [Return Type]	Parameter	Parameter Type	Description
C
DFR8getpalref [intn]	`pal_ref`	`uint16 *`	Pointer to the returned reference number of the palette.

HDF User's Guide - 05/19/99, NCSA HDF Development Group.