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

ANcreate/afcreate

int32 ANcreate(int32 an_id, uint16 tag, uint16 ref, int32 annot_type)
an_id

IN:

Multifile data annotation interface identifier returned by ANstart

tag

IN:

Tag of the element the created data annotation will be applied to

ref

IN:

Reference number of the object the created data annotation will be applied to

annot_type

IN:

Type of data annotation

Purpose

Creates an data annotation for the object identified by the specified tag and reference number.

Return value

Returns a data annotation identifier if successful and FAIL (or -1) otherwise.

Description

The data annotation identifier returned can either point to a data label or a data description.

Valid values for annot_type are: AN_DATA_LABEL for data labels and AN_DATA_DESC for data descriptions.

Example

This example illustrates the use of ANcreate to create an data label for a numeric data group.

	#include "hdf.h"

	int32 an_id, ann_id, file_id, stat;
	uint16 tag = DFTAG_NDG;
	uint16 ref = 2;
	ann_type type = AN_DATA_LABEL;

	file_id = Hopen("myfile", DFACC_WRITE, 0);
	an_id = ANstart(file_id);
	ann_id = ANcreate(an_id, tag, ref, type);
	       ...
	stat = ANendaccess(ann_id);
	stat = ANend(an_id);
	Hclose(file_id); 
FORTRAN

integer function afcreate(an_id, tag, ref, annot_type)

integer an_id, tag, ref, annot_type



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

hdfhelp@ncsa.uiuc.edu
HDF User's Reference Manual, Draft 06/09/97, NCSA HDF Development Group.