nanyangtaiji/swipeimageview

Swipe/zoom/pinch ImageView for Android

SwipeImageView

Swipe/zoom/pinch ImageView for Android.

How to include

Gradle

Add the JitPack repository in your root build.gradle at the end of repositories:

allprojects {
	repositories {
		...
		maven { url 'https://jitpack.io' }
	}
}

Then add the dependency in your app/build.gradle:

dependencies {
	implementation 'com.github.markusfisch:SwipeImageView:1.2.1'
}

Android Archive

Alternatively you may just download the latest aar from Releases and put it into app/libs in your app.

Then make sure your app/build.gradle contains the following line in the dependencies block:

dependencies {
	implementation fileTree(dir: 'libs', include: '*')
	...
}

How to use

Add it to a layout:

<de.markusfisch.android.swipeimageview.widget.SwipeImageView
	xmlns:android="http://schemas.android.com/apk/res/android"
	android:id="@+id/swipe_view"
	android:layout_width="match_parent"
	android:layout_height="match_parent"/>

Or create it in java:

import de.markusfisch.android.swipeimageview.widget.SwipeImageView;

SwipeImageView swipeImageView = new SwipeImageView(context);

Then, set up the images to display from a Cursor:

swipeImageView.setImages(cursor, columnName, startIndex);

Make sure to always invoke SwipeImageView.closeCursor() to close the transferred cursor:

@Override
public void onDestroy() {
	super.onDestroy();
	swipeImageView.closeCursor();
}

If you don't have a Cursor for your image collection, you may simply use a MatrixCursor:

String columnName = "path";
cursor = new MatrixCursor(new String[]{columnName});
for (String path : paths) {
	cursor.addRow(new Object[]{path});
}
swipeImageView.setImages(cursor, columnName, index);

Make sure to call SwipeImageView.closeCursor() here too.

Demo

This is a demo app you may use to see and try if this widget is what you're searching for. Either import it into Android Studio or, if you're not on that thing from Redmond, just type make to build, install and run.

License

This widget is so basic, it should be Public Domain. And it is.