SnapIn
SnapIns are locations where SnapSensors can "snap in"
Inheritance
Code
XML encoding
<SnapIn id='default' sticky='TRUE' maxSticking='1' transULimit='0 0 0' transLLimit='0 0 0' rotAxis='0 0 1' rotULimit='0' rotLLimit='0' triggerName='Timer' locationOffset='identity' locationTranslation='0 0 0' locationRotation='0 0 0 1' visibleSize='1.0' description='' enabled='TRUE' logFeature='' />
Classic encoding
SnapIn { id "default" sticky TRUE maxSticking 1 transULimit 0 0 0 transLLimit 0 0 0 rotAxis 0 0 1 rotULimit 0 rotLLimit 0 triggerName "Timer" locationOffset identity locationTranslation 0 0 0 locationRotation 0 0 0 1 visibleSize 1.0 description "" enabled TRUE logFeature [""] }
Interface
Filter: X3D only | Avalon only | All
id | Name | DataType | PartType | Default | ValueType | Description |
---|---|---|---|---|---|---|
id | SFString | initializeOnly | default | SnapSensors keep an idList which is matched against ids of Snapins | ||
sticky | SFBool | initializeOnly | TRUE | if true, SnapSensors stick to this SnapIn and will follow this SnapIn on move. | ||
maxSticking | SFInt32 | inputOutput | 1 | [-1, inf) | Number of attachable SnapSensors. This works with sticky=TRUE only! -1 means unlimited SnapSensors attachable | |
transULimit | SFVec3f | initializeOnly | 0 0 0 | upper translation limits that a SnapSensor is allowed to move away while sticky to this SnapIn | ||
transLLimit | SFVec3f | initializeOnly | 0 0 0 | lower translation limits that a SnapSensor is allowed to move away while sticky to this SnapIn | ||
rotAxis | SFVec3f | initializeOnly | 0 0 1 | free rotational axis (0 0 0 means no constrained rotation) | ||
rotULimit | SFFloat | initializeOnly | 0 | [0, 2pi] | upper angle limit. | |
rotLLimit | SFFloat | initializeOnly | 0 | [0, 2pi] | lower angle limit. | |
snapped | SFBool | outputOnly | fired if a sticky SnapSensor has snapped in | |||
whichSnapped | SFNode | outputOnly | fired if a sticky SnapSensor has snapped in | |||
locationOffset | SFMatrix4f | initializeOnly | identity | offset of the SnapSomething relative to its parent node | ||
locationTranslation | SFVec3f | initializeOnly | 0 0 0 | translation of the SnapSomething relative to its parent node | ||
locationRotation | SFRotation | initializeOnly | 0 0 0 1 | rotation of the SnapSomething relative to its parent node | ||
visibleSize | SFFloat | initializeOnly | 1.0 | (-inf, inf) | the scalation for the indicator nodes | |
indicatorNode | SFNode | initializeOnly | Node | If two SnapSomethings are matched as compatible the indicatorNode is shown. Default is a green sphere. | ||
highlightNode | SFNode | initializeOnly | Node | If two SnapSomethings are matched as compatible AND are close enough to "snap", the highlightNode is shown. Default is a red sphere. | ||
standbyNode | SFNode | initializeOnly | Node | the standbyNode is selected when neither of indicator/highlight is shown. It defaults to nothing, so that it is invisible. | ||
highlightActivated | SFBool | outputOnly | Indicates if highlight is activated or not. | |||
description | SFString | inputOutput | Text description to comment the sensor task. Can be used in run-time systems to give usefull feedback to the user and developer | |||
enabled | SFBool | inputOutput | TRUE | Enables/disables the sensor node. | ||
isActive | SFBool | outputOnly | FALSE | isActive true/false events are sent when the sensor gets active | ||
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 |