Description

et the unlock state of a metadata

Syntax:: md = btkSetMetaDataUnlock(h, idx, isunlocked) md = btkSetMetaDataUnlock(h, idx, subidx, isunlocked) md = btkSetMetaDataUnlock(h, idx, subidx, ..., isunlocked) md = btkSetMetaDataUnlock(h, label, isunlocked) md = btkSetMetaDataUnlock(h, label, sublabel, isunlocked) md = btkSetMetaDataUnlock(h, label, sublabel, ..., isunlocked)

Parameters

h	Handle pointing to a C++ btk::Acquisition object.
idx	Integer specifying the index of a metadata.
subidx	Integer specifying the index of a metadata.
label	String specifying the label of a metadata.
sublabel	String specifying the label of a metadata.
...	Others integers and/or strings to select the metadata to remove.
isunlocked	Integer (1 or 0) to set the metadata as unlocked or locked.

Return values

md	Structure with the same format than the function btkGetMetaData.

Detailed description:: btkSetMetaDataUnlock(h, idx, isunlocked) sets the unlock state of the metadata with the index idx contained in the root. btkSetMetaDataUnlock(h, idx, subidx, isunlocked) sets the unlock state of the metadata with the index subidx contained in the metadata with the index idx. btkSetMetaDataUnlock(h, idx, subidx, ..., isunlocked) sets the unlock state of any metadata specified by the gives indices. btkSetMetaDataUnlock(h, label, isunlocked) sets the unlock state of the metadata with the label label contained in the root. btkSetMetaDataUnlock(h, label, sublabel, isunlocked) sets the unlock state of the metadata with the label sublabel contained in the metadata with the label label. btkSetMetaDataUnlock(h, label, sublabel, ..., isunlocked) sets the unlock state of any metadata specified by the given labels.

You can mix label and index to set the unlock state of a metadata entry.

The number of sub-level is infinite. However, the main common use of the metadata is to use 2 levels. This use was introduced in the C3D format.

See Also: btkSetMetaDataDescription, btkSetMetaDataDimensions, btkSetMetaDataFormat, btkSetMetaDataLabel, btkSetMetaDataValue