ImageCropper

Robust, easy-to-use library for cropping images with a single codebase, featuring a user-friendly UI and supporting both Android and Desktop platforms.

#ui
#image
#file
#desktop

Suggest an edit

Android JVMJVMKotlin/Native

GitHub stars28

Authorsmarwanm7moud

Open issues2

Creation dateover 2 years ago

Last activityover 2 years ago

Latest releaseBeta-0.0.4 (over 2 years ago)

GitHub repository Wiki page

Kotlin Multiplatform Image Cropper (Beta)

Kotlin Multiplatform Image Cropper is a robust, easy-to-use library designed for image cropping across Android, iOS, and other platforms using the Kotlin Multiplatform Mobile (KMM) technology.

Features

Crop images on Android and Desktop with a single codebase.
Easy-to-use UI.
Supported platforms: Android, Desktop.

How to use?

Add dependency in your module build.gradle

dependencies {
    implementation("io.github.marwanm7moud:cropper:$latest_release")
}

Examples

Use Image Cropper with string File Path direct

@Composable
fun ImageCropperSample(){
    var crop by remember { mutableStateOf(false) }
    var isCropping by remember { mutableStateOf(false) }
    var croppedImage by remember { mutableStateOf<ImageBitmap?>(null) }
    var filePath = "" //add here your file path
    Box(
        modifier = Modifier.fillMaxSize().background(Color.Black),
        contentAlignment = Alignment.Center
    ) {
        ImageCropper(
            modifier = Modifier.fillMaxSize(0.7f),
            imagePath = filePath,
            onCropStart = {
                isCropping = true
            },
            onCropSuccess = {
                croppedImage = it
                isCropping = false
                crop = false
            },
            crop = crop
        )
        Button(
            onClick = {
                crop = true
            },
            modifier = Modifier
                .padding(16.dp).align(Alignment.TopEnd)
        ) {
            Text("Crop Image")
        }

        // Display the cropped image if available
        croppedImage?.let { cropped ->
            Image(
                bitmap = cropped,
                contentDescription = null,
                modifier = Modifier
                    .size(200.dp, 200.dp).align(Alignment.TopStart) // Adjust the size as needed
            )
        }
    }
}

You can use Image Bitmap direct

@Composable
fun ImageCropperSample(image:ImageBitmap){
    var crop by remember { mutableStateOf(false) }
    var isCropping by remember { mutableStateOf(false) }
    var croppedImage by remember { mutableStateOf<ImageBitmap?>(null) }
    Box(
        modifier = Modifier.fillMaxSize().background(Color.Black),
        contentAlignment = Alignment.Center
    ) {
        ImageCropper(
            modifier = Modifier.fillMaxSize(0.7f),
            image = image,
            onCropStart = {
                isCropping = true
            },
            onCropSuccess = {
                croppedImage = it
                isCropping = false
                crop = false
            },
            crop = crop
        )
        Button(
            onClick = {
                crop = true
            },
            modifier = Modifier
                .padding(16.dp).align(Alignment.TopEnd)
        ) {
            Text("Crop Image")
        }

        // Display the cropped image if available
        croppedImage?.let { cropped ->
            Image(
                bitmap = cropped,
                contentDescription = null,
                modifier = Modifier
                    .size(200.dp, 200.dp).align(Alignment.TopStart) // Adjust the size as needed
            )
        }
    }
}