图片裁剪框架ucrop使用前的封装

项目地址:

uCrop

我封装好的CropUtils

uCrop本身的文档说明

去剪切前配置参数:

UCrop.of(sourceUri, destinationUri).withAspectRatio(16, 9).withMaxResultSize(maxWidth, maxHeight).start(context);

剪切完后,在onactivityResult里处理数据

@Overridepublic void onActivityResult(int requestCode, int resultCode, Intent data) {    if (resultCode == RESULT_OK && requestCode == UCrop.REQUEST_CROP) {        final Uri resultUri = UCrop.getOutput(data);    } else if (resultCode == UCrop.RESULT_ERROR) {        final Throwable cropError = UCrop.getError(data);    }}

分析

框架本身直接接收图片文件的uri,返回intent.

而在实际开发中,往往是从图库里选择图片,或者调用照相机拍照后,再跳到裁剪的页面.

onActivityResult里的代码有很多共通的地方,需要进行封装.

封装

首先是从图片库选择和从照相机拍照的动作的封装

　从系统图库选择,只能单选：

 public static void pickFromGallery(Activity context) {    Intent intent = new Intent();    intent.setType("image/*");    intent.setAction(Intent.ACTION_GET_CONTENT);    intent.addCategory(Intent.CATEGORY_OPENABLE);    context.startActivityForResult(Intent.createChooser(intent, "选择图片"), REQUEST_SELECT_PICTURE);}

调用系统拍照功能

    Uri mDestinationUri = buildUri();    Intent intent = new Intent(MediaStore.ACTION_IMAGE_CAPTURE)            .putExtra(MediaStore.EXTRA_OUTPUT, mDestinationUri);    context.startActivityForResult(intent, REQUEST_CAMERA);

这里要注意,一定要指定拍照后生成的图片的uri路径,并保证uri路径可访问.

如果不指定uri,那么系统会使用默认uri,并放在intent的data里,在onActivityResult里返回.但这只是原生系统的,各厂商改rom,这里经常会返回intent为null或者intent里的data为null.

图片uri的生成路径: sd卡目录/项目名/crop/xxx-yyy.jpg, 其中yyy可以通过System.currentTimeMills 来生成,保证每次都不同.

生成该路径的方法封装成:buildUri();

拍照或选图的第一次 onActivityResult,拿到所得原始图片的uri:

注意onActivityResult会调用两次,一次是选择了原图后,第二次是照片裁剪好后.

为了简化使用,我们希望达到的结果是,调用时用一行代码就写好了.

通用的处理逻辑封装到CropUtils..handleResult()里,而最终剪切成功和失败的处理提取成接口cropHandler.

如此一来,只要在具体的activity里实现CropHandler,处理剪切后的图片即可.

注意: 从图片库中选择的uri是可以通过intent传递回来的,而拍照时由于指定了uri,所以不需要从intent里拿,直接取存在静态变量uri里的值就行.

//使用时的调用: @Overrideprotected void onActivityResult(int requestCode, int resultCode, Intent data) {    super.onActivityResult(requestCode, resultCode, data);    CropUtils.handleResult(this,cropHandler,requestCode,resultCode,data);}//方法的封装: public static void handleResult(Activity context, CropHandler cropHandler, int requestCode, int resultCode, Intent data) {    if (resultCode == Activity.RESULT_OK) {        if (requestCode == REQUEST_SELECT_PICTURE) {//第一次，选择图片后返回            final Uri selectedUri = data.getData();            if (selectedUri != null) {                startCropActivity(context, data.getData());            } else {                Toast.makeText(context, "Cannot retrieve selected image", Toast.LENGTH_SHORT).show();            }        } else if (requestCode == UCrop.REQUEST_CROP) {//第二次返回，图片已经剪切好            Uri finalUri = UCrop.getOutput(data);            cropHandler.handleCropResult(finalUri,config.tag);            config = new CropConfig();//参数重置        } else if (requestCode == REQUEST_CAMERA) {//第一次，拍照后返回，因为设置了MediaStore.EXTRA_OUTPUT，所以data为null，数据直接就在uri中            startCropActivity(context, uri);        }    }    if (resultCode == UCrop.RESULT_ERROR) {        cropHandler.handleCropError(data);        config = new CropConfig();//参数重置    }}//CropHandler接口: public interface CropHandler {     void handleCropResult(Uri uri,int tag);    void handleCropError(Intent data);}

