# android-gesture-detectors

**Repository Path**: mirrors_razerdp/android-gesture-detectors

## Basic Information

- **Project Name**: android-gesture-detectors
- **Description**: Gesture detector framework for multitouch handling on Android, based on Android's ScaleGestureDetector
- **Primary Language**: Unknown
- **License**: BSD-2-Clause
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2020-09-25
- **Last Updated**: 2026-04-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

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](http://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.