本类库可以对ImageView，View Background，Drawable和Bitmap添加风格与设置亮度、对比度。本类库现提供十种风格，具体见下方图示。可以开启动画效果，并设置差值器Interpolator，监听器Listener。对ImageView/View/Drawable可以获取变换风格后的Bitmap。
如果只需要操作ImageView，则可以使用StyleImageView类，该类支持通过布局文件设置属性。如果已经使用了自定义ImageView，或需要操作View的Background，或是任意Drawable与Bitmap，则可以使用Styler类。
注：本类库使用ColorFilter实现效果，如果你已经使用了ColorFilter，有可能产生冲突。
Try Sample
欢迎访问 chengdazhi.com/styleimageview 下载样例程序apk或者扫描下方二维码：
在样例项目中，style_image_view_test module展示了如何通过xml与java操作StyleImageView。 styler_test module展示了如何使用Styler操作一个ImageView。Styler对于View和Drawable的操作类似。有关如何使用Styler操作Bitmap请查看下文使用说明。
Feature
StyleImageView支持如下10种风格，但对比度(Saturation)风格的图片没有给出，因为需要一个输入值。注意你可以在这些风格之上添加亮度和对比度。
| 风格模式 | 海滩 | 房子与船 |
|---|---|---|
| Original 无风格 |
|
|
| Grey Scale 灰度 |
|
|
| Invert 反转 |
|
|
| RGB to BGR RB通道反转 |
|
|
| Sepia 老照片 |
|
|
| Black & White 纯黑白 |
|
|
| Bright 明亮 |
|
|
| Vintage Pinhole 针孔 |
|
|
| Kodachrome 柯达 |
|
|
| Technicolor 染印 |
|
|
推荐一些组合:
- Invert 反转 + (150 亮度) + (2.0F 对比度)
- Sepia 老照片 + (-100 亮度) + (2.0F 对比度)
- Kodachrome 柯达 + (-75 亮度) + (1.6F 对比度)
可以从示例程序中找到你想要的组合！
使用方式
重要属性
-
Mode 风格模式：你想要实现的风格，包含如下选项：
- Saturation 对比度模式
- Grey Scale 灰度模式，即常见的黑白照片
- Invert 色彩反转
- RGB To BGR 将Red与Blue两个颜色通道反转，可理解为另一种色彩翻转
- Sepia 老照片
- Black And White 硬像，纯黑白，没有灰色
- Bright 明亮
- Vintage Pinhole 针孔
- Kodachrome 柯达
- Technicolor 染印
- None 无风格，为Mode属性默认值
-
Brightness 亮度：int型，范围[-255,255]，取0时没有效果，默认值为0。
- Contrast 对比度：float型，范围[0, +∞)，取1.0时没有效果，默认值1.0。
- Saturation 饱和度：float型，范围[0, +∞)，取1.0时没有效果，默认值1.0。
- EnableAnimation：是否开启动画，开启时必须给出动画时长（AnimationDuration），可选择给出差值器（Interpolator）。
- AnimationDuration：动画时长，当关闭动画时会自动重置时长为0。默认值0。
注意：Saturation（饱和度）是单独的一种模式，不可作用于其他模式之上。调用setSaturation()会自动将模式更改。如果在xml中设置了Saturation，而又设置了Mode且不是saturation，就会报错。
库中许多方法提供了文档注释，必要时请参考源码。
StyleImageView使用方式
xml属性
- style: 枚举类型，默认值为none。
- brightness：int 整形，默认值为0。
- contrast：float 浮点型，默认值为1.0。
- saturation：float 浮点型，默认值为1.0。
- enable_animation：boolean 布尔型，默认值为false。
- animation_duration：int 整形（在java中转换为long类型），默认值为0。
注意：如果设置了animation_duration，enable_animation必须设为true，不然会报错。
Java代码
//简单示例StyleImageViewstyleImageView=(StyleImageView)this.findViewById(R.id.image); styleImageView.setMode(Styler.Mode.SEPIA) .setBrightness(50) .setContrast(0.8) .enableAnimation(500L,newlinearInterpolator())//第一个参数是动画时长，第二个差值器可选.setAnimationLisnter(listener)//设置动画监听器，类型为Styler.AnimationListener.updateStyle();//调用updateStyle()更新UI//updateStyle()之前调用的set方法不区分顺序。styleImageView.getMode(); styleImageView.getBrightess(); styleImageView.getContrast(); styleImageView.getSaturation(); styleImageView.isAnimationEnabled(); styleImageView.getAnimationDuration();//获取当前Bitmap，可以指定长宽，否则使用drawable或view的尺寸。styleImageView.getBitmap([intwidth,intheight]);//设置风格，如果参数不是Styler.Mode.SATURATION，但之前设置了saturation，则saturation会被重置为1.0styleImageView.setMode(intStyle.Mode.*); styleImageView.setBrightness(intbrightness); styleImageView.setContrast(floatcontrast);//调用本方法会自动将风格设置为SATURATIONstyleImageView.setSaturation(floatsaturation);//必须传入时长，可选传入差值器。//当设置新的时长时也需要调用本方法。styleImageView.enableAnimation(longduration[,Interpolatorinterpolator]);//关闭动画。会自动重置动画时长和差值器。styleImageView.disableAnimation(); styleImageView.updateStyle();//更新UI//清除所有效果，重置Mode为NONE，重置saturation为1.0，不会重置其他属性。styleImageView.clearStyle();//给动画设置监听器。如果动画处于关闭状态，监听器方法不会执行。//监听器会在动画开始、更新与结束时收到回调。//如果之前设置了监听器，调用本方法会清除原先的监听器。styleImageView.setAnimationListener(Styler.AnimationListenerlistener);//清除AnimationListener并将其返回styleImageView.removeAnimationListener();Styler使用方式
Styler可以操作ImageView、View、Drawable和Bitmap。对于前三者Styler最终都是在操作Drawable，一旦Styler被构造，就不能再改变操作的对象了。Styler对Bitmap只提供两个静态方法来设置风格。
简单样例
ImageViewimageView=findViewById(R.id.image);Stylerstyler=newStyler.Builder(imageView,Styler.Mode.TECHNICOLOR) .enableAnimation(1000L) .build(); styler.updateUI();//将图片更新为Technicolor//重新设置风格、亮度并更新UI。styler.setMode(Styler.Mode.BLACK_AND_WHITE).setBrightness(100).updateUI();初始化
Styler没有公有的构造方法，你需要使用Styler.Builder类来构建Styler对象。
简单样例
ImageViewimageView=(ImageView)this.findViewById(R.id.image);Stylerstyler=newStyler.Builder(imageView,Styler.Mode.SEPIA) .enableAnimation(500L) .setContrast(1.5F) .build();Styler.Builder方法：
//Styler.Builder构造方法，你可以传入ImageViews/Views/Drawables//如需知道Styler具体工作机制请参考源代码//注意在Builder中不能再次设置构造方法中的两个参数Styler.Builderbuilder=newStyler.Builder(View|ImageView|Drawable, mode);//setters//开启动画，必须传入动画时长，可选传入差值器builder.enableAnimation(longanimationDuration[,Interpolatorinterpolator]);//关闭动画，自动重置时长为0，差值器为nullbuilder.disableAnimation(); builder.setBrightness(intbrightness); builder.setContrast(floatcontrast);//调用本方法时会自动将模式设为SATURATIONbuilder.setSaturation(floatsaturation);//设置动画监听器。如果动画没有开启，则不会触发监听器的回调。//监听器会在动画开始、更新与结束时收到回调。//如果之前设置了监听器，调用本方法会清除原先的监听器。builder.setAnimationListener(Styler.AnimationListenerlistener);//构造Styler对象。builder.build();Styler methods
Styler方法包含上文列举的StyleImageView的所有方法，以及下面几个操作Bitmap与获取Drawable的方法。
//返回styler当前正在操作的drawable对象styler.getDrawable();//Styler静态方法，对Bitmap快速添加风格//brightness, contrast, saturation为可选参数，具体参考上文的默认值//如果mode不是Saturation，而saturation不是1.0，因为saturation为单独的模式，有冲突，会报错Styler.addStyleToBitmap(Contextcontext,Bitmapbitmap,intmode[,intbrightness,floatcontrast,floatsaturation]);
