Skullper/CropperNoCropper

Cropper - NoCropper

This is a lightweight Image Cropper for Android which also supports no-crop feature.

Here's a short gif showing how it works.

And, here's a bit longer YouTube Video

CropperView

It's a FrameLayout which contains a view for Grid and an imageview. This project supports only square cropping. CropperView contains some basic methods like setImageBitmap(), setMaxZoom(), setMinZoom(), etc which are forwarded to CropperImageView.

It's not an Activity or Fragment. It's just a FrameLayout which you can use anywhere and however you want in your app. There are some styling and customizations also available.

How To Install

Maven

repositories {
    maven {
        url  "http://dl.bintray.com/jayrambhia/maven"
    }
}

JCenter

repositories {
    jcenter()
}

Dependency

dependencies {
    compile 'com.fenchtose.nocropper:nocropper:0.2.0'
}

CropperImageView

It's a square ImageView which acts as the cropper. It tries to keep the image in the range of max and min zoom. It automatically adjusts the position of the image, if it's zoomed out.

How To Use:

<com.fenchtose.nocropper.CropperView
    android:background="#ff282828"
    android:id="@+id/cropper_view"
    android:layout_width="match_parent"
    android:layout_height="0dp"
    app:nocropper__grid_opacity="0.8"
    app:nocropper__grid_thickness="0.8dp"
    app:nocropper__grid_color="@color/colorAccent"
    app:nocropper__padding_color="#ff282828"/>

And that's it. CropperView is ready to be used anywhere in the app. No dependencies.

Useful Methods:

setMaxZoom(float zoom) set Maximum zoom
setMinZoom(float zoom) set Minimum zoom
setImageBitmap(Bitmap bm) set Bitmap
replaceBitmap(Bitmap bm) Replace Bitmap without changing the image matrix
setGestureEnabled(boolean enabled) Enable/Disable Cropper gestures
setDebug(boolean debug) - Debugging mode
cropToCenter() - Set Image in the center with square crop view
fitToCenter() - Fit Image in the center (no cropping view)
setPaddingColor(int color) - Set Color of square image padding
setMakeSquare(boolean status) - If you want to add padding in the cropped image (if cropped image is not square)
isMakeSquare() - Check if cropper will give a square image or not
initWithFitToCenter(boolean fitToCenter) - Cropper will fit image to center instead of cropping to center when bitmap is set.
getCroppedBitmap() - Get Cropped Bitmap
getCroppedBitmapAsync() - Crop bitmap in background thread and get result via CropperCallback.
release() - Remove and Recycle Bitmap

Styleables

nocropper__grid_color - Color of the grid
nocropper__grid_thickness - Thickness of grid lines
nocropper__grid_opacity - Opacity of grid lines
nocropper__padding_color - Color of the image padding
nocropper__add_padding_to_make_square - boolean
nocropper__fit_to_center - boolean - Fit image to center instead of crop when you set a bitmap

0.1 to 0.2 update note:

All the styleables are renamed to have prefix nocropper__ so as not to have collision issues with other resource attributes. By collision I mean, your app will not build if it has to resources attributes with same name.

Licenses and Release History

CHANGELOG

NoCropper binaries and source code can be used according to the Apache License, Version 2.0.

Skullper / CropperNoCropper