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

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