ViewpointGroup collects Viewpoint, OrthoViewpoint and other ViewpointGroup nodes for better user-navigation support with a shared description on the viewpoint list.
The ViewpointGroup node belongs to the Navigation component and its container field is children. It is available since X3D version 3.2 or later.
SFNode [in, out] metadata NULL [X3DMetadataObject]
Metadata are not part of the X3D world and not interpreted by the X3D browser, but they can be accessed via the ECMAScript interface.
SFBool [in, out] displayed TRUE
Displayed determines whether this ViewpointGroup is displayed in the current viewpoint list.
SFString [in, out] description ""
Text description or navigation hint to identify this ViewpointGroup.
Use spaces, make descriptions clear and readable. Many XML tools substitute XML character references automatically if needed (such as & for & ampersand, or " for " quotation mark).
Without description, this ViewpointGroup is unlikely to appear on browser Viewpoints menu.
SFBool [in, out] retainUserOffsets FALSE
Retain (true) or reset to zero (false) any prior user navigation offsets from defined viewpoint position, orientation.
SFVec3f [in, out] size 0 0 0 (-∞,∞)
Size of proximity box around center location within which ViewpointGroup is usable and displayed on viewpoint list.
Size 0 0 0 specifies that ViewpointGroup is always usable and displayable.
SFVec3f [in, out] center 0 0 0 (-∞,∞)
Center specifies center point of proximity box within which ViewpointGroup is usable and displayed on viewpoint list.
MFNode [in, out] children [ ] [X3DViewpointNode | ViewpointGroup]
Input/Output field children.
- Use ViewpointGroup as parent for Viewpoint and OrthoViewpoint to constrain location proximity where contained viewpoints are available to user.
- ViewpointGroup and OrthoViewpoint require Navigation component level 3, which is higher than CADInterchange profile.
- Viewpoint and ViewpointGroup descriptions together build simple menu/submenu lists for simple user navigation.