Viewpoint provides a specific location and direction where the user may view the scene.
The Viewpoint node belongs to the Navigation component and its container field is children. It is available since X3D version 3.0 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] set_bind
Sending event set_bind=true makes this node active. Sending event set_bind=false makes this node inactive. Thus setting set_bind to true/false will pop/push (enable/disable) this Viewpoint.
SFString [in, out] description ""
Text description or navigation hint to identify this Viewpoint.
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 Viewpoint is unlikely to appear on browser Viewpoints menu.
SFVec3f [in, out] position 0 0 10 (-∞,∞)
Position (x, y, z in meters) relative to local coordinate system.
SFRotation [in, out] orientation 0 0 1 0 [-1,1],(-∞,∞)
Rotation (axis, angle in radians) of Viewpoint, relative to default -Z axis direction in local coordinate system.
This is orientation _change_ from default direction (0 0 -1). Complex rotations can be accomplished axis-by-axis using parent Transforms.
SFVec3f [in, out] centerOfRotation 0 0 0 (-∞,∞)
CenterOfRotation specifies center point about which to rotate user's eyepoint when in EXAMINE or LOOKAT mode.
SFFloat [in, out] fieldOfView 0.7854 (0,π)
Preferred minimum viewing angle from this viewpoint in radians. Small field of view roughly corresponds to a telephoto lens, large field of view roughly corresponds to a wide-angle lens.
Modifying Viewpoint distance to object may be better for zooming.
FieldOfView may not be correct for different window sizes and aspect ratios. Interchange profile hint: this field may be ignored, applying the default value regardless.
SFBool [in, out] jump TRUE
Transition instantly by jumping, or smoothly adjust offsets in place when changing to this Viewpoint.
Set jump=true for smooth camera motion when going to this viewpoint.
SFBool [in, out] retainUserOffsets FALSE
Retain (true) or reset to zero (false) any prior user navigation offsets from defined viewpoint position, orientation.
SFBool [out] isBound
Event true sent when node becomes active, event false sent when unbound by another node.
SFTime [out] bindTime
Event sent when node becomes active/inactive.
- NavigationInfo, Background, TextureBackground, Fog, OrthoViewpoint and Viewpoint are bindable nodes, meaning that no more than one of each node type can be active at a given time.
- Do not include Viewpoint or OrthoViewpoint as a child of LOD or Switch, instead use ViewpointGroup as parent to constrain location proximity where the viewpoint is available to user.