Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/VladimirWrites/Lemniscate
An easy way to make your progress view nice and sleek.
https://github.com/VladimirWrites/Lemniscate
android android-library curves custom lemniscate progress view
Last synced: about 1 month ago
JSON representation
An easy way to make your progress view nice and sleek.
- Host: GitHub
- URL: https://github.com/VladimirWrites/Lemniscate
- Owner: VladimirWrites
- License: apache-2.0
- Created: 2017-01-18T21:23:36.000Z (almost 8 years ago)
- Default Branch: master
- Last Pushed: 2023-08-20T07:44:24.000Z (over 1 year ago)
- Last Synced: 2024-08-04T00:07:07.927Z (4 months ago)
- Topics: android, android-library, curves, custom, lemniscate, progress, view
- Language: Kotlin
- Homepage: https://vladimirj.dev/lemniscate/
- Size: 485 KB
- Stars: 423
- Watchers: 8
- Forks: 43
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
- awesome-github-android-ui - Lemniscate - 制作别致的进度视图 (其他)
README
[](https://github.com/VladimirWrites/Lemniscate/blob/master/LICENSE)
[](https://jitpack.io/#VladimirWrites/Lemniscate)
[](https://android-arsenal.com/api?level-11)
[](https://android-arsenal.com/details/1/5142)
[](https://app.bitrise.io/app/a22f82dd1a84f058#/builds)
[](https://codecov.io/gh/VladimirWrites/Lemniscate)
-----
Lemniscate is a library that will help you to make your progress view nice and sleek.
Demo
-----
Demo application is available on Google Play.
The application is intentionally simple, without any libraries, to be understandable to more developers.
Setup
-----
Add to your module's `build.gradle`:
```groovy
allprojects {
repositories {
...
maven { url 'https://jitpack.io' }
}
}
```
and to your app `build.gradle`:
###### AndroidX
```groovy
dependencies {
implementation 'com.github.VladimirWrites:Lemniscate:2.0.4'
}
```
###### Android Support Library (Depricated)
```groovy
dependencies {
implementation 'com.github.VladimirWrites:Lemniscate:1.4.5'
}
```
Usage
-----
Example of usage:
```xml
```
###### Params available in all views:
* **duration** (int) - duration of one animation cycle in millisecondes
* **lineColor** (color) - color of the line
* **maxLineLength** (float) - max length of line (in percentage; 1.0 is full length, 0.5 is half of length)
* **minLineLength** (float) - min length of line (in percentage; 1.0 is full length, 0.5 is half of length)
* **sizeMultiplier** (float) - default size of view will be multiplied with that number
* **strokeWidth** (dimension) - width of line
* **precision** (int) - number of points in curve calculated in one cycle
#### Lemniscates
* `BernoullisProgressView` - [Lemniscate of Bernoulli](https://en.wikipedia.org/wiki/Lemniscate_of_Bernoulli),
* `GeronosProgressView` - [Lemniscate of Gerono](https://en.wikipedia.org/wiki/Lemniscate_of_Gerono)
* `BernoullisBowProgressView`
* `BernoullisSharpProgressView`
###### Additional params:
* **hasHole** (boolean) - hole in a middle of Lemniscates
#### Roulettes
* `EpitrochoidProgressView` - [Epitrochoid](https://en.wikipedia.org/wiki/Epitrochoid),
* `HypotrochoidProgressView` - [Hypotrochoid](https://en.wikipedia.org/wiki/Hypotrochoid)
###### Additional params:
* **radiusFixed** (float) - radius of fixed circle
* **radiusMoving** (float) - radius of moving circle
* **distanceFromCenter** (float) - distance from the center of the moving circle
* **numberOfCycles** (float) - for one **duration** curve will be drawn on interval [0, 2 \* mNumberOfCycles \* π]
#### Scribble
* `RoundScribbleProgressView`
* `ScribbleProgressView`
#### Funny
* `HeartProgressView` - [Heart Curve](http://mathworld.wolfram.com/HeartCurve.html),
* `CannabisProgressView` - [Cannabis Curve](http://mathworld.wolfram.com/CannabisCurve.html)
#### Other
* `XProgressView`
Contributing
-------
Want to contribute? You are welcome!
Note that all pull request should go to [`development`](https://github.com/VladimirWrites/Lemniscate/tree/development) branch.
Credits
-------
+ [Vladimir Jovanovic](https://github.com/VladimirWrites)
License
-------
Copyright 2016 Vladimir Jovanovic
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.