Skip to content

lockeb/CircleImageView-Xamarin

Repository files navigation

#Xamarin C# port of CircleImageView

Ported from https://github.com/hdodenhof/CircleImageView

CircleImageView

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

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

            <blocke.circleimageview.CircleImageView
                android:id="@+id/profile_image"
                android:layout_width="96dp"
                android:layout_height="96dp"
                android:src="@drawable/homer"
                app:civ_border_width="2dp"
                app:civ_border_color="@android:color/white"
                app:civ_border_overlay="true" 
                app:civ_fill_color="@android:color/black"  />
			var largeprofileimage = FindViewById<CircleImageView>(Resource.Id.large_profile_image);
			var fillimage = FindViewById<CircleImageView>(Resource.Id.fill_image);

			largeprofileimage.SetImageResource(Resource.Drawable.homer);
			largeprofileimage.SetBorderColor(Color.Blue);
			largeprofileimage.SetBorderWidth(20);
			largeprofileimage.SetBorderOverlay(true);

			fillimage.SetImageResource(Resource.Drawable.profile);
			fillimage.SetFillColor (Color.OrangeRed);
			fillimage.SetBorderColor (Color.ForestGreen);
			fillimage.SetBorderWidth (10);
			fillimage.SetBorderOverlay (true);

Limitations

  • The ScaleType is always CENTER_CROP 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.

Changelog

  • 2.0.0
    • BREAKING: Custom xml attributes are now prefixed with "civ_"
    • Graceful handling of incompatible drawables
    • Add support for a fill color shown behind images with transparent areas
    • Fix dimension calculation issues with small images
    • Fix bitmap not being cleared when set to null
  • 1.3.0
    • Add setBorderColorResource(int resId)
    • Add resource type annotations
    • Add border_overlay attribute to allow drawing border on top of the base image
  • 1.2.2
    • Add ColorFilter support
  • 1.2.1
    • Fix ColorDrawables not being rendered properly on Lollipop
  • 1.2.0
    • Add support for setImageURI(Uri uri)
    • Fix view not being initialized when using CircleImageView(Context context)
  • 1.1.1
    • Fix border being shown although border width is set to 0
  • 1.1.0
    • Add support for ColorDrawables
    • Add getters and setters for border color and border width
  • 1.0.1
    • Prevent crash due to OutOfMemoryError
  • 1.0.0
    • Initial release

Credits

Henning Dodenhof for create its library FloatingActionButton.

About

A fast circular ImageView perfect for profile images

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages