Android图片剪裁库

最近利用一周左右的业余时间，终于完成了一个Android图片剪裁库，核心功能是根据自己的理解实现的，部分代码参考了Android源码的图片剪裁应用。现在将该代码开源在Github上以供大家学习和使用，地址：https://github.com/Jhuster/ImageCropper，效果如下所示：

我的大致计划是首先介绍一下这个库的用法，然后再写几篇文章介绍一下其中的一些原理和关键技术，希望对Android开发新手有所帮助。

【特性】

1. 支持通过手势移动和缩放剪裁窗口
2. 支持固定剪裁窗口大小、固定窗口的长宽比率
3. 支持设置最大的窗口长和宽
4. 支持剪裁图片的旋转
5. 易于集成和使用

【使用方法】

1. 修改AndroidManifest.xml文件

<activity android:name="com.ticktick.imagecropper.CropImageActivity"/>

需要添加写SDcard的权限

<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />

2. 启动图片剪裁界面的方法

第一种方法，使用库中封装的CropIntent来构建Intent对象：

private void startCropImage() {

    // Create a CropIntent
    CropIntent intent = new CropIntent(); 

    // Set the source image filepath/URL and output filepath/URL (Required)
    intent.setImagePath("/sdcard/source.jpg");
    intent.setOutputPath("/sdcard/cropped.jpg");

    // Set a fixed crop window size (Optional)
    intent.setOutputSize(640,480);

    // Set the max crop window size (Optional)
    intent.setMaxOutputSize(800,600);

    // Set a fixed crop window‘s width/height aspect (Optional)
    intent.setAspect(3,2);

    // Start ImageCropper activity with certain request code and listen for result
    startActivityForResult(intent.getIntent(this), REQUEST_CODE_CROP_PICTURE);
}

第二种方法，自定义Intent对象：

private void startCropImage() {

    // Create explicit intent
    Intent intent = new Intent(this, CropImageActivity.class);

    // Set the source image filepath/URL and output filepath/URL (Required)
    intent.setData(Uri.fromFile(new File("/sdcard/source.jpg")));
    intent.putExtra(MediaStore.EXTRA_OUTPUT,Uri.fromFile(new File("/sdcard/cropped.jpg")));

    // Set a fixed crop window size (Optional)
    intent.putExtra("outputX",640);
    intent.putExtra("outputY",480);

    // Set the max crop window size (Optional)
    intent.putExtra("maxOutputX",800);
    intent.putExtra("maxOutputY",600);

    // Set a fixed crop window‘s width/height aspect (Optional)
    intent.putExtra("aspectX",3);
    intent.putExtra("aspectY",2);

    // Start ImageCropper activity with certain request code and listen for result
    startActivityForResult(intent, REQUEST_CODE_CROP_PICTURE);
}

3. 获取剪裁结果

剪裁结束后，如果用户点击了“Save”按钮，则可以通过MediaStore.EXTRA_OUTPUT得到保存的图片的URL地址；如果用户点击了“Cancel”，则Activity的返回值会被设置为 RESULT_CANCEL

protected void onActivityResult(int requestCode, int resultCode, Intent data) {

    if (resultCode != RESULT_OK) {
        return;
    }

    if (requestCode == REQUEST_CODE_CROP_PICTURE ) {
        Uri croppedUri = data.getExtras().getParcelable(MediaStore.EXTRA_OUTPUT);
        InputStream in = null;
    try {
            in = getContentResolver().openInputStream(croppedUri);
            Bitmap b = BitmapFactory.decodeStream(in);
            mImageView.setImageBitmap(b);
        }
    catch (FileNotFoundException e) {
            e.printStackTrace();
        }
    }
    super.onActivityResult(requestCode, resultCode, data);
}