This function obtains the HDF AN identifier of the annotation specified by its index and by its annotation type.

Syntax


Result = HDF_AN_SELECT(Annotation_id, index, Annotation_type)

Return Value


Returns the annotation identifier (Annotation_id) if successful or FAIL (-1) otherwise.

Arguments


Annotation_id

HDF_AN_ INTERFACE identifier returned by HDF_AN_START.

Index

Location of the annotation in the file. This parameter is a nonnegative integer and is less than the total number of annotations of type Annotation_type in the file minus 1. Use HDF_AN_FILEINFO to obtain the total number of annotations of each type in the file.

Annotation_type

Type of the annotation. Valid values of Annotation_type are:

  • 0 = data labels
  • 1 = data descriptions
  • 2 = file labels
  • 3 = file descriptions

Keywords


None

Version History


5.2

Introduced