Easy to use, lightweight custom image view with rounded corners.

Overview

RoundedImageView

Easy to use, lightweight custom image view with rounded corners.
Explore the docs »

View Demo · Report Bug · Request Feature

About The Project

This library allows you to create ImageViews with soft edges that are pleasing to the eye.

Built With

Getting Started

To make this view running on your app follow these simple steps.

1. Add the JitPack repository to your project level build.gradle file

allprojects {
  repositories {
    ...
    maven { url 'https://jitpack.io' }
  }
}

2. Add the dependency to your module level build.gradle file

dependencies {
  implementation 'com.github.mmmelik:RoundedImageView:v1.0.1'
}

Usage

RoundedImageView extends ImageView so all functions of ImageView are available for RoundedImageView.

Java

RoundedImageView roundedImageView=findViewById(R.id.roundedImageView);
roundedImageView.setRadius(5); //Sets radius of all corners
roundedImageView.setRadius(RoundedImageView.Corner.BOTTOM_LEFT,50); //Override BOTTOM_LEFT corner.
roundedImageView.setImageDrawable(getResources().getDrawable(R.drawable.free)); //First set radius then set drawable.

XML

<com.appbroker.roundedimageview.RoundedImageView
        android:id="@+id/roundedImageView"
        android:layout_width="wrap_content"
        android:layout_height="150dp"
        android:src="@drawable/free"
        app:radius="50dp"/>

<com.appbroker.roundedimageview.RoundedImageView
        android:id="@+id/roundedImageView2"
        android:layout_width="wrap_content"
        android:layout_height="150dp"
        android:src="@drawable/free"
        app:topLeftRadius="10dp"
        app:topRightRadius="20dp"
        app:bottomRightRadius="30dp"
        app:bottomLeftRadius="40dp"/>

<com.appbroker.roundedimageview.RoundedImageView
        android:id="@+id/roundedImageView3"
        android:layout_width="wrap_content"
        android:layout_height="150dp"
        android:src="@drawable/free"
        app:radius="50dp"
        app:bottomRightRadius="0dp"/>

Troubleshooting

In RoundedImageView XML attribute android:adjustViewBounds set to true by default. If it cause unintended behaviour of the view override with android:adjustViewBounds="false".

RoundedImageView does not manipulate drawable of the view. Only clips out the corners of the view. So make sure you have fully wrapped drawable with the views borders.

Roadmap

See the open issues for a list of proposed features (and known issues).

Contributing

Contributions are what make the open source community such an amazing place to be learn, inspire, and create. Any contributions you make are greatly appreciated.

Fork the Project
Create your Branch
Commit your Changes
Push to the Branch
Open a Pull Request

You might also like...

Image Picker for Android 🤖

1k Dec 31, 2022

ZoomableComposeImage - A zoomable image for jetpack compose

10 Dec 11, 2022

ComposeImageBlurhash is a Jetpack Compose component with the necessary implementation to display a blurred image

compose-image-blurhash ComposeImageBlurhash is a Jetpack Compose component with the necessary implementation to display a blurred image while the real

24 Nov 18, 2022

load-the-image Apply to compose-jb(desktop), Used to load network and local pictures.

load-the-image load-the-image Apply to compose-jb(desktop), Used to load network and local pictures. 🚀 Under construction It may change incompatibly

13 Dec 29, 2022

Compose Image library for Kotlin Multiplatform.

Compose ImageLoader Compose Image library for Kotlin Multiplatform. Setup Add the dependency in your common module's commonMain sourceSet kotlin {

45 Dec 29, 2022

Custom shaped android imageview components

Shape Image View Provides a set of custom shaped android imageview components, and a framework to define more shapes. Implements both shader and bitma

2.6k Jan 8, 2023

An Android library for managing images and the memory they use.

Fresco Fresco is a powerful system for displaying images in Android applications. Fresco takes care of image loading and display, so you don't have to

16.9k Jan 8, 2023

An Android view for displaying repeated continuous side scrolling images. This can be used to create a parallax animation effect.

Scrolling Image View An Android view for displaying repeated continuous side scrolling images. This can be used to create a parallax animation effect.