instantreality 1.0

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

NavigationInfo (Standard name: UserBindable)

NavigationInfo describes the viewing model and physical characteristics of the viewer's avatar. Hint: for inspection of simple objects, usability often improves with type='EXAMINE' 'ANY' Hint: NavigationInfo types ''WALK' 'FLY'' support camera-to-object collision detection. Background, Fog, NavigationInfo, TextureBackground and Viewpoint are bindable nodes.

Inheritance

Code

XML encoding
<NavigationInfo type='ANY'
interactionType='ANY'
transitionType='LINEAR'
accuracy='1'
avatarSize='0.25, 1.6, 0.75'
visibilityLimit='0.0'
speed='1'
globalAmbient='0 0 0'
headlight='TRUE'
headlightDiffuse='0.8 0.8 0.8'
headlightAmbient='0.1 0.1 0.1'
headlightSpecular='0.5 0.5 0.5'
evaluateIsOver='TRUE'
transitionTime='1.0'
sceneScale='1'
webUrl=''
isDefault='FALSE'
description=''
triggerName='Synchronize'
logFeature=''
 />
Classic encoding
NavigationInfo {
	type ["ANY"]
	interactionType ["ANY"]
	transitionType ["LINEAR"]
	accuracy 1
	avatarSize [0.25, 1.6, 0.75]
	visibilityLimit 0.0
	speed 1
	globalAmbient 0 0 0
	headlight TRUE
	headlightDiffuse 0.8 0.8 0.8
	headlightAmbient 0.1 0.1 0.1
	headlightSpecular 0.5 0.5 0.5
	evaluateIsOver TRUE
	transitionTime 1.0
	sceneScale 1
	webUrl [""]
	isDefault FALSE
	description ""
	triggerName "Synchronize"
	logFeature [""]
}

Interface

Filter: X3D only | Avalon only | All
id Name DataType PartType Default ValueType Description
MFFloat avatarSize MFFloat inputOutput 0.25, 1.6, 0.75 avatarSize triplet values are: (a) collision distance between user and geometry (near culling plane of the view frustrum) (b) viewer height above terrain (c) tallest height viewer can WALK over. Hint: keep (avatarSize.CollisionDistance / visibilityLimit) less then; 10,000 to avoid aliasing artifacts (i.e. polygon 'tearing'). Interchange profile hint: this field may be ignored.
MFNode navigator MFNode inputOutput Navigator3D holds the 3d navigator which will be called for bound nodes
MFString interactionType MFString inputOutput ANY [NONE, PROJECTION, RAY, NEAREST, COLLISION, ANY] defines the interaction type
MFString 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
MFString transitionType MFString inputOutput LINEAR [LINEAR, TELEPORT, ANIMATE, LINEAR_CONSTVELOCITY] can be one of "LINEAR", "TELEPORT", "ANIMATE" and "LINEAR_CONSTVELOCITY"
MFString type MFString inputOutput ANY [NONE, WALK, EXAMINE, FLY, FREEFLY, LOOKAT, GAME, SLIDE, PAN, ANY] defines the navigation type
MFString webUrl MFString inputOutput Local Documents that should be available through the web interface
SFBool evaluateIsOver SFBool inputOutput TRUE Turns globally on/off isOver for all Sensors.
SFBool headlight SFBool inputOutput TRUE Enable/disable directional light that always points in the direction the user is looking.
SFBool isBound SFBool outputOnly FALSE Event true sent when node becomes active, event false sent when unbound by another node.
SFBool 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))
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
SFBool transitionComplete SFBool outputOnly When a transition completes, a transitionComplete TRUE event is signaled.
SFColor globalAmbient SFColor inputOutput 0 0 0 global ambient color
SFColor headlightAmbient SFColor inputOutput 0.1 0.1 0.1 ambient color of the headlight
SFColor headlightDiffuse SFColor inputOutput 0.8 0.8 0.8 diffuse color of the headlight
SFColor headlightSpecular SFColor inputOutput 0.5 0.5 0.5 specular color of the headlight
SFFloat accuracy SFFloat inputOutput 1 [0, inf) Requested positional accuracy (in meters) for Geospatial nodes. If no explicit GeoOrigin is given, browser will try to automatically adjust origin to be able to satisfy accurcy request.
SFFloat sceneScale SFFloat inputOutput 1 Scene scale 1000 -> km, 1-> meter, 0.01 -> cm, 0.001 -> mm
SFFloat speed SFFloat inputOutput 1 [0; Inf) Default rate at which viewer travels through scene, meters/second. Warning: default 1 m/s usually seems slow for ordinary navigation. Interchange profile hint: this field may be ignored.
SFFloat visibilityLimit SFFloat inputOutput 0.0 Geometry beyond the visibilityLimit may not be rendered (far culling plane of the view frustrum). visibilityLimit=0.0 indicates an infinite visibility limit. Hint: keep visibilityLimit greater then;= zero. Hint: keep (avatarSize.CollisionDistance / visibilityLimit) less then; 10,000 to avoid aliasing artifacts (i.e. polygon 'tearing'). Interchange profile hint: this field may be ignored.
SFNode metadata SFNode inputOutput MetadataObject container for payload metadata inside MetadataSet element
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)
SFString 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.
SFTime bindTime SFTime outputOnly Event sent when node becomes active/inactive.
SFTime transitionTime SFTime inputOutput 1.0 he transitionTime field specifies the duration of any viewpoint transition
SFTime 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.
XFAny bind XFAny inputOnly sending any event to this slot will bind/activate the Bindable