PercentageChartView

Percentage Chart View

[Attention] This library is deprecated and will not be maintained anymore.

A Java-based easy to use and highly adjustable custom view that displays the progress of a single given task.

Please feel free to see the library in action in a showcase app available on Google play. This will help you check if a certain design can be achieved.

RING MODE

PIE MODE

FILL MODE

SETUP

Dependency should be declared in your app module level build.gradle file:

dependencies {    

    implementation 'com.ramijemli.percentagechartview:percentagechartview:0.3.1' 
    
}  

HOW TO USE

Attributes

Name	Format	Default	Supported modes	Description
pcv_mode	enum	pie	-	Sets percentage chart appearance to "ring", "pie", or "fill".
pcv_orientation	enum	clockwise	Pie, Ring	Sets progress's drawing direction to "clockwise" or "counter_clockwise".
pcv_startAngle	integer	0	All	Sets progress's drawing start angle to [0..360].
pcv_animDuration	integer	400	All	Sets progress update's animation duration.
pcv_animInterpolator	enum	linear	All	Sets progress update's animation interpolator to "linear", "accelerate", "decelerate", "accelerate_decelerate", "anticipate", "overshoot", "anticipate_overshoot", "bounce", "fast_out_linear_in", "fast_out_slow_in", "linear_out_slow_in".
pcv_drawBackground	boolean	true for pie mode
false for ring mode	All	Sets whether to draw background or not.
pcv_backgroundColor	color	#000000	All	Sets background color.
pcv_progress	integer	0	All	Sets current progress.
pcv_progressColor	color	Accent color	All	Sets progress color.
pcv_textColor	color	#ffffff	All	Sets text color.
pcv_textSize	dimension	#12sp	All	Sets text size in SP.
pcv_typeface	string	System font	All	Sets progress text's typeface file path in assets folder.
pcv_textStyle	flag	normal	All	Sets progress text's style to "normal", "bold", "italic", "bold|italic".
pcv_textShadowColor	color	#00ffffff	All	Sets text shadow/glow color.
pcv_textShadowRadius	string	0	All	Sets text shadow/glow radius.
pcv_textShadowDistX	float	0	All	Sets text shadow/glow's x-axis distance.
pcv_textShadowDistY	float	0	All	Sets text shadow/glow's y-axis distance.
pcv_backgroundOffset	dimension	0dp	Pie, Fill	Sets a margin only for background.
pcv_drawBackgroundBar	boolean	true	Ring	Sets whether to draw background bar or not.
pcv_backgroundBarThickness	dimension	16dp	Ring	Sets background bar's thickness in DP.
pcv_backgroundBarColor	color	#000000	Ring	Sets background color.
pcv_progressBarThickness	dimension	16dp	Ring	Sets progress bar's thickness in DP.
pcv_progressBarStyle	enum	round	Ring	Sets progress bar's style to "round" or "square".
pcv_gradientType	enum	-	All	Sets the gradient colors' type for progress to "linear", "radial", or "sweep". (sweep is not supported for fill mode)
pcv_gradientColors	string	-	All	Sets the gradient colors for progress in a comma separated hex color values format; "#F44336 , #2196F3 , #00BCD4".
pcv_gradientDistributions	string	-	All	Sets the gradient colors' distribution in a comma separated float values format; "0.2 , 0.5 , 0.8".
Values must be monotonic and belong to [0..1]. If ignored colors will be distributed evenly.
pcv_gradientAngle	integer	pcv_startAngle	All	Sets linear gradient colors' drawing angle to [0..360].

Start angle

pcv_startAngle and pcv_gradientAngle attributes accept values following the next illustration.

Fluent API

All XML attributes have their Java counterparts except the pcv_mode attribute (for now).

Updates can be set by making the changes and calling apply(). This will make sure to redraw the view only once at the end.

mChart.textColor(Color.BLACK)  
      .textSize(sizeSp)  
      .typeface(typeface)  
      .textShadow(Color.WHITE, 2f, 2f, 2f)  
      .progressColor(Color.RED)  
      .backgroundColor(Color.BLACK)  
      .apply();

For a single update, you can call the needed setter method. e.g. setTextSize(sizeSp).

Progress-based adaptive colors

To use the color per progress feature, you have to pass an AdaptiveColorProvider class using the setAdaptiveColorProvider() method.

Adaptive colors can be applied to progress, background, text, and background bar.

It's worth mentioning that gradient colors have a higher priority than the provided colors, and that you can ignore redefining the methods you don't need as they have an implementation by default.

AdaptiveColorProvider colorProvider = new AdaptiveColorProvider() {  
    @Override  
    public int provideProgressColor(float progress) {  
        if (progress Rami Jemli    
    

    
    

## LICENSE    

Copyright 2019 Rami Jemli

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.