Description

Append a new metada into the given acquisition and (optionally) return an updated list of the metadata.

Syntax:: md = btkAppendMetaData(h, label) md = btkAppendMetaData(h, label, sublabel) md = btkAppendMetaData(h, label, sublabel, ...) md = btkAppendMetaData(h, label, sublabel, ..., info)

Parameters

h	Handle pointing to a C++ btk::Acquisition object.
label	String representing a metadata's label in the metadata's root.
sublabel	String representing a metadata's label contained in the metadata with the label `label`.
...	Others strings to point on the desired metadata with any level of depth
info	Structure with the field `format` and `values` (see note #1). `info.format:` contains a string (Char, Byte, Integer or Real) corresponding to format of the information. `info.values:` contains an array of numerical values or a cell of strings. The array is used for information with the format Byte, Integer or Real. The cell of strings is only use for information with the format Char.

Return values

md	Structure with the same format than the function btkGetMetaData.

Detailed description:: btkAppendMetaData(h, label) appends a metadata with the label label to the root. This metadata has no child, nor information.

btkAppendMetaData(h, label, sublabel, ...) appends a metadata with the label sublabel in another metadata with the label label. The metadata 'label' will be automatically generated if it doesn't exist. The metadata 'sublabel' has no child, nor information.

btkAppendMetaData(h, label, sublabel, ..., info) appends a metadata with additional informations INFO corresponding to the metadata's values.

Remark: The number of sub-level is infinite. However, the main common use of the metadata is to use label as a group and sublabel as a parameter. So the metadata has only 2 levels. This use was introduced in the C3D format.

Note #1: The structure info should be build by using the function btkMetaDataInfo.

See Also: btkClearMetaData, btkFindMetaData, btkGetMetaData, btkRemoveMetaData, btkSetMetaData