Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/xiprox/MarkView
An android custom view that displays a circle with a colored arc given a mark
https://github.com/xiprox/MarkView
Last synced: 3 months ago
JSON representation
An android custom view that displays a circle with a colored arc given a mark
- Host: GitHub
- URL: https://github.com/xiprox/MarkView
- Owner: xiprox
- Created: 2015-05-11T12:40:23.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2017-03-23T13:44:18.000Z (over 7 years ago)
- Last Synced: 2024-06-16T01:33:22.453Z (5 months ago)
- Language: Java
- Size: 104 KB
- Stars: 199
- Watchers: 9
- Forks: 27
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- awesome-github-android-ui - MarkView - 彩色圆弧的环形进度条 (进度条)
README
MarkView
=========
An android custom view that displays a circle with a colored arc given a mark.
# Usage
### Add as a dependency
```groovy
compile 'com.github.xiprox.markview:library:1.+'
```
### Get/Set mark
```java
getMark()
```
```java
setMark(int);
```
```xml
app:mv_mark="integer"
```
### Get/Set max
Max defines the highest mark value MarkView accepts and understands. Arc degree calculation is done with regard to this maximum value too. Any given mark higher than the max will result in a `?` being displayed along with a full gray ring.
```java
getMax()
```
```java
setMax(int)
```
```xml
app:mv_max="integer"
```
### Get/Set text size
```java
getTextSize()
```
```java
setTextSize(float)
```
```xml
app:mv_textSize="dimension"
```
### Get/Set text color
```java
getTextColor()
```
```java
setTextColor(int)
```
```xml
app:mv_textColor="color"
```
### Get/Set stroke width
```java
getStrokeWidth()
```
```java
setStrokeWidth(float)
```
```xml
app:mv_strokeWidth="dimension"
```
### Get/Set stroke colors
MarkView supports different colors for different marks. It works in the following way:
An array keeps all the colors. Ideally, one for every supported mark (satisfying `array.length == max`). If a color exists in the array for a given mark, that color is used. If not, the last color in the array is used. And if there are no colors at all, the default color (`#999999`) is used.
```java
getStrokeColors()
```
```java
setStrokeColors(int...)
```
```xml
app:mv_strokeColors="reference"
```
**Note:** If you use the xml attribute, you should supply a string array resource which is in the following format:
```xml
#D50000
#FF6D00
#FFD600
#8BC34A
#8BC34A
...
```
### Get the current stroke color
```java
getStrokeColor()
```
### Get/Set ring width
```java
getRingWidth()
```
```java
setRingWidth(float)
```
```xml
app:mv_ringWidth="dimension"
```
### Get/Set ring color
```java
getRingColor()
```
```java
setRingColor(int)
```
```xml
app:mv_ringColor="color"
```
# Sample App
(Apk file available in the releases tab.)
# License
```
Copyright (C) 2015 Ihsan Isik
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.
```