36 lines
1.5 KiB
Markdown
36 lines
1.5 KiB
Markdown
|
# Touch Input Module
|
||
|
|
|
||
|
|
**Note: TouchInputModule is obsolete. Touch input is now handled in [StandaloneInputModule](script-StandaloneInputModule.md).**
|
||
|
|
|
||
|
|
This module is designed to work with touch devices. It sends pointer events for touching and dragging in response to user input. The module supports multitouch.
|
||
|
|
|
||
|
|
The module uses the scene configured Raycasters to calculate what element is currently being touched over. A raycast is issued for each current touch.
|
||
|
|
|
||
|
|
|
||
|
|
## Properties
|
||
|
|
|
||
|
|
|**_Property:_** |**_Function:_** |
|
||
|
|
|:---|:---|
|
||
|
|
|__Force Module Active__ | Forces this module to be active. |
|
||
|
|
|
||
|
|
## Details
|
||
|
|
|
||
|
|
The flow for the module is as follows:
|
||
|
|
|
||
|
|
- For each touch event
|
||
|
|
- If it is a new press
|
||
|
|
- Send PointerEnter event (sent to every object up the hierarchy that can handle it)
|
||
|
|
- Send PointerPress event
|
||
|
|
- Cache the drag handler (first element in the hierarchy that can handle it)
|
||
|
|
- Send BeginDrag event to the drag handler
|
||
|
|
- Set the 'Pressed' object as Selected in the event system
|
||
|
|
- If this is a continuing press
|
||
|
|
- Process movement
|
||
|
|
- Send DragEvent to the cached drag handler
|
||
|
|
- Handle PointerEnter and PointerExit events if touch moves between objects
|
||
|
|
- If this is a release
|
||
|
|
- Send PointerUp event to the object that received the PointerPress
|
||
|
|
- If the current hover object is the same as the PointerPress object send a PointerClick event
|
||
|
|
- Send a Drop event if there was a drag handler cached
|
||
|
|
- Send a EndDrag event to the cached drag handler
|