拿到原图uri后,去开启剪切图片的activity:

startCropActivity(context, uri);

主要动作是设置参数.在原框架里,是通过Urcop类的链式调用来设置到intent里,然后传递到UcropActivity里的.

我们外面封装时,为简化起见,将众多参数封装成一个类 CropConfig,并在初始化时赋予默认值.

public static class CropConfig{    public int aspectRatioX = 1;    public int aspectRatioY = 1;    public int maxWidth = 1080;    public int maxHeight = 1920;    //options    public int  tag ;    public  boolean isOval = false;//是否为椭圆    public int quality = 80;    public boolean hideBottomControls = true;//底部操作条    public boolean showGridLine = true;//内部网格    public boolean showOutLine = true;//最外面的矩形线    ...    }     private static void startCropActivity(Activity context, Uri sourceUri) {        Uri mDestinationUri = buildUri();        UCrop uCrop = UCrop.of(sourceUri, mDestinationUri);        uCrop.withAspectRatio(config.aspectRatioX,config.aspectRatioY);        uCrop.withMaxResultSize(config.maxWidth,config.maxHeight);        UCrop.Options options = new UCrop.Options();        options.setCompressionFormat(Bitmap.CompressFormat.JPEG);        options.setAllowedGestures(UCropActivity.SCALE,UCropActivity.NONE,UCropActivity.NONE);        options.setCompressionQuality(config.quality);        options.setOvalDimmedLayer(config.isOval);        options.setShowCropGrid(config.showGridLine);        options.setHideBottomControls(config.hideBottomControls);        options.setShowCropFrame(config.showOutLine);        uCrop.withOptions(options);        uCrop.start(context);        }

图片裁剪完成后,再次回调到onActivityResult,见上方代码.

最终使用者在使用时,实现 cropHandler: 基本上是作为成员变量使用.

private CropUtils.CropHandler cropHandler = new CropUtils.CropHandler() {    @Override    public void handleCropResult(Uri data, int tag) {        if (data != null) {            ResultActivity.startWithUri(context, data);        } else {            Toast.makeText(context, R.string.toast_cannot_retrieve_cropped_image, Toast.LENGTH_SHORT).show();        }    }    @Override    public void handleCropError(Intent data) {        final Throwable cropError = UCrop.getError(data);        if (cropError != null) {            Log.e("dd", "handleCropError: ", cropError);            Toast.makeText(context, cropError.getMessage(), Toast.LENGTH_LONG).show();        } else {            Toast.makeText(context, R.string.toast_unexpected_error, Toast.LENGTH_SHORT).show();        }    }};

tag的作用:

如果一个activity中有多个地方需要图片裁剪功能,那么就需要以tag区分.

对外提供的api

什么配置都不做,最基本的选图库,选[拍照

 public static void pickFromGallery(Activity context) {    Intent intent = new Intent();    intent.setType("image/*");    intent.setAction(Intent.ACTION_GET_CONTENT);    intent.addCategory(Intent.CATEGORY_OPENABLE);    context.startActivityForResult(Intent.createChooser(intent, "选择图片"), REQUEST_SELECT_PICTURE);}public static void pickFromCamera(Activity context) {    Uri mDestinationUri = buildUri();    Intent intent = new Intent(MediaStore.ACTION_IMAGE_CAPTURE)            .putExtra(MediaStore.EXTRA_OUTPUT, mDestinationUri);    context.startActivityForResult(intent, REQUEST_CAMERA);}

配置好config的选择与裁剪:

 public static void pickFromGallery(Activity context,CropConfig config,int type) {    if (config != null){        CropUtils.config = config;    }    setType(type);    pickFromGallery(context);}

头像剪切: 这个基本是所有app都会有的功能:

主要达到的效果是:

宽高比为1:1
圆形蒙版,直接看到最终圆形头像显示效果,
没有表格线和最外框线
没有底部多余的操作条
宽高最大为400像素 – 能满足大多数应用了.

 public static void pickAvatarFromGallery(Activity context){    pickFromGallery(context,null,TYPE_AVATAR);} private static void setType(int type) {    if (type == TYPE_AVATAR){        config.isOval = true;        config.aspectRatioX = 1;        config.aspectRatioY = 1;        config.hideBottomControls = true;        config.showGridLine = false;        config.showOutLine = false;        config.maxHeight = 400;        config.maxWidth = 400;    }else  if (type == TYPE_NORMAL){//什么都不用做    }else {    }}