Fresco基本用法

Fresco -- Facebook发布的一款开源框架（Android图片加载库）

1）添加依赖库。

studio添加fresco的jar包依赖使用括号里面的就行（compil 'com.facebook.fresco:fresco:0.8.1'）    加载gif用太高版本的Fresco显示效果不会动

dependencies {    compile fileTree(include: ['*.jar'], dir: 'libs')    testCompile 'junit:junit:4.12'    compile 'com.android.support:appcompat-v7:26.+'    compile 'com.facebook.fresco:fresco:0.8.1'}

2）如果多次用到Fresco建议在 Application 初始化，其余情况也必须要在setContentView()  之前调用初始化：

package com.example.frescodemo;import android.app.Application;import com.facebook.drawee.backends.pipeline.Fresco;public class MyApplication extends Application {    @Override    public void onCreate() {        super.onCreate();        Fresco.initialize(this);    }}

public class MainActivity extends AppCompatActivity {    private SimpleDraweeView sdv;    @Override    protected void onCreate(Bundle savedInstanceState) {        super.onCreate(savedInstanceState);        Fresco.initialize(this);//Fresco的初始化，必须调用在setContentView之前        setContentView(R.layout.activity_main);
   }}
如果设置gif图只需要调用setAutoPlayAnimations(true) ，使用gif图要注意开源库版本选低一点，目前高版本的效果只显示不会动：

3）如果加载的是一张网络图片，需要获得网络权限
<uses-permission android:name="android.permission.INTERNET"/>

4）注意：Fresco 不支持相对路径的URI. 所有的URI都必须是绝对路径，并且带上该URI的scheme。
URIs的使用：
类型Scheme示例远程图片http://, https://HttpURLConnection 或者参考 使用其他网络加载方案本地文件file://FileInputStreamContent providercontent://ContentResolverasset目录下的资源asset://AssetManagerres目录下的资源res://Resources.openRawResource
res 示例:Uri uri = Uri.parse("res://包名(实际可以是任何字符串甚至留空)/" + R.drawable.ic_launcher);

5）控件名字，命名空间都要注意使用，Fresco不同于其它几个图片加载库，它是基于自定义控件的，要使用控件SimpleDraweeView来显示图片，
注意，控件不支持宽高同时设置为wrap_content，默认强制设置宽高，否则不显示图片

<?xml version="1.0" encoding="utf-8"?><RelativeLayout    xmlns:android="http://schemas.android.com/apk/res/android"    xmlns:tools="http://schemas.android.com/tools"    xmlns:fresco="http://schemas.android.com/apk/res-auto"  //注意添加命名空间    android:layout_width="match_parent"    android:layout_height="match_parent"    tools:context="com.example.frescodemo.MainActivity">
    <com.facebook.drawee.view.SimpleDraweeView         android:layout_width="300dp"        android:layout_height="300dp"        android:id="@+id/main_simple_drawee_view"        fresco:placeholderImage="@mipmap/ic_launcher"/></RelativeLayout>
在XML中使用SimpleDraweeView:
给出一个完整的示例：
[html] view plain copy
 
<com.facebook.drawee.view.SimpleDraweeView  
    android:id="@+id/my_image_view"  
    android:layout_width="200dp"  
    android:layout_height="200dp"  
    fresco:fadeDuration="800"//淡入淡出的持续时间
    fresco:actualImageScaleType="focusCrop"  // 实际图像的缩放类型
    fresco:placeholderImage="@color/wait_color"  //占位图
    fresco:placeholderImageScaleType="fitCenter" //占位图的缩放类型
    fresco:failureImage="@drawable/error"//失败时显示的图片  
    fresco:failureImageScaleType="centerInside"//失败图片的显示方式  
    fresco:retryImage="@drawable/retrying"//重试图  
    fresco:retryImageScaleType="centerCrop"//重试图显示方式  
    fresco:progressBarImage="@drawable/progress_bar" //进度条图片
    fresco:progressBarImageScaleType="centerInside"  
    fresco:progressBarAutoRotateInterval="1000"  //进度图自动旋转间隔时间(单位：毫秒ms)
    fresco:backgroundImage="@color/blue"  //背景图片，这里的背景图片首先被绘制
    fresco:overlayImage="@drawable/watermark" // 设置叠加图，在xml中只能设置一张叠加图片，如果需要多张图片的话，需要在java代码中设置哦
    fresco:pressedStateOverlayImage="@color/red"  // 设置点击状态下的叠加图
    fresco:roundAsCircle="false"  //设置为圆形图
    fresco:roundedCornerRadius="1dp"  // 圆角半径
    fresco:roundTopLeft="true"  // 左上角是否为圆角
    fresco:roundTopRight="false"  
    fresco:roundBottomLeft="false"  
    fresco:roundBottomRight="true"  
    fresco:roundWithOverlayColor="@color/corner_color"  
    fresco:roundingBorderWidth="2dp"  //边框的宽度
    fresco:roundingBorderColor="@color/border_color"  //边框颜色
  />  
