Skip to content

Instantly share code, notes, and snippets.

What would you like to do?
CircleTransform for Picasso
* Copyright 2014 Julian Shen
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* See the License for the specific language governing permissions and
* limitations under the License.
package com.example.picassodemo;
import com.squareup.picasso.Transformation;
* Created by julian on 13/6/21.
public class CircleTransform implements Transformation {
public Bitmap transform(Bitmap source) {
int size = Math.min(source.getWidth(), source.getHeight());
int x = (source.getWidth() - size) / 2;
int y = (source.getHeight() - size) / 2;
Bitmap squaredBitmap = Bitmap.createBitmap(source, x, y, size, size);
if (squaredBitmap != source) {
Bitmap bitmap = Bitmap.createBitmap(size, size, source.getConfig());
Canvas canvas = new Canvas(bitmap);
Paint paint = new Paint();
BitmapShader shader = new BitmapShader(squaredBitmap, BitmapShader.TileMode.CLAMP, BitmapShader.TileMode.CLAMP);
float r = size/2f;
canvas.drawCircle(r, r, r, paint);
return bitmap;
public String key() {
return "circle";
Copy link

vuhung3990 commented May 28, 2015

thank you, but why it not work on android 2.3 (geanymotion)

Copy link

komalnikhare commented Jun 20, 2015

not working properly in 2.3

Copy link

heitorcolangelo commented Aug 19, 2015

Thanks alxscms, worked!

Copy link

EternalCoding commented Sep 2, 2015

really cool

Copy link

dtygel commented Oct 26, 2015

I've incorporated alxscms suggested change so that the script works with gif and other palletted bitmaps:

Copy link

oradkovsky commented Nov 8, 2015


Copy link

mananwason commented Nov 12, 2015

I get a Null pointer @julianshen. This is the stack Trace. Thanks for the help.
java.lang.NullPointerException: Transformation circle returned null after 0 previous transformation(s).

Copy link

ayushgp commented Jan 24, 2016

Finally after 3 hours of wasting my time on stackoverflow, I found this! Thanks a ton!

Copy link

reenadeng commented Apr 5, 2016

Thank you!!!!!!

Copy link

codezjx commented May 4, 2016

We can use shader.setLocalMatrix() method to draw circle bitmap not from source bitmap left-top. So, there is no need to create square bitmap! You can find the optimized version here:

Copy link

jay915 commented May 5, 2016

Thank you

Copy link

stephenrichard commented Jun 12, 2016

Thank you that's perfect !

Copy link

zionix357 commented Aug 6, 2016


Copy link

Shujito commented Oct 7, 2016

I'll star it

Copy link

naveedshamim commented Nov 4, 2016

Excellent .........

Copy link

MohamaedGamal commented Feb 8, 2017

how used it in main ?

Copy link

Inn0vat0r commented Feb 16, 2017

Thanks @alxscms for gif config help.

Copy link

alexbbb13 commented Mar 22, 2017

Thanks @alexcms for GIF config
Exception: Attempt to read from field 'int$Config.nativeInt' on a null object reference
Solution (As suggested by @alexcms) : Replace line 42 with

Bitmap.Config config = source.getConfig() != null ? source.getConfig() : Bitmap.Config.ARGB_8888;
Bitmap bitmap = Bitmap.createBitmap(size, size, config);

Copy link

shahalRahman commented Jun 1, 2017

You saved my job, Thanks a lot man 👍

Copy link

mvn-quocnguyen-dn commented Jun 19, 2017

I need your help ! How can I custom Rounded ImageView depend radius !

Copy link

pvthiendeveloper commented Jun 22, 2017

Thanke you.

Copy link

hare451g commented Nov 8, 2017

thanks, hero

Copy link

emitchel commented Nov 15, 2017

Good stuff here, 👍

Copy link

lxww14 commented Dec 21, 2017

imageview has black backgound how change it to transparent

Copy link

flaviossantana commented Apr 18, 2018


Copy link

nicola-coolshop commented Jun 25, 2018

Why it crop the image?

Copy link

G00fY2 commented Oct 3, 2018

Copy link

robinkanatzar commented Apr 9, 2019

Thank you!!!

Copy link

efanious commented Aug 21, 2019


Copy link

Maragues commented Apr 29, 2020


On a huawei P10 Mate, applying this transformation is 5ms on average (in our case, ofc)

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment