Cropify

Lightweight image cropper for Android Jetpack Compose.

sample.mov

Installation

Add the JitPack repository to your root build.gradle.

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

Add the dependency.

dependencies {
  implementation 'com.github.moyuruaizawa:cropify:${cropifyVersion}'
}

Usage

Bitmap

val state = rememberCropifyState()

Cropify(
  bitmap = imageResource(R.drawable.bitmap),
  state = state,
  onImageCropped = {},
)

Uri

val state = rememberCropifyState()

Cropify(
  uri = imageUri,
  state = state,
  onImageCropped = {},
  onFailedToLoadImage = {}
)

Invoke CropifyState#crop, the cropped image will be passed to onImageCropped. If loading an image from Uri fails, onFailedToLoadImage will be called.

Features

Cropping.
set Bitmap or load android.net.Uri.
Bitmap memory optimization.
API Level 21+.

Customizations

Cropping frame color.
Cropping frame alpha.
Cropping frame stroke width.
Cropping frame aspect ratio.
Grid line color.
Grid line alpha.
Grid line stroke width.
Mask (outside of cropping frame) color.
Mask alpha.
Background color.

Acknowledgement