This function returns the total number of HDF AN annotations that are of a given type and that are attached to the object identified by its HDF tag and its HDF reference number.

Syntax


Result = HDF_AN_NUMANN(Annotation_id, Annotation_type, Object_tag, Object_ref)

Return Value


Returns the number of annotations or FAIL (-1) otherwise.

Arguments


Annotation_id

HDF AN interface identifier returned by HDF_AN_START.

Annotation_type

Type of the annotation. The following table lists the valid values of the parameter Annotation_type in the left column, and the corresponding values of the parameter Annotation_tag in the right column.

Annotation Type

HDF Annotation Tag

0 = Data Label (AN_DATA_LABEL)

104 (DFTAG_DIL)

1 = Data Description (AN_DATA_DESC)

105 (DFTAG_DIA)

2 = File Label (AN_FILE_LABEL)

100 (DFTAG_FID)

3 = File Description (AN_FILE_DESC)

101 (DFTAG_FD)

Object_tag

HDF tag of the object.

Object_ref

HDF reference number of the object. Since this routine is implemented only to obtain the total number of data annotations and not file annotations, the valid values of Annotation_type are:

  • 0 = data label
  • 1 = data description

To obtain the total number of file annotations or all data annotations, use HDF_AN_FILEINFO.

Keywords


None

Version History


5.2

Introduced