Ferris Wheel View

Simple android library to present an animated ferris wheel

Description

Simple android library to present an animated ferris wheel

– API SDK 15+ – Written in Kotlin – Lightweight view with 1 drawable inside, uses canvas 2D drawing technique

Programming language: Kotlin

License: Apache License 2.0

Tags: Kotlin     UI     Animations     Custom View     Android-library    

Latest version: v1.2

README

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.