https://github.com/shchurov/HorizontalWheelView

https://github.com/shchurov/HorizontalWheelView

Last synced: 1 day ago
JSON representation

• Host: GitHub
• URL: https://github.com/shchurov/HorizontalWheelView
• Owner: shchurov
• License: apache-2.0
• Created: 2016-05-21T21:29:28.000Z (about 8 years ago)
• Default Branch: master
• Last Pushed: 2017-03-28T23:06:22.000Z (about 7 years ago)
• Last Synced: 2024-05-29T12:33:03.447Z (18 days ago)
• Language: Java
• Size: 262 KB
• Stars: 975
• Watchers: 23
• Forks: 107
• Open Issues: 3
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Lists

• awesome-github-android-ui - HorizontalWheelView - 供用户输入的模型水平轮控制器 (WheelView)
• awesome-github-android-ui - HorizontalWheelView - 供用户输入的模型水平轮控制器 (WheelView)

README

        
# HorizontalWheelView

Custom view for user input that models horizontal wheel controller.

![preview](https://i.imgur.com/wWYbR8R.png)

![demo gif](http://i.giphy.com/vH1qSxcwBBOiQ.gif)

Installation

-------

Add jitpack.io repository to your root build.gradle:

```groovy

allprojects {

 repositories {

    jcenter()

    maven { url "https://jitpack.io" }

 }

}

```

Add the dependency to your module build.gradle:

`compile 'com.github.shchurov:horizontalwheelview:0.9.5'`

API

-------

Method | Description

--- | ---

`void setListener(Listener listener)` | Add a listener that will be invoked when the user interacts with the view

`void setRadiansAngle(double radians)` | Set the rotation angle in radians

`void setDegreesAngle(double degrees)` | Set the rotation angle in degrees

`void setCompleteTurnFraction(double fraction)` | Set the rotation angle in fraction, where 0f = 0°, 1.0f = 360°

`double getRadiansAngle()` | Get the rotation angle in radians (-2π, 2π)

`double getDegreesAngle()` | Get the rotation angle in degrees (-360°, 360°)

`double getCompleteTurnFraction()` | Get the roatation angle in fraction (0f, 1.0f), where 0f = 0°, 1.0f = 360°

`void setOnlyPositiveValues(boolean onlyPositiveValues)` | When true, all rotation getters return only positive values, in xml: `app:onlyPositiveValues`, default: false

`void setMarksCount(int marksCount)` | Set the total number of marks on the wheel, in xml: `app:marksCount`

`void setNormalColor(int color)` | Set the color of non-active marks, in xml: `app:normalColor`, default: ffffff

`void setActiveColor(int color)` | Set the color of active marks, in xml: `app:activeColor`, default: 54acf0

`void setShowActiveRange(boolean show)` | When true, all marks that satisfy the condition \|markAngle\| <= \|rotationAngle\| will be highlighted with the active color, in xml: `app:showActiveRange`, default: true

`void setEndLock(boolean lock)` | When true, it's not allowed to rotate the wheel past the edge values, default: false

`void setSnapToMarks(boolean snapToMarks)` | When true, user's rotations will snap to the marks, in xml: `app:snapToMarks`, default: false

License

-------

    Copyright 2016 Mykhailo Shchurov

    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.