| SoTouchManager Class |
Class for managing events from touch screen input devices.
Inheritance HierarchyNamespace: OIV.Inventor.Touch
Assembly: OIV.Inventor (in OIV.Inventor.dll) Version: 9.9.13.0 (9.9.13.0)
SyntaxThe SoTouchManager type exposes the following members.
Constructors| Name | Description | |
|---|---|---|
 | SoTouchManager | Initializes a new instance of the SoTouchManager class |
| SoTouchManager(SoSceneManager) | Obsolete. Obsoletesince Open Inventor 9500 Scene manager argument is useless. |
Methods| Name | Description | |
|---|---|---|
| AddDefaultRecognizers | Add a default list of recognizers to the recognizer list. |
| AddRecognizer | Add a gesture recognizer to the recognizer list. |
| Equals | (Inherited from Object.) |
| GetAllFingerIds | Get the table with ids of all fingers touching the screen. |
| GetEventById | Get the corresponding event for the finger id, NULL if id is incorrect. |
| GetEventbyIndex | Get the corresponding event for the index, NULL if index is incorrect. |
| GetFingerNumber | Get the current number of fingers touching the screen. |
| GetHashCode |
Overrides GetHashCode().
(Inherited from SoNetBase.) |
| GetMaxSimultaneousFingers | Get the maximum number of simultaneous fingers supported by the device. |
| GetRecognizerList | Returns the gesture recognizers list. |
| GetThreshold | Get the detection threshold (in pixels). |
| GetTouchDownEvent | Translate the given touch down event into a list of SoEvent. |
| GetTouchMoveEvent | Translate the given touch move event into a list of SoEvent. |
| GetTouchUpEvent | Translate the given touch up event into a list of SoEvent. |
| GetType | Gets the Type of the current instance. (Inherited from Object.) |
| IsTouchScreenAvailable | Returns true if the touch screen device is available, false otherwise. |
| RemoveDefaultRecognizers | Remove the default recognizers from the recognizer list. |
| RemoveRecognizer | Remove a gesture recognizer from the recognizer list. |
| SetMaxSimultaneousFingers | Set the maximum number of simultaneous fingers supported by the device. |
| SetThreshold | Set the detection threshold (0.0001 pixels by default). |
| SetTouchScreenAvailability | Set the touch screen availability. |
| ToString | Returns a string that represents the current object. (Inherited from Object.) |
| UpdateAndProcessTouchEvent | Obsolete. Update finger's id of the event identified by id and process it with the scene manager. |
RemarksThis is the base class for managing events from touch screen input devices. A touch manager has a SoTouchEvent table and a finger ids table which are updated each time a finger moves. A touch manager has a list of gesture recognizers that generate events when the gesture is recognized. By default, the list is empty and recognizers must be added to generate the corresponding events. The addDefaultRecognizers() method is provided for convenience.
Note that all registered gesture recognizers are active simultaneously. During a gesture event, events may generated for a different gesture. The application is responsible for enforcing a "one gesture at a time" policy if appropriate.
Note: Unlike mouse and keyboard events, the application must explicitly register a touch screen device (e.g. SoWinTouchScreen) in order to get touch events.
EXAMPLE
Get the touch manager from the touch device to register gesture recognizers.
SoScaleGestureRecognizer scaleRecognizer = new SoScaleGestureRecognizer(); SoRotateGestureRecognizer rotateRecognizer = new SoRotateGestureRecognizer(); SoWinTouchScreen touchScreenDevice = new SoWinTouchScreen(this); touchScreenDevice.GetTouchManager().AddRecognizer(scaleRecognizer); touchScreenDevice.GetTouchManager().AddRecognizer(rotateRecognizer);
See Also