Repository files navigation

Godot Touch Input Manager (GDTIM) is an asset that improves touch input support (includesnew gestures) in the Godot game engine. You just need to autoload a script and it will start analyzing the touch input. When a gesture is detected a Custom Input Event corresponding to the detected gesture will be created andfed up to the Godot built in Input Event system so it triggers functions like_input(InputEvent event). There is also a signal for each gesture if you prefer using signals to the aforementioned.

There are two active PRs that add some GDTIM gestures as native Godot events, one forversion 3.x and one forversion 4.x, if you are interested, please show your support there.

• How to use
• Examples
• Documentation
• FAQ

• Download the latest release fromhttps://github.com/Federico-Ciuffardi/Godot-Touch-Input-Manager/releases
• Extract the downloaded.zip file somewhere in you project
• Locate the extractedInputManager.gd, andAutoload it.
• Done! Now you can use GDTIMsignals and Custom Input Events.

• Supported gestures
• Gesture emulation
• Configuration

When one of these gestures is detected a Custom Input Event corresponding to the detected gesture will be created andfed up to the Godot built in Input Event system so it triggers functions like_input(InputEvent event).

The gestures can be triggered by namedinput actions with specific names. If the inputaction does not exists there is a default event that will trigger the gesture.

The following table shows the default event and the names of the input actionsthat will trigger each of the gestures that can be emulated.

* There are two options to enable single finger gestures:

1. Go toProject > Project Settings > General > Input Devices > Pointingand turn onEmulate Touch From Mouse to emulate a single finger touch withthe left click.
2. Go toProject > Project Settings > General > Input Devices > Pointingand turn off bothEmulate Touch From Mouse andEmulate Mouse From Touch.Then set an input action calledsingle_touch.

These are located in the first lines ofInputManager.gd, to change them modify thevalues on the script.

By default, the control nodes consume events and therefore GDTIM cannot analyze them. To prevent this, setMouse>Filter toIgnore on control nodes as needed.

For more information see thedocumentation.

Custom input events do not trigger collisions, at the moment the solution is to manually check for collisions between shapes and events. For more information and ideas on how to do this seethis issue.

UsingSemVer for versioning. For the versions available, see thereleases.

• Federico Ciuffardi

Feel free to append yourself here if you've made contributions.

Thank you for checking out this repository, you can send all your questions and comments toFederico.Ciuffardi@outlook.com.

If you are willing to contribute in any way, please contact me.