CircularImageView

The CircularImageView is a custom view that displays an image in a circular shape. It provides a simple and convenient way to display circular profile pictures or any other circular images in your Android application.

Features

• Displays an image in a circular shape
• Supports loading images from various sources (local file, drawable, URL, etc.)
• Provides options to customize the appearance
• Supports click events and callbacks

Installation

To use CircularImageView in your Android project, you can add the following dependency to your app-level build.gradle file:

implementation 'com.mikhaellopez:circularimageview:4.3.0'

Usage

To add a CircularImageView to your layout, you can use the following XML code:

<com.mikhaellopez.circularimageview.CircularImageView
    android:id="@+id/circularImageView"
    android:layout_width="200dp"
    android:layout_height="200dp"
    app:civ_border_color="#FF000000"
    app:civ_border_width="2dp"
    app:civ_shadow="true"
    app:civ_shadow_radius="5"
    app:civ_shadow_color="#8BC34A"
    app:civ_shadow_gravity="center"
    app:civ_image="@drawable/profile_image" />

You can customize the appearance of the CircularImageView using the following XML attributes:

• civ_border_color: Specifies the color of the border (default is transparent)
• civ_border_width: Specifies the width of the border in dp (default is 0)
• civ_shadow: Specifies whether to show a shadow around the image (default is false)
• civ_shadow_radius: Specifies the radius of the shadow in dp (default is 4)
• civ_shadow_color: Specifies the color of the shadow (default is #000000)
• civ_shadow_gravity: Specifies the gravity of the shadow (default is center)
• civ_image: Specifies the drawable resource or URL of the image

In your Java or Kotlin code, you can programmatically set the image using the setImageDrawable() or setImageBitmap() methods:

CircularImageView circularImageView = findViewById(R.id.circularImageView);
circularImageView.setImageDrawable(getResources().getDrawable(R.drawable.profile_image));

You can also handle click events on the CircularImageView by setting an OnClickListener:

circularImageView.setOnClickListener(new View.OnClickListener() {
    @Override
    public void onClick(View v) {
        // Handle the click event here
    }
});

Conclusion

The CircularImageView is a helpful library for displaying circular images in your Android application. It simplifies the process of creating circular profile pictures or circular image views with various customization options.