instantreality 1.0

Component:
Navigation
Status:
fully implemented
Structure type:
abstract
Standard:
X3D2.0

Viewpoint (Standard name: ViewBindable) (alias: PerspectiveViewpoint)

Abstract Viewpoint provides a specific location and direction where the user may view the scene. Background, Fog, NavigationInfo, TextureBackground and Viewpoint are bindable nodes.

Inheritance

Code

XML encoding
<Viewpoint centerOfRotation='0 0 0'
orientation='0 0 1 0'
position='0 0 10'
zNear='-1'
zFar='-1'
jump='TRUE'
retainUserOffsets='FALSE'
isDefault='FALSE'
description=''
triggerName='Synchronize'
logFeature=''
 />
Classic encoding
Viewpoint {
	centerOfRotation 0 0 0
	orientation 0 0 1 0
	position 0 0 10
	zNear -1
	zFar -1
	jump TRUE
	retainUserOffsets FALSE
	isDefault FALSE
	description ""
	triggerName "Synchronize"
	logFeature [""]
}

Interface

Filter: X3D only | Avalon only | All
id Name DataType PartType Default ValueType Description
SFBool isBound SFBool outputOnly FALSE Event true sent when node becomes active, event false sent when unbound by another node.
SFBool isInteractive SFBool outputOnly FALSE Event true sent when node becomes interactive, user can navigate the view transformation
SFBool jump SFBool inputOutput TRUE Transition instantly by jumping, or smoothly animate to this Viewpoint. Hint: set jump=true for smooth camera motion when going to this viewpoint.
SFBool retainUserOffsets SFBool inputOutput FALSE retainUserOffsets is FALSE, the viewer is returned to the originally defined viewpoint position/orientation after local navigation
SFBool set_bind SFBool inputOnly 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 Bindable
SFNode metadata SFNode inputOutput MetadataObject container for payload metadata inside MetadataSet element
SFRotation orientation SFRotation inputOutput 0 0 1 0 Rotation (axis, angle in radians) of Viewpoint, relative to default -Z axis direction in local coordinate system. Hint: this is orientation _change_ from default direction (0 0 -1). Hint: complex rotations can be accomplished axis-by-axis using parent Transforms.
SFString description SFString initializeOnly Text description or navigation hint to be displayed for this Bindable. Hint: make descriptions clear and readable. Warning: without description, Bindable (e.g. Viewpoint objs) can not be activated/deactivated with keyboard or gui messages (e.g. switched with PgUp bzw PgDn)
SFTime bindTime SFTime outputOnly Event sent when node becomes active/inactive.
SFVec3f centerOfRotation SFVec3f inputOutput 0 0 0 centerOfRotation point relates to NavigationInfo EXAMINE mode.
SFVec3f position SFVec3f inputOutput 0 0 10 Position (x, y, z in meters) relative to local coordinate system.