Ferris Wheel View
Overview
An Android Library used to implement an animated Ferris Wheel in android.
- API SDK 15+
- Written in Kotlin
- Supports landscape mode
- Lightweight view with 1 drawable inside, uses canvas 2D drawing technique
Inspired by the one-color Planet Coaster loading screen
Mentions
- Featured in 25 new Android libraries, projects and tools worthy to check in Spring 2018
- Mentioned in Android Weekly issue 332
- Featured in 12 New Android Libraries - Full HD
Sample Project
For more information how to use the library in Kotlin/Java checkout Sample App in repository.
Quick Setup
Include library
Using Gradle
FerrisWheelView is distributed using jcenter.
repositories {
jcenter()
}
dependencies {
implementation 'ru.github.igla:ferriswheel:1.2'
}
Or Maven
<dependency>
<groupId>ru.github.igla</groupId>
<artifactId>ferriswheel</artifactId>
<version>1.2</version>
<type>pom</type>
</dependency>
Usage
Add widget in your xml layout like this:
<ru.github.igla.ferriswheel.FerrisWheelView
android:id="@+id/ferrisWheelView"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:layout_gravity="center"
app:fwv_cabinsNumber="8"
app:fwv_rotateSpeed="6" />
To start animation you need only call this method:
ferrisWheelView.startAnimation()
Or you can stop/pause/resume animation by the following methods:
ferrisWheelView.stopAnimation()
ferrisWheelView.pauseAnimation()
ferrisWheelView.resumeAnimation()
Attributes
| attr | format | default | description |
|---|---|---|---|
| fwv_cabinSize | dimension | 42dp | the size of each cabin |
| fwv_cabinsNumber | integer | 8 | the number of cabins on the wheel |
| fwv_isClockwise | boolean | true | toogle the rotate direction |
| fwv_isAutoRotate | boolean | true | start rotating wheel automatically after initialization |
| fwv_rotateSpeed | integer | 6 | wheel speed rotation measured in degrees |
| fwv_startAngle | float | 0 | angle at which wheel will start to rotate |
| fwv_wheelStrokeColor | color | #73302b |
with this color the wheel will be filled |
| fwv_baseStrokeColor | color | #666666 |
with this color the wheel base will be filled |
| fwv_cabinFillColor | color | array | with this color the cabin will be filled |
| fwv_cabinLineStrokeColor | color | #000000 |
with this color the cabin line will be filled |
Issues
If you find any problems or would like to suggest a feature, please feel free to file an issue
License
Copyright 2018 Igor Lashkov
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.
2.7k Dec 27, 2022
3.4k Dec 23, 2022
483 Nov 25, 2022
6.1k Jan 3, 2023
5 Sep 13, 2022
654 Dec 2, 2022
606 Nov 26, 2022
462 Nov 14, 2022
546 Dec 7, 2021
615 Nov 14, 2022
1.4k Dec 26, 2022
9.4k Dec 31, 2022
988 Nov 24, 2022
3k Jan 5, 2023
1.5k Jan 2, 2023
103 Oct 12, 2022
33 Dec 8, 2022
6.1k Dec 29, 2022
1.7k Nov 21, 2022