CircleImageView for Xamarin.Android

A fast circular ImageView perfect for profile images. This is a binding of CircleImageView from Henning Dodenhof based on RoundedImageView from Vince Mi which itself is based on techniques recommended by Romain Guy.

Download NuGet

https://www.nuget.org/packages/Refractored.Controls.CircleImageView/

It uses a BitmapShader and does not:

• create a copy of the original bitmap
• use a clipPath (which is neither hardware accelerated nor anti-aliased)
• use setXfermode to clip the bitmap (which means drawing twice to the canvas)

As this is just a custom ImageView and not a custom Drawable or a combination of both, it can be used with all kinds of drawables, i.e. a PicassoDrawable from Picasso or other non-standard drawables (needs some testing though).

Usage

<refractored.controls.CircleImageView
    xmlns:app="http://schemas.android.com/apk/res-auto"
    android:id="@+id/profile_image"
    android:layout_width="96dp"
    android:layout_height="96dp"
    android:src="@drawable/profile"
    app:civ_border_width="2dp"
    app:civ_border_color="#FF000000"/>

Limitations

• The ScaleType is always CenterCrop and you'll get an exception if you try to change it. This is (currently) by design as it's perfectly fine for profile images.
• Enabling AdjustViewBounds is not supported as this requires an unsupported ScaleType
• If you use Picasso for fetching images, you need to set the NoFade() option to avoid messed up images. If you want to keep the fadeIn animation, you have to fetch the image into a Target and apply a custom animation when setting it as source for the CircleImageView in OnBitmapLoaded().
• Using a TransitionDrawable with CircleImageView doesn't work properly and leads to messed up images.

License

Copyright 2015 Refractored LLC/James Montemagno

Original License
Copyright 2014 - 2015 Henning Dodenhof

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

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.