说明：必须声明 android:layout_width 和 android:layout_height，否则将无法正确加载图像，另外不支持 wrap_content 属性，但也有例外的时候，如果想固定控件的宽高比，则可以使用wrap_content,并通过在xml代码中设置fresco:viewAspectRatio="小数"或者在Java代码中设置mSimpleDraweeView.setAspectRatio(1.33f);即可。
上面的ImageScaleType有下面一些缩放类型：
类型描述center居中，无缩放centerCrop保持宽高比缩小或放大，是的两边都大于或等于边界，且宽和高契合显示边界，居中显示focusCrop同centerCrop，但居中点不是中点，而是指定的某个点centerInside缩放图片使两边都在显示边界内，居中显示。和fitCenter不同，不会对图片进行放大。如果尺寸大于显示边界，则保持宽高比例缩小图片。fitCenter保持宽高比，缩小或者放大，使得图片完全显示在显示边界内，且宽或高契合显示边界，居中显示。fitStart同上，但不居中，和显示边界左上对齐。fitEnd同fitCenter，但不居中，和显示边界右下对齐。fitXY不保存宽高比，填充满显示边界。none如果要使用tile mode显示，则需要设置为none
 
在Java中自定义显示图
一般情况下，在XML设置显示效果即可, 如果想更多定制化，可以这样:
创建一个 builder 然后设置给 SimpleDraweeView:
[java] view plain copy
List<Drawable> backgroundsList;  
List<Drawable> overlaysList;  
GenericDraweeHierarchyBuilder builder =  
    new GenericDraweeHierarchyBuilder(getResources());  
GenericDraweeHierarchy hierarchy = builder  
    .setFadeDuration(300)  
    .setPlaceholderImage(new MyCustomDrawable())  
    .setBackgrounds(backgroundList)  
    .setOverlays(overlaysList)  
    .build();  
mSimpleDraweeView.setHierarchy(hierarchy);  
注意：请不要多次调用setHierarchy，即使这个View是可回收的。创建 DraweeHierarchy 的较为耗时的一个过程，应该多次利用。
修改 DraweeHierarchy
DraweeHierarchy 的一些属性可以在运行时改变。
要改变这些属性，首先获取一个引用:
GenericDraweeHierarchy hierarchy = mSimpleDraweeView.getHierarchy();
修改占位图
修改占位图为资源id:hierarchy.setPlaceholderImage(R.drawable.placeholderId);
或者修改为一个 Drawable:Drawable drawable; hierarchy.setPlaceholderImage(drawable);

改变图像的显示
修改缩放类型:
hierarchy.setActualImageScaleType(ScalingUtils.ScaleType.CENTER_INSIDE);
如果你选择缩放类型为 focusCrop，需要指定一个居中点:hierarchy.setActualImageFocusPoint(point);

你可以为图像添加一个 color filter:
ColorFilter filter;
// 创建filter
hierarchy.setActualImageColorFilter(filter);

圆角
除了圆角显示方式（原来为圆角的不能修改为圆圈，反之亦然），其他圆角相关的呈现参数, 具体参见这里 是可以动态修改的。
如下: 获取DraweeHierarchy的圆角显示参数，修改圆角半径为10。
RoundingParams roundingParams = hierarchy.getRoundingParams();
roundingParams.setCornersRadius(10);
hierarchy.setRoundingParams(roundingParams);

有时候需要加载很多图片，这个时候如果网络情况不是很好的情况下，一直显示占位图，体验也不是很好，我们可以先显示一个低分辨率的图片，等到大图加载完成之后，在显示真正的图片。
DraweeController controller = Fresco.newDraweeControllerBuilder()    .setLowResImageRequest(ImageRequest.fromUri(lowResUri))    .setImageRequest(ImageRequest.fromUri(highResUri))    .setOldController(draweeView.getController())    .build();draweeView.setController(controller);
当然如果你想监听加载的过程，就加一个ControllerListen
        //写一个监听器 监听图片加载        ControllerListener listener = new BaseControllerListener(){            /**             * 当图片加载成功时会执行的方法             * @param id             * @param imageInfo             * @param animatable             */            @Override            public void onFinalImageSet(String id, Object imageInfo, Animatable animatable) {                super.onFinalImageSet(id, imageInfo, animatable);            }            /**             * 图片加载失败时调用的方法             * @param id             * @param throwable             */            @Override            public void onFailure(String id, Throwable throwable) {                super.onFailure(id, throwable);            }            /**             *  如果图片使用渐进式，这个方法将会被回调             * @param id             * @param throwable             */            @Override            public void onIntermediateImageFailed(String id, Throwable throwable) {                super.onIntermediateImageFailed(id, throwable);            }        };        DraweeController controller = Fresco.newDraweeControllerBuilder()                .setUri(uri)                .setAutoPlayAnimations(true)                .setControllerListener(listener)                .build();        sdv.setController(controller);

          以上内容仅为网络摘抄整理，方便日后使用