Simple image cropping library enabling customizable cropping features, including color, crop area, and aspect ratio. Offers integration with Compose Multiplatform for versatile image manipulation.
With this tool you can crop images in Compose Multiplatform.
In your shared module's build.gradle.kts add:
kotlin.sourceSets.commonMain.dependencies {
implementation("tech.ryadom:origami:0.0.6")
}
To create an Origami instance, you need to call any of Origami constructors and pass
source (now supports ImageBitmap and Painter) and options as arguments.
Then use the Origami object as shown below.
val source = createYourSource()
val colors = object: OrigamiColors { } // Customize colors
val cropArea = OrigamiCropArea() // Customize crop area
val aspectRatio = OrigamiAspectRatio() // Customize aspect ratio
val origami = Origami(source, colors, cropArea, aspectRatio)
OrigamiImage(origami = origami)
// Returns cropped image
origami.crop()
With OrigamiColors you can customize backgroundColor, guidelinesColor and edgesColor:
interface OrigamiColors {
val backgroundColor: Color
val guidelinesColor: Color
val edgesColor: Color
}
With OrigamiCropArea you can customize the crop area:
2.1. Number and width of guidelines
2.2. Shape edges via OrigamiEdges. You can use the default Circle or Rectangle shape, or
create your own using DrawScope
2.3. The highlighted area of the shape via OrigamiHighlightedShape. You can use Circle,
Rectangle (default) or RoundedRectangle by default or create your own shape
2.4. Crop area initial paddings via OrigamiCropAreaPadding
data class OrigamiCropArea(
val highlightedShape: OrigamiHighlightedShape = OrigamiHighlightedShape.Default,
val edges: OrigamiEdges? = OrigamiEdges.Circle(6.dp),
val guidelinesWidth: Dp = 2.dp,
val guidelinesCount: Int = 2,
val initialPaddings: OrigamiCropAreaPadding = OrigamiCropAreaPadding.createDefault()
)
With OrigamiAspectRatio you can specify any width / height ratio of crop area you need.
data class OrigamiAspectRatio(
val isVariable: Boolean = false,
val aspectRatio: Float = 1f
)
Copyright 2025 Ryadom Tech
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance the License.
You may obtain a copy of the License at
http:
Unless applicable law agreed to writing, software
distributed under the License distributed an BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express implied.
See the License the specific language governing permissions
limitations under the License.
If you find a bug or want to contribute an improvement, please create an Issue or send an email to opensource@ryadom.tech. Any support will be appreciated.
| Target | Implemented | Tested |
|---|
| Android | ☑ | ☑ |
| iOS | ☑ | ☑ |
| JVM Desktop | ☑ | ☑ |
| JS | ☑ | ☑ |
| WasmJS | ☑ | ☑ |
Surfaced from shared tags and platforms — no rankings paid for.