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 |
---|---|---|---|---|---|---|
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. | |
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. | ||
bind | XFAny | inputOnly | sending any event to this slot will bind/activate the Bindable | |||
bindTime | SFTime | outputOnly | Event sent when node becomes active/inactive. | |||
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) | |||
evaluateIsOver | SFBool | inputOutput | TRUE | Turns globally on/off isOver for all Sensors. | ||
globalAmbient | SFColor | inputOutput | 0 0 0 | global ambient color | ||
headlight | SFBool | inputOutput | TRUE | Enable/disable directional light that always points in the direction the user is looking. | ||
headlightAmbient | SFColor | inputOutput | 0.1 0.1 0.1 | ambient color of the headlight | ||
headlightDiffuse | SFColor | inputOutput | 0.8 0.8 0.8 | diffuse color of the headlight | ||
headlightSpecular | SFColor | inputOutput | 0.5 0.5 0.5 | specular color of the headlight | ||
interactionType | MFString | inputOutput | ANY | [NONE, PROJECTION, RAY, NEAREST, COLLISION, ANY] | defines the interaction type | |
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)) | ||
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 | ||
navigator | MFNode | inputOutput | Navigator3D | holds the 3d navigator which will be called for bound nodes | ||
sceneScale | SFFloat | inputOutput | 1 | Scene scale 1000 -> km, 1-> meter, 0.01 -> cm, 0.001 -> mm | ||
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 | |||
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. | |
transitionComplete | SFBool | outputOnly | When a transition completes, a transitionComplete TRUE event is signaled. | |||
transitionTime | SFTime | inputOutput | 1.0 | he transitionTime field specifies the duration of any viewpoint transition | ||
transitionType | MFString | inputOutput | LINEAR | [LINEAR, TELEPORT, ANIMATE, LINEAR_CONSTVELOCITY] | can be one of "LINEAR", "TELEPORT", "ANIMATE" and "LINEAR_CONSTVELOCITY" | |
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. | |||
type | MFString | inputOutput | ANY | [NONE, WALK, EXAMINE, FLY, FREEFLY, LOOKAT, GAME, SLIDE, PAN, ANY] | defines the navigation type | |
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. | ||
webUrl | MFString | inputOutput | Local Documents that should be available through the web interface |