instantreality labs - nodetype

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

ViewBindable (alias: Viewpoint)

The abstract base class for all camera objects. The children field can hold nodes which will be located relative to the camera transformation. If you need to place objects relative to the _active_ camera look at the Viewspace node. zNear/zFar are used to set the z-values per camera. Otherwise the avatarSize and visibilityLimit of the _active_ Userbindable will be used (X3D standard). If both settings are invalid the system will automatically set the z-near/far

Inheritance

Code

XML encoding

<ViewBindable zNear='-1'
zFar='-1'
jump='TRUE'
retainUserOffsets='FALSE'
isDefault='FALSE'
description=''
triggerName='Synchronize'
logFeature=''
 />

Classic encoding

ViewBindable {
	zNear -1
	zFar -1
	jump TRUE
	retainUserOffsets FALSE
	isDefault FALSE
	description ""
	triggerName "Synchronize"
	logFeature [""]
}

Interface

Filter: X3D only | Avalon only | All

Name	DataType	PartType	Default	ValueType	Description
navigator	MFNode	inputOutput		Navigator3D	holds the 3d navigator which will be called for bound nodes
zNear	SFFloat	inputOutput	-1		z-near position; used for clipping
zFar	SFFloat	inputOutput	-1		z-far position; used for clipping
jump	SFBool	inputOutput	TRUE		Sspecifies whether the user's view jumps to the position and orientation of a bound node or remains unchanged
retainUserOffsets	SFBool	inputOutput	FALSE		retainUserOffsets is FALSE, the viewer is returned to the originally defined viewpoint position/orientation after local navigation
isInteractive	SFBool	outputOnly	FALSE		Event true sent when node becomes interactive, user can navigate the view transformation
transformation_request	SFMatrix4f	outputOnly			sends a new request to evaluate a local transformation. Its mainly used together with a NavigationEvaluator node to verify the transformation given by the navigator
transformation_result	SFMatrix4f	inputOnly			this slot is used to transform the view to the given local transformation. It is mainly used to return the camera transformation after processed by a NavigationEvaluator
effects	MFNode	inputOutput		VisualEffects	Specifies the desired global effects like depth of field and motion blur for the post-processing step that are specific to a certain camera or lens type.
splitGroup	SFNode	inputOutput		SplitGroup	holds SplitGroup node for this bindable
children	MFNode	inputOutput			the children fields allow to place object relative to the current camera transformation.
bind	XFAny	inputOnly			sending any event to this slot will bind/activate the Bindable
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
bindTime	SFTime	outputOnly			Event sent when node becomes active/inactive.
isBound	SFBool	outputOnly	FALSE		Event true sent when node becomes active, event false sent when unbound by another node.
isDefault	SFBool	initializeOnly	FALSE		indicates if the object is the default bindable or not (generated if the scene did not contain any Bindable of a missing Type (e.g. Viewpoint))
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)
triggerName	SFString	initializeOnly	Synchronize		name of the dynamic context-slot which is used by the run-time environment (e.g. Jobs) to trigger the node. Life-Nodes will automatically connect the context-eventOutut to the triggerSlot-eventInput Slot.
triggerSlot	SFTime	inputOnly			slot which is used internally to connect a dynamic context-slot which name is set by the triggerName value. Its used automatically to install run-time environment trigger.
logFeature	MFString	inputOutput		state, child, parent, route, eventIn, eventOut	controls the logging of changes, state: log state changes (e.g. live), child: log child add/remove, parent: log parent add/remove, route: log route add/remove; eventIn: log receiving of events, eventOut: log sending of events: guiView, runtime system should create node-view, guiEdit: runtime system should create node-editeverything: log everything
metadata	SFNode	inputOutput		MetadataObject	container for payload metadata inside MetadataSet element