[Top] [Prev] [Next] [Bottom]

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

(Fortran-77)

Parameter

Data Type

Description

C

Fortran-77

DF24nimages

(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, titled Vgroups (V API) and Chapter 10, titled Annotations (DFAN 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

(Fortran-77)

Parameter

Data Type

Description

C

Fortran-77

DF24lastref

(d2lref)

filename

None

None

None.



[Top] [Prev] [Next] [Bottom]

hdfhelp@ncsa.uiuc.edu
HDF User's Guide - 06/04/97, NCSA HDF Development Group.