MetadataBoolean

Overview

MetadataBoolean contains a typed list of values providing metadata information about its parent node. Further information about this specific Metadata* node may be provided by a single child Metadata* node with containerField='metadata'.

The MetadataBoolean node belongs to the Core component and requires at least level 1, its default container field is value. It is available from X3D version 3.3 or higher.

Hierarchy

+ X3DNode
  + MetadataBoolean (X3DMetadataObject)*

* Derived from multiple interfaces.

Fields

SFNode [in, out] metadata NULL [X3DMetadataObject]

Information about this node can be contained in a MetadataBoolean, MetadataDouble, MetadataFloat, MetadataInteger, MetadataString or MetadataSet node.

Hint

• X3D Architecture 7.2.4 Metadata

SFString [in, out] name “”

Depending on the metadata vocabulary, the attribute name is usually required for metadata nodes.

Hints

• Well-defined names can simplify design and debugging through improved author understanding.
• X3D Scene Authoring Hints, Naming Conventions

Warning

• name field is not included if this instance is a USE node, in order to avoid potential mismatches.

SFString [in, out] reference “”

Reference to the metadata standard or definition defining this particular metadata value.

MFBool [in, out] value [ ]

The value attribute is a strictly typed data array providing relevant metadata information.

Warning

• Use lower-case values (“true false”) for .x3d XML encoding, and upper-case values (“TRUE FALSE”) for .x3dv ClassicVRML encoding.

Advice

Hints

• Typically use containerField='value' if the parent node is MetadataSet.
• Explicitly defining containerField for Metadata nodes is always allowed and also unambiguous across each version of X3D.
• Each of the Metadata nodes are allowed as top-level root nodes in a scene, if doing that be sure to explicitly define containerField='metadata'.
• If present, an IS statement is the first child within any other node.
• An IS statement precedes any sibling Metadata* node, which in turn precedes any other sibling nodes.
• Comments are not readable when a model file is loaded for viewing, but WorldInfo and Metadata* nodes are persistent and inspectable at run time.
• X3D for Web Authors, Chapter 15, Metadata Information

Warnings

• Default containerField='metadata' in X3D 3 changed to default containerField='value' in X3D 4.0, allowing construction of much terser MetadataSet vocabulary structures.
• Metadata nodes can only contain other Metadata nodes.

See Also

• X3D Specification of MetadataBoolean Node