What is Transformers?
An Android transformation library providing a variety of image transformations for Coil, Glide, Picasso, and Fresco.
Part of the sample
Glide Transformations, Picasso Transformations, Fresco Processors are deprecated.
Development will stop soon.. For an up-to-date version, please use this.
Installation
Requirements
- Android 5.0+ Lollipop (API level 21)
Gradle settings
repositories {
mavenCentral()
}
This Transformer is NOT using android.support.v8.rendererscript because librs.so make the APK file too big.
For Coil
dependencies {
implementation 'jp.wasabeef.transformers:coil:1.0.3'
// Use the GPU Filters
implementation 'jp.wasabeef.transformers:coil-gpu:1.0.3'
}
imageView.load(IMAGE_URL) {
transformations(
CropCenterTransformation(),
RoundedCornersTransformation(radius = 120, cornerType = CornerType.DIAGONAL_FROM_TOP_LEFT)
)
}
For Glide
dependencies {
implementation 'jp.wasabeef.transformers:glide:1.0.3'
// Use the GPU Filters
implementation 'jp.wasabeef.transformers:glide-gpu:1.0.3'
}
Glide.with(context)
.load(IMAGE_URL)
.apply(
bitmapTransform(
MultiTransformation(
CropCenterTransformation(),
BlurTransformation(context, 15, sampling = 1)
)
)
).into(imageView)
For Picasso
dependencies {
implementation 'jp.wasabeef.transformers:picasso:1.0.3'
// Use the GPU Filters
implementation 'jp.wasabeef.transformers:picasso-gpu:1.0.3'
}
Picasso.get()
.load(IMAGE_URL)
.fit().centerInside()
.transform(
mutableListOf(
CropCenterTransformation(),
BlurTransformation(context, 25, sampling = 4)
)
).into(imageView)
For Fresco
dependencies {
implementation 'jp.wasabeef.transformers:fresco:1.0.3'
// Use the GPU Filters
implementation 'jp.wasabeef.transformers:fresco-gpu:1.0.3'
}
val request: ImageRequest =
ImageRequestBuilder.newBuilderWithSource(IMAGE_URL.toUri())
.setPostprocessor(BlurPostprocessor(context, 25, 4))
.build()
holder.image.controller = Fresco.newDraweeControllerBuilder()
.setImageRequest(request)
.setOldController(draweeView.controller)
.build()
With Jetpack Compose
Use Composable Images when using with Jetpack Compose.
GlideImage(
model = IMAGE_URL,
modifier = Modifier.preferredWidth(120.dp),
options = RequestOptions().transform(
BlurTransformation(context, radius = 25, sampling = 4)
)
)
Sample transformations
| Original | Mask | NinePatchMask | CropTop |
|---|---|---|---|
|
|
 |
 |
| CropCenter | CropBottom | CropCenterRatio16x9 | CropCenterRatio4x3 |
 |
 |
 |
 |
| CropTopRatio16x9 | CropBottomRatio4x3 | CropSquare | CropCircle |
 |
 |
 |
|
| CropCircleWithBorder | ColorFilter | Grayscale | RoundedCorners |
 |
 |
 |
 |
| RoundedCornersTopLeft | RSGaussianBlurLight | RSGaussianBlurDeep | StackBlurLight |
|
 |
|
 |
| StackBlurDeep | |||
 |
coil, glide, picasso
- BlurTransformation
- ColorFilterTransformation
- CropCenterBottomTransformation
- CropCenterTopTransformation
- CropCenterTransformation
- CropCircleTransformation
- CropCircleWithBorderTransformation
- CropSquareTransformation
- CropTransformation
- GrayscaleTransformation
- MaskTransformation
- RoundedCornersTransformation
fresco
- BlurPostprocessor
- ColorFilterPostprocessor
- CombinePostProcessors
- GrayscalePostprocessor
- MaskPostprocessor
Sample transformations with GPUImage
We recommend that you have a ToneCurve file, as you can apply any filters you like.
| Original | Sepia | Contrast | Invert |
|---|---|---|---|
|
 |
 |
 |
| PixelLight | PixelDeep | Sketch | Swirl |
 |
|
 |
 |
| Brightness | Kuawahara | Vignette | ZoomBlur |
 |
|
|
|
| WhiteBalance | Halftone | Sharpness | Toon |
 |
 |
 |
 |
| ToneCurve | |||
|
coil-gpu, glide-gpu, picasso-gpu
- BrightnessFilterTransformation
- ContrastFilterTransformation
- HalftoneFilterTransformation
- InvertFilterTransformation
- KuwaharaFilterTransformation
- PixelationFilterTransformation
- SepiaFilterTransformation
- SharpenFilterTransformation
- SketchFilterTransformation
- SwirlFilterTransformation
- ToneCurveFilterTransformation
- ToonFilterTransformation
- VignetteFilterTransformation
- WhiteBalanceFilterTransformation
- ZoomBlurFilterTransformation
fresco-gpu
- BrightnessFilterPostprocessor
- ContrastFilterPostprocessor
- HalftoneFilterPostprocessor
- InvertFilterPostprocessor
- KuwaharaFilterPostprocessor
- PixelationFilterPostprocessor
- SepiaFilterPostprocessor
- SharpenFilterPostprocessor
- SketchFilterPostprocessor
- SwirlFilterPostprocessor
- ToneCurveFilterPostprocessor
- ToonFilterPostprocessor
- VignetteFilterPostprocessor
- WhiteBalanceFilterPostprocessor
- ZoomBlurFilterPostprocessor
Development
Setup
Things you will need
- Linux, Mac OS X, or Windows.
- Android Studio (Preview)
- npm
$ npm install
Build
$ ./gradlew assemble
Formatting
$ ./gradlew ktlint
Publishing to Maven Central
$ ./gradlew clean build publish
812 Dec 30, 2022
4 Jan 1, 2022
8 Nov 21, 2022
1.1k Dec 30, 2022
640 Nov 19, 2022
15 Sep 2, 2020
20 Jan 23, 2022
9 Jul 27, 2022
2.9k Nov 14, 2022
1.8k Dec 19, 2022
162 Sep 13, 2022
1k Dec 1, 2022
6.7k Dec 31, 2022
2.5k Dec 28, 2022
426 Dec 22, 2022
64 Nov 15, 2022
19 May 28, 2022