CircularProgressDrawable

Additional

Language
Java
Version
circular-progress-drawable-1.31 (Dec 11, 2014)
Created
Jun 8, 2014
Updated
Apr 27, 2015 (Retired)
Owner
Saúl Díaz (Sefford)
Contributors
Adam Speakman (adamsp)
Saúl Díaz (Sefford)
Alexandre (alexandre-g)
3
Activity
Badge
Generate
Download
Source code

CircularProgressDrawable

A drawable with capabilities to indicate progress.

Why a drawable?

If you want to achieve interesting effects and animations on Android, a surprisingly easy and fast way to achieve it is subclassing a Drawable instead of subclassing a Button or an ImageView.

In order to implement advanced behavior over the Drawable, you can still implement your own animations by using Android animations framework or by the use of listeners on the views you are using.

Download

Bundle

CircularProgressDrawable comes bundled in aar format. Grab the latest bundle from here

Maven

<dependency>
    <groupId>com.sefford</groupId>
    <artifactId>circular-progress-drawable</artifactId>
    <version>1.31</version>
    <type>aar</type>
</dependency>

Gradle

compile 'com.sefford:circular-progress-drawable:1.31@aar'

Composition

The Circular Progress Drawable is made out of three differentiated components:

  • The first one is what is known as the inner circle. The radius of the drawable and can be scaled up and down to achieve a progress effect or to serve a background for a TextView on top to indicate its meaning.
  • The next is the outline ring. This ring will surround the inner circle and it is intended as a subtle cue of the empty state of the progress.
  • The last is the outer ring. It will be used for several purposes. The first is to show the progress of the drawable. In the current version, the progress ring is filled from the bottom and counter-clockwise.

Usage

Circular Progress Drawable can be defined programatically and the only parameters it will require will be the different colours and the size of the outer ring.

Scale Property for the inner ring can be used to achieve a variety of effects, as pulsating effects, overshoot or to make it disappear completely.

The drawable allows both for a progress and an indetermination mode. In the indetermination mode instead of filling the outer ring, a 90º arc will be shown that can be animated to spin around the inner circle.

Tips

  • Take advantage of the Android Animators to achieve a variety of effects around Circular Progress Drawable.
  • If you want more interesting feedback you can use onTouchListeners over your View.
  • Have a look at the sample for some ideas.

Proguard

If you rely on Animators for animation and your application is obfuscated using Proguard, be advised that your Circular Progress Drawable animations could stop working. In order to avoid that add -keepclassmembers class com.sefford.circularprogressdrawable.CircularProgressDrawable { *;} to your proguard.conf file.

License

Copyright 2014 Sefford.

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.