|
Purpose
|
Creates a file annotation. |
|
Return value
|
Returns the file annotation identifier (ann_id) if successful and FAIL (or -1) otherwise. |
|
Description
|
ANcreatef creates a file annotation of the type specified by the parameter annot_type. The file annotation identifier returned can either represent a file label or a file description. |
|
|
Valid values for annot_type are AN_FILE_LABEL (or 2) and AN_FILE_DESC (or 3). |
|
|
Use ANcreate to create a data annotation. |
|
|
Currently, the user must write to a newly-created annotation before creating another annotation of the same type. Creating two consecutive annotations of the same type causes the second call to ANcreate to return FAIL (or -1). |