android-crop/README.md

I guess people are just cropping out all the sadness

This is yet another Android library project providing a simple image cropping Activity, based on code from AOSP.

Goals

I started this in my hacker time with the intention of replacing our dated android-cropimage fork.

• Gradle build
• AAR & ApkLib artifacts
• Backwards compatible to Gingerbread
• Example project
• Add tests and strip out unused complexity
• Better programming interface
• Modern user interface
• Fix bugs!

Usage

First, declare CropImageActivity in your manifest file:

<activity android:name="com.soundcloud.android.crop.CropImageActivity" />

Crop

new Crop(inputUri).output(outputUri).asSquare().start(activity)

Listen for the result of the crop:

protected void onActivityResult(int requestCode, int resultCode, Intent result) {
    if (resultCode == RESULT_OK && requestCode == Crop.REQUEST_CROP) {
        if (Crop.isError(result)) {
        	// Do some error handling with Crop.getError(result)
    	} else {
        	// Do something with your cropped image!
    	}
    }
}

Pick

The library provides a utility method to start an image picker:

Crop.pickImage(activity)

How does it look?

License & Credits

Apache License, version 2. Most of the cropping code is from AOSP. Thanks to android-cropimage contributors.