Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/championswimmer/simplefingergestures_android_library

Android Library to implement simple touch/tap/swipe gestures
https://github.com/championswimmer/simplefingergestures_android_library

Last synced: 13 days ago
JSON representation

Android Library to implement simple touch/tap/swipe gestures

Awesome Lists containing this project

README

        

# SimpleFingerGestures
An android library to implement simple 1 or 2 finger gestures easily

[![Paypal Donate](https://img.shields.io/badge/Donate-Paypal-2244dd.svg)](https://paypal.me/championswimmer)

[![Book session on Codementor](https://cdn.codementor.io/badges/book_session_github.svg)](https://www.codementor.io/championswimmer?utm_source=github&utm_medium=button&utm_term=championswimmer&utm_campaign=github)

[![Build Status](https://travis-ci.org/championswimmer/SimpleFingerGestures_Android_Library.svg)](https://travis-ci.org/championswimmer/SimpleFingerGestures_Android_Library)
[![Android Arsenal](https://img.shields.io/badge/Android%20Arsenal-SimpleFingerGestures-brightgreen.svg?style=flat)](http://android-arsenal.com/details/1/777)
[![Release](https://jitpack.io/v/in.championswimmer/SimpleFingerGestures_Android_Library.svg)](https://jitpack.io/#in.championswimmer/SimpleFingerGestures_Android_Library)

## Example
![](./screens/1.gif) ![](./screens/2.gif)
![](./screens/4.gif) ![](./screens/3.gif)

## Library
The library is inside the libSFG folder

## Sample App
The sample App is inside the sample folder

### Implementing SimpleFingerGestures

1. Create an object of class SimpleFingerGestures

```java
private SimpleFingerGestures mySfg = new SimpleFingerGestures();
```

2. Implement the required gestures via this object

```java
mySfg.setOnFingerGestureListener(new SimpleFingerGestures.OnFingerGestureListener() {
@Override
public boolean onSwipeUp(int fingers, long gestureDuration, double gestureDistance) {
grtv.setText("swiped " + fingers + " up");
return false;
}

@Override
public boolean onSwipeDown(int fingers, long gestureDuration, double gestureDistance) {
grtv.setText("swiped " + fingers + " down");
return false;
}

@Override
public boolean onSwipeLeft(int fingers, long gestureDuration, double gestureDistance) {
grtv.setText("swiped " + fingers + " left");
return false;
}

@Override
public boolean onSwipeRight(int fingers, long gestureDuration, double gestureDistance) {
grtv.setText("swiped " + fingers + " right");
return false;
}

@Override
public boolean onPinch(int fingers, long gestureDuration, double gestureDistance) {
grtv.setText("pinch");
return false;
}

@Override
public boolean onUnpinch(int fingers, long gestureDuration, double gestureDistance) {
grtv.setText("unpinch");
return false;
}

@Override
public boolean onDoubleTap(int fingers) {
return false;
}
});
```

3. And finally set this object onto your view's OnTouchListener

myView.setOnTouchListener(mySfg);

This can be set as the OnTouchListener of any object that is derived from android.view.View

### How to add to your project

The easiest way to add to your project is the download the latest zip from the Releases tab.
Inside you'll find a compiled library in .jar format that you can just drop in to the
libs folder of your Android app project for it to get automatically added as a library

Also you can add it using jitpack maven distribution.
Add the jitpack maven repository

```groovy
repositories {
jcenter()
maven {
url "https://jitpack.io"
}
}
```

Add the dependency

```groovy

dependencies {
compile 'in.championswimmer:SimpleFingerGestures_Android_Library:1.2'
}
```

### Documentation

Find documentation at

http://championswimmer.github.io/SimpleFingerGestures_Android_Library/documentation