图片加载框架之fresco
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);