Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/iglaweb/Ferris-Wheel

Simple android library to present an animated ferris wheel
https://github.com/iglaweb/Ferris-Wheel

android android-library animation customview drawing ferris-wheel kotlin kotlin-android

Last synced: 3 months ago
JSON representation

Simple android library to present an animated ferris wheel

Host: GitHub
URL: https://github.com/iglaweb/Ferris-Wheel
Owner: iglaweb
License: apache-2.0
Created: 2018-01-12T21:18:47.000Z (about 7 years ago)
Default Branch: master
Last Pushed: 2018-10-07T16:59:39.000Z (over 6 years ago)
Last Synced: 2024-07-31T18:16:28.653Z (6 months ago)
Topics: android, android-library, animation, customview, drawing, ferris-wheel, kotlin, kotlin-android
Language: Kotlin
Homepage:
Size: 35.3 MB
Stars: 323
Watchers: 13
Forks: 46
Open Issues: 2
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE

Awesome Lists containing this project

-awesome-android-ui - FerrisWheel - 2.0) | <img src="/art/FerrisWheelView.gif" width="62%"> (Index `(light-weight pages)`)
awesome-android-ui - FerrisWheel - 2.0) | <img src="/art/FerrisWheelView.gif" width="62%"> (Index `(light-weight pages)`)
awesome-kotlin - FerrisWheelView - Simple android library to present an animated ferris wheel. (Libraries)
awesome-android-ui - FerrisWheel - 2.0) | <img src="/art/FerrisWheelView.gif" width="62%"> (Index)

README

        # Ferris Wheel View

[![Android Arsenal](https://img.shields.io/badge/Android%20Arsenal-Ferris%20Wheel%20View-green.svg?style=flat)](https://android-arsenal.com/details/1/6803)

[![Build Status][build-status-svg]][build-status-link]

[![Download](https://api.bintray.com/packages/iglaweb/maven/Ferris-Wheel/images/download.svg)](https://bintray.com/iglaweb/maven/Ferris-Wheel/_latestVersion)

[![License](https://img.shields.io/badge/license-Apache%202-4EB1BA.svg?style=flat-square)](https://www.apache.org/licenses/LICENSE-2.0.html)

![image](/art/logo.png)

## Overview

An Android Library used to implement an animated Ferris Wheel in android.

- **API SDK 15+**

- **Written in [Kotlin](https://kotlinlang.org)**

- **Supports landscape mode**

- **Lightweight view with 1 drawable inside, uses canvas 2D drawing technique**

![Preview-demo](/art/preview_demo.gif "Preview demo")  ![Monochrome-sample](/art/preview_demo_monochrome.gif "Monochrome sample")


Inspired by the one-color [Planet Coaster loading screen](https://youtu.be/5zHhW5TLW2s)

## Mentions

* Featured in [25 new Android libraries, projects and tools worthy to check in Spring 2018](https://medium.com/@mmbialas/25-new-android-libraries-projects-and-tools-worthy-to-check-in-spring-2018-68e3c5e93568)

* Mentioned in [Android Weekly issue 332](http://androidweekly.net/issues/issue-322)

* Featured in [12 New Android Libraries - Full HD](https://www.youtube.com/watch?v=22k5uak4yYg)

## Sample Project

For more information how to use the library in Kotlin/Java checkout [Sample App](https://github.com/iglaweb/Ferris-Wheel/tree/master/sample/) in repository.

## Quick Setup

### Include library

**Using Gradle**

FerrisWheelView is distributed using [jcenter](https://bintray.com/iglaweb/maven/Ferris-Wheel).

``` gradle

repositories { 

    jcenter()

}

dependencies {

    implementation 'ru.github.igla:ferriswheel:1.2'

}

```

**Or Maven**

``` maven

  ru.github.igla

  ferriswheel

  1.2

  pom

```

### Usage

Add widget in your xml layout like this:

```xml

    

```

To start animation you need only call this method:

``` kotlin

    ferrisWheelView.startAnimation()

```

Or you can stop/pause/resume animation by the following methods:

``` kotlin

    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](https://placehold.it/15/73302b/000000?text=+) `#73302b`|with this color the wheel will be filled|

|fwv_baseStrokeColor|color| ![#666666](https://placehold.it/15/666666/000000?text=+) `#666666`|with this color the wheel base will be filled|

|fwv_cabinFillColor|color|[array](https://github.com/iglaweb/Ferris-Wheel/blob/master/ferriswheel/src/main/res/values/arrays.xml)|with this color the cabin will be filled|

|fwv_cabinLineStrokeColor|color|![#000000](https://placehold.it/15/000000/000000?text=+) `#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](https://github.com/iglaweb/Ferris-Wheel/issues)

## 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.

 [build-status-svg]: https://travis-ci.org/iglaweb/Ferris-Wheel.svg?branch=master

 [build-status-link]: https://travis-ci.org/iglaweb/Ferris-Wheel

 [license-svg]: https://img.shields.io/badge/license-APACHE-lightgrey.svg

 [license-link]: https://github.com/iglaweb/Ferris-Wheel/blob/master/LICENSE