AnimatedPieView
---
**AnimatedPieView is a simple and easy-to-use pie-chart view.**
[**Chinese Doc**](https://github.com/razerdp/AnimatedPieView/blob/master/README.md)
[](https://bintray.com/razerdp/maven/AnimatedPieView/_latestVersion)
[](https://github.com/razerdp/AnimatedPieView/blob/master/LICENSE)
[](https://android-arsenal.com/details/1/6507)
[](https://img.shields.io/badge/Api-14%2B-green.svg)
[](https://github.com/razerdp)
[](#backers)
[](#sponsors)
### Update Log:
### 2020/11/02
- Fix the problem of losing data when the animation is too fast
- Fix the problem that the pie chart does not respond when clicked under special data.
- Fixed Bugs:
- [#35](https://github.com/razerdp/AnimatedPieView/issues/35)
- [#27](https://github.com/razerdp/AnimatedPieView/issues/27)
- [#25](https://github.com/razerdp/AnimatedPieView/issues/25)
- [#18](https://github.com/razerdp/AnimatedPieView/issues/18)
Develop Plan （Update Log->[Update Log](https://github.com/razerdp/AnimatedPieView/blob/master/UPDATE_LOG.md)）
-------------------------------------------------------------------------------------------------------------
> No plan now....I'm eagerly waiting for your great suggestions.
* ~~Support typeface for label [#26](https://github.com/razerdp/AnimatedPieView/issues/26)~~
* ~~Support tap label to select pie [#27](https://github.com/razerdp/AnimatedPieView/issues/27)~~
* ~~Support legends~~
* ~~Support label for description text~~
* ~~Project Optimization and Reconstruction, version 1.2.0 release~~
* ~~Support alpha to highlight the selected pie~~
* ~~Support the pies to have a space between them~~
* ~~TextField adapt animation position changed~~
* ~~Text Line show animation~~
* ~~Click callback~~
* ~~Click effect~~
* ~~Support click for every pie~~
* ~~Support transform between pie-chart and ring-chart~~
* ~~Support animation drawing~~
Features:
---
| Description | Method | Preview |
| -------- | :----- | ---- |
| animation drawing | -- |  |
| transform between pie-chart and ring-chart | strokeMode(boolean) |  |
| space between | splitAngle(float) |  |
| description text | drawText(true) |  |
| click effect | canTouch(true) / selectListener() |  |
| alpha to highlight (reverse) | focusAlphaType(
AnimatedPieViewConfig.FOCUS_WITH_ALPHA_REV,150
) |  |
| alpha to highlight | focusAlphaType(
AnimatedPieViewConfig.FOCUS_WITH_ALPHA,150
) |  |
| description text label | IPieInfo.PieOption |  |
Download:
---
Use in gradle（please replace {latestVersion} to the download badge version）
```xml
dependencies {
implementation 'com.github.razerdp:AnimatedPieView:{latestVersion}'
}
```
Simple Usage
---
**step 1：Define any class to implement the IPieInfo interface（you can also use SimplePieInfo）**
```java
public class Test implements IPieInfo {
@Override
public float getValue() {
// This return value will determine the percentage
return 0.5f;
}
@Override
public int getColor() {
// This return value will determine the cur-pie color，please return @colorInt，but not @colorRes
return Color.WHITE;
}
@Override
public String getDesc() {
// description text, may not return
return "这是一个测试";
}
@Nullable
@Override
public PieOption getPieOpeion() {
// option for pie,example: descript label
return mPieOption;
}
}
```
**step 2：New AnimatedPieViewConfig and configure it**
```java
AnimatedPieView mAnimatedPieView = findViewById(R.id.animatedPieView);
AnimatedPieViewConfig config = new AnimatedPieViewConfig();
config.startAngle(-90)// Starting angle offset
.addData(new SimplePieInfo(30, getColor("FFC5FF8C"), "这是第一段"))//Data (bean that implements the IPieInfo interface)
.addData(new SimplePieInfo(18.0f, getColor("FFFFD28C"), "这是第二段"))
...(addData so on)
.duration(2000);// draw pie animation duration
// The following two sentences can be replace directly 'mAnimatedPieView.start (config); '
mAnimatedPieView.applyConfig(config);
mAnimatedPieView.start();
```
Api:
---
```java
AnimatedPieViewConfig mConfig=mAnimatedPieView.getConfig();
mConfig.animOnTouch(true)// Animation when selected pie（default:true）
.addData(IPieInfo info, boolean autoDesc)// Add data (bean that implements the IPieInfo interface).autoDesc：automatically add description（e.g. 8.8%）
.floatExpandAngle(15f)// Selected pie's angle of expansion
.floatShadowRadius(18f)// Selected pie's shadow of expansion
.floatUpDuration(500)// Selected pie's floating animation duration
.floatDownDuration(500)// Last selected pie's float down animation duration
.floatExpandSize(15)// Selected pie's size of expansion(only for pie-chart,not ring-chart)
.strokeMode(true)// Whether to draw ring-chart(default:true)
.strokeWidth(15)// Stroke width for ring-chart
.duration(2500)// Animation drawing duration
.startAngle(-90f)// Starting angle offset
.selectListener(new OnPieSelectListener())// Click callback
.drawText(true)// Whether to draw a text description
.textSize(12)// Text description size
.textMargin(8)// Margin between text and guide line
.autoSize(true)// Auto fit chart radius
.pieRadius(100)// Set chart radius
.pieRadiusRatio(0.8f)// Chart's radius ratio for parent ViewGroup
.guidePointRadius(2)// Chart's radius
.guideLineWidth(4)// Text guide line stroke width
.guideLineMarginStart(8)// Guide point margin from chart
.textGravity(AnimatedPieViewConfig.ABOVE)// Text Gravity 【
-AnimatedPieViewConfig.ABOVE：Text will be drawn above the guide line
-AnimatedPieViewConfig.BELOW：Text will be drawn below the guide line
-AnimatedPieViewConfig.ALIGN：Text will be drawn align to the guide line
-AnimatedPieViewConfig.ECTOPIC：Text will be drawn above the line in the 1, 2 quadrants and below the line in the 3, 4 quadrants
】
.canTouch(true)// Whether to allow the pie click to enlarge
.typeFae(TypeFace)// Typeface of desc
.splitAngle(1)// Clearance angle
.focusAlphaType(AnimatedPieViewConfig.FOCUS_WITH_ALPHA_REV)// Alpha change mode for selected pie
.interpolator(new DecelerateInterpolator())// Set animation interpolator
.focusAlpha(150) // Alpha for selected pie (depend on focusAlphaType)
.legendsWith((ViewGroup) findViewById(R.id.ll_legends), new OnPieLegendBindListener() {
@Override
public BasePieLegendsView onCreateLegendView(int position, IPieInfo info) {
return position % 2 == 0 ?
DefaultPieLegendsView.newInstance(MainActivity.this)
: DefaultCirclePieLegendsView.newInstance(MainActivity.this);
}
@Override
public boolean onAddView(ViewGroup parent, BasePieLegendsView view) {
return false;
}
}); // Set a legends container to bind legends views
```
---
Api in PieOption：
---
you can decide your pie with create `PieOption`
```java
// IPieInfo.java#getPieOption()
@Nullable
@Override
public PieOption getPieOption() {
return new PieOption()
.setDefaultSelected(true) // Selected this pie by default
.setIconHeight(50) // Text icon height
.setIconWidth(50) // Text icon width
.setIconScaledHeight(0.5f) // Text icon height scaling
.setIconScaledWidth(0.5f) // Text icon width scaling
.setLabelIcon(bitmap) // Text icon bitmap resource
.setLabelPadding(5) // Icon and text distance
.setLabelPosition(PieOption.NEAR_PIE); // Decide which position of the icon in the pie
}
```
Buy me a coffee
--------------------------------------
| Wechat | AliPay |
| ---- | ---- |
|  |  |
Develop Passage:
----------------
* [自定义控件——弄个甜甜圈吧（1）： 起源](http://www.jianshu.com/p/b2a2d82e107e)
* [自定义控件——弄个甜甜圈吧（2）： 搭建](http://www.jianshu.com/p/562c525ff927)
* [自定义控件——弄个甜甜圈吧（3）： 动画篇【生长动画】](http://www.jianshu.com/p/f7842a97cb3e)
* 编写中...
LICENSE
---
Apache-2.0
## Contributors
This project exists thanks to all the people who contribute.
## Backers
Thank you to all our backers! 🙏 [[Become a backer](https://opencollective.com/AnimatedPieView#backer)]
## Sponsors
Support this project by becoming a sponsor. Your logo will show up here with a link to your website. [[Become a sponsor](https://opencollective.com/AnimatedPieView#sponsor)]
