8.3.3 Paint API之—— MaskFilter(面具)
最后更新于：2022-04-01 05:28:57
## 本节引言：
> 在[Android基础入门教程——8.3.1 三个绘图工具类详解](http://www.runoob.com/w3cnote/android-tutorial-drawable-tool.html)的Paint方法中有这样一个方法：
>
> **setMaskFilter(MaskFilter maskfilter)**： 设置MaskFilter，可以用不同的MaskFilter实现滤镜的效果，如滤化，立体等！ 而我们一般不会直接去用这个MaskFilter，而是使用它的两个子类：
>
> **BlurMaskFilter**：指定了一个模糊的样式和半径来处理Paint的边缘。
>
> **EmbossMaskFilter**：指定了光源的方向和环境光强度来添加浮雕效果。 下面我们来写个例子来试验一下~！
>
> 官方API文档：
> [BlurMaskFilter](http://androiddoc.qiniudn.com/reference/android/graphics/BlurMaskFilter.html)；
> [EmbossMaskFilter](http://androiddoc.qiniudn.com/reference/android/graphics/EmbossMaskFilter.html)；
* * *
## 1.BlurMaskFilter(模糊效果)
> 说什么滤镜立体，谁知道怎么样，示例见真知：
**代码示例**：
**运行效果图**：
**实现代码**：
> 这里我们创建一个自定义View，在里面完成绘制！
**BlurMaskFilterView.java**：
~~~
/**
* Created by Jay on 2015/10/21 0021.
*/
public class BlurMaskFilterView extends View{
public BlurMaskFilterView(Context context) {
super(context);
}
public BlurMaskFilterView(Context context, AttributeSet attrs) {
super(context, attrs);
}
public BlurMaskFilterView(Context context, AttributeSet attrs, int defStyleAttr) {
super(context, attrs, defStyleAttr);
}
@Override
protected void onDraw(Canvas canvas) {
BlurMaskFilter bmf = null;
Paint paint=new Paint();
paint.setAntiAlias(true); //抗锯齿
paint.setColor(Color.RED);//画笔颜色
paint.setStyle(Paint.Style.FILL); //画笔风格
paint.setTextSize(68); //绘制文字大小，单位px
paint.setStrokeWidth(5); //画笔粗细
bmf = new BlurMaskFilter(10f,BlurMaskFilter.Blur.NORMAL);
paint.setMaskFilter(bmf);
canvas.drawText("最喜欢看曹神日狗了~", 100, 100, paint);
bmf = new BlurMaskFilter(10f,BlurMaskFilter.Blur.OUTER);
paint.setMaskFilter(bmf);
canvas.drawText("最喜欢看曹神日狗了~", 100, 200, paint);
bmf = new BlurMaskFilter(10f,BlurMaskFilter.Blur.INNER);
paint.setMaskFilter(bmf);
canvas.drawText("最喜欢看曹神日狗了~", 100, 300, paint);
bmf = new BlurMaskFilter(10f,BlurMaskFilter.Blur.SOLID);
paint.setMaskFilter(bmf);
canvas.drawText("最喜欢看曹神日狗了~", 100, 400, paint);
setLayerType(View.LAYER_TYPE_SOFTWARE, null); //关闭硬件加速
}
}
~~~
> 好的，从上面的代码示例，我们可以发现，我们使用这个BlurMaskFilter，无非是， 在构造方法中实例化：
>
> **BlurMaskFilter(10f,BlurMaskFilter.Blur.NORMAL);**
>
> 我们可以控制的就是这两个参数：
>
> **第一个参数**：指定模糊边缘的半径；
>
> **第二个参数**：指定模糊的风格，可选值有：
>
> * BlurMaskFilter.Blur.**NORMAL**：内外模糊
> * BlurMaskFilter.Blur.**OUTER**：外部模糊
> * BlurMaskFilter.Blur.**INNER**：内部模糊
> * BlurMaskFilter.Blur.**SOLID**：内部加粗，外部模糊
可能还是有点不清晰，我们找个图片来试试：
这里我们把模糊半径修改成了50，就更加明显了~
* * *
## 2.EmbossMaskFilter(浮雕效果)
> 如题，通过指定环境光源的方向和环境光强度来添加浮雕效果，同样，我们写个示例来看看效果：
**代码示例**：
**运行效果图**：
**实现代码**：
~~~
/**
* Created by Jay on 2015/10/22 0022.
*/
public class EmbossMaskFilterView extends View{
public EmbossMaskFilterView(Context context) {
super(context);
}
public EmbossMaskFilterView(Context context, AttributeSet attrs) {
super(context, attrs);
}
public EmbossMaskFilterView(Context context, AttributeSet attrs, int defStyleAttr) {
super(context, attrs, defStyleAttr);
}
@Override
protected void onDraw(Canvas canvas) {
float[] direction = new float[]{ 1, 1, 3 }; // 设置光源的方向
float light = 0.4f; //设置环境光亮度
float specular = 8; // 定义镜面反射系数
float blur = 3.0f; //模糊半径
EmbossMaskFilter emboss=new EmbossMaskFilter(direction,light,specular,blur);
Paint paint = new Paint();
paint.setAntiAlias(true); //抗锯齿
paint.setColor(Color.BLUE);//画笔颜色
paint.setStyle(Paint.Style.FILL); //画笔风格
paint.setTextSize(70); //绘制文字大小，单位px
paint.setStrokeWidth(8); //画笔粗细
paint.setMaskFilter(emboss);
paint.setMaskFilter(emboss);
canvas.drawText("最喜欢看曹神日狗了~", 50, 100, paint);
Bitmap bitmap = BitmapFactory.decodeResource(getResources(), R.mipmap.ic_bg_meizi1);
canvas.drawBitmap(bitmap, 150, 200, paint);
setLayerType(View.LAYER_TYPE_SOFTWARE, null); //关闭硬件加速
}
}
~~~
> 从效果图我们就可以看出一些EmbossMaskFilter的效果，修改光线，形成浮雕效果~妹子图不明显， 文字就很清晰显示出纹路了！和BlurMaskFilter一样，相关的设置都是在构造方法中进行！
>
> **EmbossMaskFilter(float[] direction, float ambient, float specular, float blurRadius)** 参数依次是：
>
> **direction**：浮点型数组，用于控制x,y,z轴的光源方向
>
> **ambient**：设置环境光亮度，0到1之间
>
> **specular**：镜面反射系数
>
> **blurRadius**：模糊半径
>
> 你可以修改这些值，试试不同的效果，比如我修改下上述的，又会是另一种效果：
>
> //这里为了明显点，换成了绿色
>
> 
* * *
## 3.注意事项
> 在使用MaskFilter的时候要注意，当我们的targetSdkVersion >= 14的时候，MaskFilter 就不会起效果了，这是因为Android在API 14以上版本都是默认开启硬件加速的，这样充分 利用GPU的特性，使得绘画更加平滑，但是会多消耗一些内存！好吧，我们把硬件加速关了 就好，可以在不同级别下打开或者关闭硬件加速，一般是关闭~
>
> * **Application**：在配置文件的application节点添加： android:hardwareAccelerated="true"
> * **Activity**：在配置文件的activity节点添加 android:hardwareAccelerated="false"
> * **View**：可以获得View对象后调用，或者直接在View的onDraw()方法里设置： view.setLayerType(View.LAYER_TYPE_HARDWARE, null);
* * *
## 示例代码下载：
[MaskFilterDemo.zip](http://static.runoob.com/download/MaskFilterDemo.zip)
* * *
## 本节小结：
> 本节给大家演示了Paint的一个API，**setMaskFilter(MaskFilter maskfilter)**，学习了 MaskFilter两个子类的基本用法：BlurMaskFilter(模糊效果)与EmbossMaskFilter(浮雕效果)， 比较简单，多学一点，对我们进阶部分的自定义控件也是没有坏处的~好的，就说这么多， 谢谢~
>
> 对了，忘了说，其实在SDK中的example中有个类，就演示了这两种用法：
>
> **samples\android-xx\legacy\ApiDemos\src\com\example\android\apis\graphics** 目录下的：**FingerPaint.java**文件~