FaceBook推出的图片处理框架
主页: https://github.com/facebook/fresco
中文文档:http://fresco-cn.org/docs/index.html
功能
在XML中使用 Drawees
在Java代码中使用 Drawees
Drawee的各种效果配置
进度条
缩放
圆角/圆圈
渐进式JPEG图
动画图(gif)
多图请求及图片复用
监听下载事件
缩放和旋转
使用步骤
1.添加依赖: compile 'com.facebook.fresco:fresco:0.9.0+'
2.添加权限
<uses-permission android:name="android.permission.INTERNET"/>
3.在Application初始化或在Activity 的**setContentView()方法之前**,进行初始化,开发中一般在Application中初始化
,
Fresco.initialize(this);
4.在布局文件中添加图片控件.宽高必须显示指定,否则图片无法显示.需要添加自定义的命名空间
xmlns:app=http://schemas.android.com/apk/res-auto
<com.facebook.drawee.view.SimpleDraweeView
android:id="@+id/my_image_view"
android:layout_width="200dp"
android:layout_height="200dp"
app:placeholderImage="@mipmap/ic_launcher" /> //设置默认加载的图片
5.在Java代码中指定图片的路径.显示图片.SimpleDraweeView接收的路径参数为URI,所以需要一次转换.
SimpleDraweeView view = (SimpleDraweeView) findViewById(R.id.my_image_view);
view.setImageURI(Uri.parse(file:///sdcard/Download/mm.jpg));
6.XML方式配置参数.除图片地址以外,其他所有显示选项都可以在布局文件中指定
<com.facebook.drawee.view.SimpleDraweeView
android:id="@+id/my_image_view"
android:layout_width="20dp"
android:layout_height="20dp"
fresco:actualImageScaleType="focusCrop"// 图片的缩放方式.
fresco:backgroundImage="@color/blue" //背景图.不支持缩放.XML仅能指定一张背景图.如果使用Java代码指定的话,可以指定多个背景,显示方式类似FrameLayout,多个背景图按照顺序一级一级层叠上去.
fresco:fadeDuration="300" // 渐显图片的时间
fresco:failureImage="@drawable/error" // 图片加载失败显示的图片
fresco:failureImageScaleType="centerInside" 图片加载失败显示的图片的缩放类型
fresco:overlayImage="@drawable/watermark" // 层叠图,最后叠加在图片之上.不支持缩放.XML仅能指定一张.如果使用Java代码指定的话,可以指定多个,显示方式类似FrameLayout,多个图按照顺序一级一级层叠上去.
fresco:placeholderImage="@color/wait_color" // 图片加载成功之前显示的占位图
fresco:placeholderImageScaleType="fitCenter" // 图片加载成功之前显示的占位图的缩放类型
fresco:pressedStateOverlayImage="@color/red" // 设置按压状态下的层叠图.不支持缩放.
fresco:progressBarAutoRotateInterval="1000" // 进度条图片旋转显示时长
fresco:progressBarImage="@drawable/progress_bar" // 进度条图片
fresco:progressBarImageScaleType="centerInside" //进度条图片的缩放类型
fresco:retryImage="@drawable/retrying" // 当图片加载失败的时候,显示该图片提示用户点击重新加载图片
fresco:retryImageScaleType="centerCrop" // 提示图片的缩放类型
fresco:roundAsCircle="false" // 显示圆形图片
fresco:roundBottomLeft="false" // roundedCornerRadius属性设置后,四个角都会有圆角,如果左下角不需要设置为false.
fresco:roundBottomRight="true" // roundedCornerRadius属性设置后,四个角都会有圆角,如果右下角不需要设置为false.
fresco:roundTopLeft="true" // roundedCornerRadius属性设置后,四个角都会有圆角,如果左上角不需要设置为false.
fresco:roundTopRight="false" // roundedCornerRadius属性设置后,四个角都会有圆角,如果右上角不需要设置为false.
fresco:roundWithOverlayColor="@color/corner_color" // 设置图片圆角后空出区域的颜色.如示例图中的红色部分
fresco:roundedCornerRadius="1dp" // 设置图片圆角角度,设置该属性后四个角都会生效
fresco:roundingBorderColor="@color/border_color" // 设置圆角后,边框的颜色.
resco:roundingBorderWidth="2dp" /> // 设置圆角后,外边框的宽高
7.Java代码配置参数.
设置默认的图片
GenericDraweeHierarchy hierarchy = GenericDraweeHierarchyBuilder
.newInstance(getResources())
.setRetryImage(getResources().getDrawable(R.mipmap.ic_launcher))
.build();
imageivew.setHierarchy(hierarchy);
8.显示GIF图片.Fresco 支持 GIF 和 WebP 格式的动画图片.如果你希望图片下载完之后自动播放,同时,当View从屏幕移除时,停止播放,只需要在 image request 中简单设置,示例代码:
SimpleDraweeView imageView = (SimpleDraweeView) findViewById(R.id.iv_gif);
//设置显示gif图的控制器
DraweeController controller = Fresco.newDraweeControllerBuilder()
.setUri(Uri.parse("http://192.168.13.77:8080/nice/fresco.gif"))
.setAutoPlayAnimations(true) //播放gif图片
.build();
//显示gif图
imageView.setController(controller);