/android-gesture-detectors

Gesture detector framework for multitouch handling on Android, based on Android's ScaleGestureDetector

Primary LanguageJavaOtherNOASSERTION

Android Gesture Detectors Framework

Introduction

Since I was amazed Android has a ScaleGestureDetector since API level 8 but (still) no such thing as a RotateGestureDetector I decided to create this class myself. In the process I decided to create a small extendable framework for GestureDetectors in general.

Download

Gradle

compile 'com.almeros.android-gesture-detectors:library:1.0'

Maven

<dependency>
    <groupId>com.almeros.android-gesture-detectors</groupId>
    <artifactId>library</artifactId>
    <version>1.0</version>
</dependency>

Tutorials

Using gesture detectors

If you want to use the ScaleGestureDetector and/or the gesture detectors from this project, please read my tutorial: code.almeros.com/android-multitouch-gesture-detectors

Extending

If you want to extend this framework with new gesture detectors please read my tutorial about that here: coming soon

I hope you'll send me a pull request with your FingerTwistGestureDetector or something ;)

Containments

RotateGestureDetector

Helps finding out the rotation angle between the line of two fingers (with the normal or previous finger positions)

MoveGestureDetector

Convenience gesture detector to keep it easy moving an object around with one ore more fingers without losing the clean usage of the gesture detector pattern.

ShoveGestureDetector

Detects a vertical two-finger shove. (If you place two fingers on screen with less than a 20 degree angle between them, this will detact movement on the Y-axis.)

ScaleGestureDetector (default Android)

This one is NOT in this framework, but is gesture detector that resides in the Android API since API level 8 (2.2).

BaseGestureDetector (abstract)

Abstract class that every new gesture detector class should extend.

TwoFingerGestureDetector (abstract)

Abstract class that extends the BaseGestureDetector and that every new gesture detector class for two finger operations should extend.

License

This project is licensed with the 2-clause BSD license.