qinkaiabc / PictureProgressBar

a ProgressBar with Picture and Animation

PictureProgressBar

English README please click!

欢迎 Star or Fork！有什么意见和建议可以在Issue上提出。

简介

这是一个可在进度条的当前进度点设置图片的ProgressBar，并且可以设置几种动画模式，效果如图：

使用

Gradle

    compile 'com.yanzhikaijky:PictureProgressbar:1.2.0'

属性

属性名称	意义	类型	默认值
backGroundColor	进度条背景颜色	color	#888888
barColor	进度条颜色	color	#ff0000
drawable	进度条图片drawable	drawable	null
halfDrawableWidth	drawable宽度	dimension	0
halfDrawableHeight	drawable高度	dimension	0
drawableHeightOffset	drawable高度偏移量	dimension	0
isRound	进度条是否为圆角	boolean	true
roundX	进度条圆角X半径	dimension	20px
roundY	进度条圆角Y半径	dimension	20px
progress	初始进度	int	0
max	最大进度	int	0
isSetBar	是否自定义进度条高度	boolean	flase
progressHeight	进度条高度	dimension	100px
progressHeightOffset	进度条高度偏移量	dimension
refreshTime	刷新时间	int	100
animMode	动画模式	eunm	ANIM_NULL
rotateRate	旋转角度/每次刷新	int	10
rotateDegree	旋转初始角度	int	0
scaleMax	缩放最大倍数	float	1.5f
scaleMin	缩放最小倍数	float	0.5f
scaleRate	缩放倍数/每次刷新	float	0.1
gradientStartColor	进度条渐变色开始颜色	color	#ff0000
gradientEndColor	进度条渐变色结束颜色	color	#ffff00
backgroundDrawable	进度条背景图片	reference
barDrawable	进度条图片	reference

注意：backgroundDrawable和barDrawable（版本1.2.0新增），的引用只能是图片，不然会报错（对其他类型的支持后续开发中）。用法类似于官方ProgressBar的图片背景，设置一个图片之后会自动进行宽高调整后平铺：

最后得到这样的结果：

对应的animMode模式有：

animMode模式	意义	使用
ANIM_NULL	无动画模式	不需要设置Drawable
ANIM_ROTATE	旋转动画模式	需要设置Drawable，最好设置rotateRate、rotateDegree属性，使用时注意动画范围会不会超出View的实际范围，超出部分不会显示
ANIM_SCALE	缩放动画模式	需要设置Drawable，最好设置scaleMax、scaleMin，scaleRate属性，使用时注意动画范围会不会超出View的实际范围，超出部分不会显示
ANIM_ROTATE_SCALE	旋转加缩放动画模式	需要设置Drawable，上两个模式的属性，使用时注意动画范围会不会超出View的实际范围，超出部分不会显示
ANIM_FRAME	帧动画模式	不需要设置Drawable，需要设置drawableIds数组

除了上面属性的set、get方法，还有：

    //设置动画开关
    public void setAnimRun(boolean isAnimRun)

    //设置帧动画时要传入的图片ID数组
    public void setDrawableIds(int[] drawableIds)

    //设置图片
    public void setPicture(int id)

    //设置颜色渐变器
    public void setLinearGradient(LinearGradient linearGradient)

    //设置进度监听器
    public void setOnProgressChangeListener(OnProgressChangeListener onProgressChangeListener)

    //进度监听器
    public interface OnProgressChangeListener {
        //进度改变时的回调
        public void onOnProgressChange(int progress);
        //进度完成时的回答
        public void onOnProgressFinish();
    }

//以下为v1.2.0新增：

    //设置进度条背景图片
    public void setBarDrawableId(int id) 

    //设置进度条图片
    public void setBarBackgroundDrawableId(int id) 

开源协议

PictureProgressBar遵循Apache 2.0开源协议。

版本更新

• version 1.1.1:2017/07/07修复bug： 加入了progressPercentage属性来表示进度条进度比例，修改了setProgress()内容，在里面加入

progressPercentage = progress/max;

防止在输入较大int数值的时候，计算进度操作导致int类型溢出的情况，如下载场景下的进度数值。

• version 1.1.2:2017/09/07修复bug： progress/max得到0的结果，醉了过了两个月才发现。。。

• version 1.2.0:2017/09/11更新：

  • 1.修复非圆角进度条宽度设置失效问题。
  • 2.进度条左方预留空间给图片，不会出现进度0%但是还是显示有加载了部分进度的情况。
  • 3.新增进度条的图片设置，类似官方ProgressBar的图片平铺设置功能。

关于作者

id：炎之铠

炎之铠的邮箱：[e-mail]

CSDN：http://blog.csdn.net/totond

PictureProgressBar全解析blog：

http://blog.csdn.net/totond/article/details/72359888

http://www.jianshu.com/p/009cb305ec5f