https://github.com/Pedroafa/avatar-android

Rounded and Squared Avatar for Android Applications
https://github.com/Pedroafa/avatar-android

Last synced: 3 months ago
JSON representation

Rounded and Squared Avatar for Android Applications

• Host: GitHub
• URL: https://github.com/Pedroafa/avatar-android
• Owner: Pedroafa
• License: apache-2.0
• Created: 2014-02-16T12:38:11.000Z (over 10 years ago)
• Default Branch: master
• Last Pushed: 2016-07-04T21:15:22.000Z (over 8 years ago)
• Last Synced: 2024-07-01T09:39:52.945Z (4 months ago)
• Language: Java
• Homepage:
• Size: 923 KB
• Stars: 194
• Watchers: 10
• Forks: 36
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
Avatars for Android [![Maven Central](https://maven-badges.herokuapp.com/maven-central/net.sectorsieteg/avatars/badge.svg)](https://maven-badges.herokuapp.com/maven-central/net.sectorsieteg/avatars)

==============

This project provides a easy way to build avatar compositions for Android applications, as you can see in the screenshot.

![Screenshot](https://github.com/Pedroafa/avatar-android/blob/master/screenshot.png?raw=true)

## Usage

Declare it into your pom.xml

```xml

    net.sectorsieteg

    avatars

    1.0.0

    aar

```

Or into your build.gradle

```groovy

dependencies {

    compile 'net.sectorsieteg:avatars:1.0.0'

}

```

## How to Use

Inside the layout, you only needs a ImageView in order to show the avatar.

``` xml

    

```

The AvatarDrawableFactory will abstract you about how the avatars are built. We will be able to create a rounded or a

squared avatar from this entry point.

For the squared avatars depending of the number of images passed to the factory, a composition for one, two, three or four

will be created. Returning the specific implementation for that case.

There are this types of compositions:

* RoundedAvatarDrawable

* BorderedRoundedAvatarDrawable

* SquaredAvatarDrawable

* DoubleSquaredAvatarDrawable

* TripleSquaredAvatarDrawable

* QuadrupleSquaredAvatarDrawable

``` java

BitmapFactory.Options options = new BitmapFactory.Options();

options.inMutable = false;

Bitmap avatar = BitmapFactory.decodeResource(getResources(), R.drawable.avatar, options);

AvatarDrawableFactory avatarFactory = new AvatarDrawableFactory(getResources());

Drawable avatarDrawable = avatarFactory.getSquaredAvatarDrawable(avatar, avatar);

ImageView avatarView = (ImageView)rootView.findViewById(R.id.avatar);

avatarView.setImageDrawable(avatarDrawable);

```

## Contributors

* Evelio Tarazona Cáceres - 

## License

    Copyright 2014 Pedro Álvarez Fernández

    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.