[Top] [Prev]

7.6 24-Bit Raster Image Information Retrieval Routines

7.6.1 Querying the Total Number of Images in a File: DF24nimages

 DF24nimages returns the total number of 24 -bit raster image sets in a file, and has the following syntax:

C:		num_of_images = DF24nimages(filename);
FORTRAN:	num_of_images = d2nimg(filename)

TABLE 7I - DF24nimages Parameter List

Routine Name

[Return Type]

(FORTRAN-77)
Parameter
Parameter Type
Description
C
FORTRAN-77
DF24nimages

[intn]

(d2nimg)
filename
char *
character*(*)
Name of the HDF file.

7.6.2 Querying the Reference Number of the Most Recently Read or Written 24-Bit Raster Image: DF24lastref

 DF24lastref returns the reference number of the 24-bit raster image most recently read or written. This routine is used for attaching annotations to images and adding images to vgroups. (See Chapter 5, Vgroups (V API) and Chapter 10, Annotations (AN API), for details on how to use reference numbers in connection with these applications.

The following calling sequence uses DF24lastref to find the reference number of the RIS24 most recently added to an HDF file:

C:		status = DF24addimage(filename, image, width, height, compress);
		lastref = DF24lastref( );
 
FORTRAN:	status = d2aimg(filename, image, width, height, compress)
 
		lastref = d2lref( )
 DF24putimage or DF24getimage can be used in place of DF24addimage with similar results.

TABLE 7J - DF24lastref Parameter List

Routine Name

[Return Type]

(FORTRAN-77)
Parameter
Parameter Type
Description
C
FORTRAN-77
DF24lastref

[uint16]

(d2lref)
filename
None
None
None.


[Top] [Prev]

hdfhelp@ncsa.uiuc.edu
HDF User's Guide - 05/19/99, NCSA HDF Development Group.