shprotx/cropify

Image Cropper for Android Jetpack Compose.

Cropify

Lightweight image cropper for Android Jetpack Compose.

sample.mov

Installation

1. Add the JitPack repository to your root build.gradle.

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

2. Add the dependency.

dependencies {
  implementation("com.github.shprotx:Cropify:9f6ed84684")
}

Usage

Bitmap

val state = rememberCropifyState()

Cropify(
  bitmap = imageResource(R.drawable.bitmap),
  state = state,
  initFullSizeFrame = true, // if you want max size frame at start
  onImageCropped = {},
)

Uri

val state = rememberCropifyState()

Cropify(
  uri = imageUri,
  state = state,
  initFullSizeFrame = true, // if you want max size frame at start
  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

I would like to thank ArthurHub/Android-Image-Cropper.
Cropify aims to a Jetpack Compose implementation of ArthurHub/Android-Image-Cropper.