https://github.com/mrwonderman/android-square-progressbar
An android library to display a progressbar that goes around an image.
https://github.com/mrwonderman/android-square-progressbar
Last synced: about 1 month ago
JSON representation
An android library to display a progressbar that goes around an image.
- Host: GitHub
- URL: https://github.com/mrwonderman/android-square-progressbar
- Owner: mrwonderman
- Created: 2013-05-05T09:21:01.000Z (almost 12 years ago)
- Default Branch: master
- Last Pushed: 2018-03-30T13:56:48.000Z (about 7 years ago)
- Last Synced: 2024-07-31T18:17:04.717Z (9 months ago)
- Language: Java
- Homepage: http://halcyon.ch/android-square-progressbar-v-1-6-0/
- Size: 3.76 MB
- Stars: 1,275
- Watchers: 66
- Forks: 285
- Open Issues: 15
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- -awesome-android-ui - android-square-progressbar - square-progressbar.png" width="49%"> <img src="/art/android-square-progressbar2.png" width="49%"> <img src="/art/android-square-progressbar3.png" width="49%"> (Index `(light-weight pages)`)
- awesome-android-ui - android-square-progressbar - square-progressbar.png" width="49%"> <img src="/art/android-square-progressbar2.png" width="49%"> <img src="/art/android-square-progressbar3.png" width="49%"> (Index `(light-weight pages)`)
- awesome-android-Loaders - android-square-progressbar
- awesome-github-android-ui - android-square-progressbar - 围绕图片的进度条 (图片)
- awesome-android-ui - android-square-progressbar - square-progressbar.png" width="49%"> <img src="/art/android-square-progressbar2.png" width="49%"> <img src="/art/android-square-progressbar3.png" width="49%"> (Index)
- awesome-android-ui - https://github.com/mrwonderman/android-square-progressbar
- awesome-android-ui - https://github.com/mrwonderman/android-square-progressbar
README
android-square-progressbar[  ](https://bintray.com/mrwonderman/maven/squareprogressbar/_latestVersion)
==========================
## First things first
This library is setup to work with the Android Studio and Gradle. If you're using the Eclipse environment then check out the legacy repository here: [android-square-progressbar-legacy](https://github.com/mrwonderman/android-square-progressbar-legacy).
You can find my blog post about the newest version here: [halcyon.ch - android-square-progressbar v.1.6.0](http://www.halcyon.ch/android-square-progressbar-v-1-6-0/), also check out the post about the previous major 1.5.0 version [here](http://www.halcyon.ch/android-square-progressbar-v-1-5-0/).
The example application is available at the play store:
[](https://gitter.im/mrwonderman/android-square-progressbar?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
## General idea
Sometimes you don't have enough space in your layout to display a wide progressbar. So this library gives you a complete new possibility to display a progress. You can simply show a progressbar around an image. And this progressbar can be configured in a lot of different ways, like colour, outline, display of the percentage and so on.
### Examples
Here are some examples of how these progressbars could look like:
| normal / default | rounded corners | show percent | indeterminate|
| ------------- | ------------- | ----- | ----- |
|| | | 
| | `setRoundedCorners(true)` | `showProgress(true)` | `drawOutline(true)` |
| | | `setOpacity(true)` | `setIndeterminate(true)` |
There are some further examples available here (with code) : [Examples](https://github.com/mrwonderman/android-square-progressbar/wiki/Examples)
### How to use it? / How to install? / How to contribute?
Check the wiki for more information about [how to use](https://github.com/mrwonderman/android-square-progressbar/wiki/Usage), [how to install](https://github.com/mrwonderman/android-square-progressbar/wiki/Use-with-an-Eclipse-Setup) or [how to contribute](https://github.com/mrwonderman/android-square-progressbar/wiki/How-To-Contribute).
If you have questions about the code or if you need some help, you can try the [Gitter-Group](https://gitter.im/mrwonderman/android-square-progressbar).
## Usage
### Gradle
This library now works with gradle and will soon be available on the central maven repository. For the moment its on jCenter at [Bintray](https://bintray.com/mrwonderman/maven/squareprogressbar/view). Just add the following repository to your root build.gradle:
allprojects {
repositories {
jcenter()
maven { url "https://jcenter.bintray.com" }
}
}
Then in your app build.gradle:
dependencies {
// other repos ...
implementation 'ch.halcyon:squareprogressbar:1.6.4'
}
### Code
After adding the gradle depedency from above you can go to your xml layout and add the following code for a squareprogressbar:
To set some basic settings use the following java-code:
SquareProgressBar squareProgressBar = findViewById(R.id.sprogressbar);
squareProgressBar.setImage(R.drawable.example);
squareProgressBar.setProgress(50.0);
Now you can make the squareprogressbar as fancy as you like. Check the [usage page](https://github.com/mrwonderman/android-square-progressbar/wiki/Usage) for all the different possiblities.