Node: Viewpoint

X3D: 3.3
Component: Navigation
Status:
experimental

Quick Links

➨ Fields

Viewpoint provides a specific location and direction where the user may view the scene. The principalPoint extention allows to set asymmetric frustums.

HTML Encoding and Default Values

<Viewpoint bind='false' centerOfRotation='0,0,0' description='""' farClippingPlane='-1' fieldOfView='0.785398' isActive='false' metadata='X3DMetadataObject' navigationInfo='null' nearClippingPlane='-1' orientation='0,0,1,0' position='0,0,10' viewAll='false' zFar='-1' zFar='-1' zNear='-1' zNear='-1' ></Viewpoint>

Fields

These are the X3D / X3DOM fields of this node. Values should usually be received / set as strings via DOM functions (i.e., using setAttribute("myFieldName", "myFieldValue") and getAttribute("myFieldName")).
Name Type Default Value Range Inheritance Standard Description
bind SFBool false Core/X3DBindableNode Pushes/pops the node on/from the top of the bindable stack
centerOfRotation SFVec3f 0,0,0 The centerOfRotation field specifies a center about which to rotate the user's eyepoint when in EXAMINE mode. The coordinates are provided in world coordinates for x3dom, currently.
description SFString "" Core/X3DBindableNode Description of the bindable node
farClippingPlane SFFloat -1 -1 or [0, inf] X3DViewpointNode Specifies the far clipping plane, alias for zFar
fieldOfView SFFloat 0.785398 [0, pi] 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. Hint: modifying Viewpoint distance to object may be better for zooming. Warning: fieldOfView may not be correct for different window sizes and aspect ratios. Interchange profile hint: this field may be ignored.
isActive SFBool false Core/X3DBindableNode
metadata SFNode X3DMetadataObject Core/X3DNode Field to add metadata information
navigationInfo SFBool null X3DViewpointNode Defines a dedicated NavigationInfo node for this X3DViewpointNode. The specified NavigationInfo node receives a set_bind TRUE event at the time when the parent node is bound and receives a set_bind FALSE at the time when the parent node is unbound.
nearClippingPlane SFFloat -1 -1 or [0, inf] X3DViewpointNode Specifies the near clipping plane, alias for zNear
orientation SFRotation 0,0,1,0 The orientation fields of the Viewpoint node specifies relative orientation to the default orientation.
position SFVec3f 0,0,10 The position fields of the Viewpoint node specifies a relative location in the local coordinate system. Position is relative to the coordinate system's origin (0,0,0),
viewAll SFBool false X3DViewpointNode When the viewAll field is set to TRUE or a viewpoint is bound with viewAll field TRUE, the current view is modified to change the centerOfRotation field to match center of the bounding box for the entire visible scene, and the orientation field is modified to aim at that point. Finally, the zoom position or fieldofview is adjusted to contain the entire scene in the current viewing window. If needed, the near and far clipping planes shall be adjusted to allow viewing the entire scene. When the value of the viewAll field is changed from TRUE to FALSE, no change in the current view occurs.
zFar SFFloat -1 -1 or [0, inf] Specifies the far plane.
zFar SFFloat -1 -1 or [0, inf] Specifies the far plane.
zNear SFFloat -1 -1 or [0, inf] Specifies the near plane.
zNear SFFloat -1 -1 or [0, inf] Specifies the near plane.