Home

Awesome

Download

android-anyshape

With the solution, pictures can be displayed in any shape on Android platform.

Effect

The left is the UI using normal ImageViews, and the right is UI using the AnyshapeImageViews
<img src="https://github.com/lankton/android-anyshape/blob/master/pictures/with_normal.jpg" height="400px"/> <img src="https://github.com/lankton/android-anyshape/blob/master/pictures/with_mask_gif.gif" height="400px"/>
All we need to make are 3 mask PNGs like below (the background must be transparent):
<img src="https://github.com/lankton/android-anyshape/blob/master/pictures/singerstar_1.png" height="100px"/> <img src="https://github.com/lankton/android-anyshape/blob/master/pictures/text_1.png" height="100px"/> <img src="https://github.com/lankton/android-anyshape/blob/master/pictures/rings_1.png" height="100px"/>

minSdkVersion

11

Dependencies

latest version

see it as an icon in the beginning of the README file.

gradle

compile 'cn.lankton:anyshape:latest version'

maven

<dependency>
  <groupId>cn.lankton</groupId>
  <artifactId>anyshape</artifactId>
  <version>latest version</version>
  <type>pom</type>
</dependency>

Usage

You can use the AnyshapeImageView like below in your layout file:

<cn.lankton.anyshape.AnyshapeImageView
    android:layout_width="150dp"
    android:layout_height="150dp"
    android:layout_marginTop="20dp"
    android:src="@drawable/kumamon"
    app:anyshapeMask="@drawable/singlestar"/>

You can use the attribue "anyshapeMask" to set the mask. AnyshapeImageView can get the path from the mask, by detecting the alpha value of every pixel.

if you want to create a view with pure color , you can use the code like this:

<cn.lankton.anyshape.AnyshapeImageView
    android:layout_width="210dp"
    android:layout_height="140dp"
    android:layout_marginTop="20dp"
    app:anyshapeBackColor="@android:color/holo_red_light"
    app:anyshapeMask="@drawable/rings"/>

If you want to change the pure color dynamically, do like this:

anyshapeImageView.setBackColor(Color.Green);

summary

The code is not hard for anybody to understand. Just hope that it can provide some help or inspiration for you.