[Top] [Prev] [Next]

11.2 The Single-file Annotation Interface

 The functions and routines that comprise the single-file annotation interface have names that begin with the string "DFAN" in C; the equivalent FORTRAN-77 routine names are prefaced by "da". This interface is the older annotation interface and only supports annotation access within one particular HDF file. It doesn't support the concept of an annotation identifier used in the newer multifile interface. Therefore, annotations created with the multifile interface cannot be accessed or manipulated with DFAN interface functions.

11.2.1 DFAN Library Routines

These functions are divided into the following categories:

The DFAN interface routines are listed in the following table and are discussed in the subsequent sections of this document.

TABLE 11A - DFAN Library Routines

Purpose
Functions
Description
C
FORTRAN-77
Write
 DFANaddfds daafds Assigns a file description to a specific file

DFANaddfid daafid Assigns a file label to a specific file

DFANputdesc dapdesc Assigns an object description to a specific data object

DFANputlabel daplab Assigns an object label to a specific data object

Read
DFANgetdesc dagdesc Reads the text of an object description

DFANgetdesclen dagdlen Returns the length of an object description

DFANgetfds dagfds Reads the text of a file description

DFANgetfdslen dagfdsl Returns the length of a file description

DFANgetfid dagfid Reads the text of a file label

DFANgetfidlen dagfidl Returns the length of a file label

DFANgetlabel daglab Reads the text of an object label

DFANgetlablen dagllen Returns the length of an object label

General Inquiry
 DFANlablist dallist Gets a list of all the labels in a file for a particular tag

DFANlastref dalref Returns the reference number of the last annotation accessed

Maintenance
 DFANclear None Clears the internal tables and structures used by the DFAN interface

11.2.2 Tags in the Annotation Interface

 Table 11B lists the annotation tags defined in HDF versions 2.0, 3.0, and 4.0. Newly-defined tag names in each version are bolded. For a more complete list of tags, refer to the HDF Specifications and Developer's Guide v3.2 from the HDF WWW home page at http://hdf.ncsa.uiuc.edu/.

TABLE 11B - List of Annotation Interface Tags in HDF Versions 2.0, 3.0 and 4.0

Interface
Data Object
Tag Name
v2.0
v3.0
v4.0
DFR8
 Raster Image: 8-bit (uncompressed)

 DFTAG_RI8 DFTAG_RI DFTAG_RI
Compressed Image: 8-bit

 DFTAG_CI8 DFTAG_CI DFTAG_CI
Image Dimension: 8-bit

 DFTAG_ID8 DFTAG_ID DFTAG_ID
Image Palette: 8-bit

 DFTAG_IP8 DFTAG_LUT DFTAG_LUT
DF24
 Raster Image Group

 None

 DFTAG_RIG DFTAG_RIG
Raster Image (uncompressed)

 None

 DFTAG_RI DFTAG_RI
Compressed Image

 None

 DFTAG_CI DFTAG_CI
Image Dimension

 None

 DFTAG_ID DFTAG_ID
DFP
 Color Look-up Table

 DFTAG_LUT DFTAG_LUT DFTAG_LUT
DFSD
 Scientific Data Group

 DFTAG_SDG DFTAG_SDG DFTAG_NDG
Scientific Data

 DFTAG_SD DFTAG_SD DFTAG_SD
Scientific Data Dimension

 DFTAG_SDD DFTAG_SDD DFTAG_SDD
Scientific Data Scale Attribute

 DFTAG_SDS DFTAG_SDS DFTAG_SDS
Scientific Data Label Attribute

 DFTAG_SDL DFTAG_SDL DFTAG_SDL
Scientific Data Unit Attribute

 DFTAG_SDU DFTAG_SDU DFTAG_SDU
Scientific Data Format Attribute

 DFTAG_SDF DFTAG_SDF DFTAG_SDF
Scientific Data Max/Min Attribute

 DFTAG_SDM DFTAG_SDM DFTAG_SDM
Scientific Data Coordinates Attribute

 DFTAG_SDC DFTAG_SDC DFTAG_SDC
DFAN
 File Identifier

 DFTAG_FID DFTAG_FID DFTAG_FID
File Descriptor

 DFTAG_FD DFTAG_FD DFTAG_FD
Data Identifier Label

 DFTAG_DIL DFTAG_DIL DFTAG_DIL
Data Identifier Annotation

 DFTAG_DIA DFTAG_DIA DFTAG_DIA
Vdata
 Vdata Storage

 DFTAG_VS DFTAG_VS DFTAG_VS
Vgroups
 Vgroup Storage

 DFTAG_VG DFTAG_VG DFTAG_VG


[Top] [Prev] [Next]

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