很多时候，自定义相机都带有裁剪功能，裁剪功能的前提条件是有图片，项目上通常有两种方法：打开系统相册获取图片、拍照获取图片

当拍完照或者从相册选择一张图片之后，对图片进行裁剪，图片裁剪的代码网上一大堆，基本代码如下：

private Intent crop(Uri uri) {
    Intent intent = new Intent("com.android.camera.action.CROP");
    intent.setDataAndType(uri, "image/*");
    intent.putExtra("crop", "true");// 可裁剪
    intent.putExtra("aspectX", 1);// 裁剪的宽比例
    intent.putExtra("aspectY", 1);// 裁剪的高比例
    intent.putExtra("outputX", 300);// 裁剪的宽度
    intent.putExtra("outputY", 300);// 裁剪的高度
    intent.putExtra("scale", true);// 是否支持缩放
    //intent.putExtra("circleCrop", "true");// 圆形裁剪区域(设置无效)

    String crop_path = Environment.getExternalStorageDirectory() + File.separator + "1" + File.separator + "crop_"+new DateFormat().format("yyyyMMddhhmmss", Calendar.getInstance(Locale.CHINA)) + ".jpg";

    intent.putExtra(MediaStore.EXTRA_OUTPUT, Uri.fromFile(new File(crop_path)));
    // 是否返回数据
    intent.putExtra("return-data", true);
    // 裁剪成的图片的输出格式
    intent.putExtra("outputFormat", Bitmap.CompressFormat.JPEG.toString());
    //是否关闭人脸识别
    //intent.putExtra("noFaceDetection", true);
    return intent;
}

//拿到图片资源后开始截图
startActivityForResult(crop(mImageUri), TAKEPHOTO_REQUEST_CODE);

图片裁剪的代码其实和拍照有很多类似之处了，以上代码直接复制粘贴拿去用即可。

代码中Intent传递了很多参数，那些参数真的就有用吗？下面结合源码说明哪些参数的意思。

我在这个http://androidxref.com/网站上可以在线查看源码（当然也可以下载）

我准备了两部手机，下面分别对这两部手机的图片裁剪逻辑进行分析。

【手机一】乐1s

型号：Letv X500
Android版本：5.0.2

图片.png

上图就是该手机的默认截图页面，在Android Studio中的Terminal中输入

adb shell dumpsys activity activities

之后，控制台会打印出栈中所有的Activity，其中位于栈顶位置的Activity是com.android.gallery3d/.filtershow.crop.CropActivity。

打开上面提到的网站，选择5.0.0_r2项目，查看源码，搜索CropActivity类，找到该类的源码，分析源码之后，发现Intent传递过去的参数是由CropExtras对象封装的，CropExtras类的代码不是很多，直接贴出来吧：

/*
 * Copyright (C) 2012 The Android Open Source Project
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *      http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

package com.android.gallery3d.filtershow.crop;

import android.net.Uri;

public class CropExtras {

    public static final String KEY_CROPPED_RECT = "cropped-rect";
    public static final String KEY_OUTPUT_X = "outputX";
    public static final String KEY_OUTPUT_Y = "outputY";
    public static final String KEY_SCALE = "scale";
    public static final String KEY_SCALE_UP_IF_NEEDED = "scaleUpIfNeeded";
    public static final String KEY_ASPECT_X = "aspectX";
    public static final String KEY_ASPECT_Y = "aspectY";
    public static final String KEY_SET_AS_WALLPAPER = "set-as-wallpaper";
    public static final String KEY_RETURN_DATA = "return-data";
    public static final String KEY_DATA = "data";
    public static final String KEY_SPOTLIGHT_X = "spotlightX";
    public static final String KEY_SPOTLIGHT_Y = "spotlightY";
    public static final String KEY_SHOW_WHEN_LOCKED = "showWhenLocked";
    public static final String KEY_OUTPUT_FORMAT = "outputFormat";

    private int mOutputX = 0;
    private int mOutputY = 0;
    private boolean mScaleUp = true;
    private int mAspectX = 0;
    private int mAspectY = 0;
    private boolean mSetAsWallpaper = false;
    private boolean mReturnData = false;
    private Uri mExtraOutput = null;
    private String mOutputFormat = null;
    private boolean mShowWhenLocked = false;
    private float mSpotlightX = 0;
    private float mSpotlightY = 0;

    public CropExtras(int outputX, int outputY, boolean scaleUp, int aspectX, int aspectY,
            boolean setAsWallpaper, boolean returnData, Uri extraOutput, String outputFormat,
            boolean showWhenLocked, float spotlightX, float spotlightY) {
        mOutputX = outputX;
        mOutputY = outputY;
        mScaleUp = scaleUp;
        mAspectX = aspectX;
        mAspectY = aspectY;
        mSetAsWallpaper = setAsWallpaper;
        mReturnData = returnData;
        mExtraOutput = extraOutput;
        mOutputFormat = outputFormat;
        mShowWhenLocked = showWhenLocked;
        mSpotlightX = spotlightX;
        mSpotlightY = spotlightY;
    }

    public CropExtras(CropExtras c) {
        this(c.mOutputX, c.mOutputY, c.mScaleUp, c.mAspectX, c.mAspectY, c.mSetAsWallpaper,
                c.mReturnData, c.mExtraOutput, c.mOutputFormat, c.mShowWhenLocked,
                c.mSpotlightX, c.mSpotlightY);
    }

    public int getOutputX() {
        return mOutputX;
    }

    public int getOutputY() {
        return mOutputY;
    }

    public boolean getScaleUp() {
        return mScaleUp;
    }

    public int getAspectX() {
        return mAspectX;
    }

    public int getAspectY() {
        return mAspectY;
    }

    public boolean getSetAsWallpaper() {
        return mSetAsWallpaper;
    }

    public boolean getReturnData() {
        return mReturnData;
    }

    public Uri getExtraOutput() {
        return mExtraOutput;
    }

    public String getOutputFormat() {
        return mOutputFormat;
    }

    public boolean getShowWhenLocked() {
        return mShowWhenLocked;
    }

    public float getSpotlightX() {
        return mSpotlightX;
    }

    public float getSpotlightY() {
        return mSpotlightY;
    }
}

进一步分析源码，发现属性aspectX、aspectY、outputX、outputY、return-data、outputFormat都能发挥出预想的作用，但是crop、scale、crop、circleCrop、noFaceDetection都无效。

然而，有两个属性却是有用的，分别是spotlightX、spotlightY

    intent.putExtra("spotlightX", 1.1f);//X轴方向的抽屉式壁纸选择框
    intent.putExtra("spotlightY", 2.1f);//Y轴方向的抽屉式壁纸选择框

加上以上两个属性之后，截图的预览效果如下：

图片.png

最后，还有两个参数需要了解一下，outputX和outputY两个参数的作用大家都知道，是输出图片的宽度和高度。

如果不考虑定制手机对其修改的影响，当outputX或outputY设置为0时，就是实际裁剪的宽度和高度。

但是，我的oppo手机却不是这样的。

【手机二】OPPO R11 Plus

型号：OPPO R11 Plus
Android版本：8.1.0

图片.png

上图就是该手机的默认截图页面，在Android Studio中的Terminal中输入

adb shell dumpsys activity activities

之后，控制台会打印出栈中所有的Activity，其中位于栈顶位置的Activity是

com.coloros.gallery3d/com.oppo.gallery3d.app.CropImage

打开上面提到的网站，选择8.1.0_r33项目，查看源码，搜索CropImage类，找到该类的源码，CropImage类是一个Activity类，分析源码之后，发现Intent传递过去的参数可以是circleCrop 、outputFormat 、setWallpaper 、data 、aspectX 、aspectY 、outputX 、outputY 、scale 、scaleUpIfNeeded 、noFaceDetection

circleCrop ：从源码分析，裁剪图片之后保存到本地的图片为圆形或者椭圆形。

根据源码要求，我将属性写成这样

    intent.putExtra("aspectX", 1);// 裁剪的宽比例
    intent.putExtra("aspectY", 1);// 裁剪的高比例
    intent.putExtra("outputX", 0);// 裁剪之后输出图片的宽度
    intent.putExtra("outputY", 0);// 裁剪之后输出图片的高度
    intent.putExtra("scale", false);// 是否支持缩放
    intent.putExtra("circleCrop", "true");

保存的图片应该是圆形或者椭圆才是，但是事实上，OPPO手机对CropImage类做了一些修改，导致原生功能失效。在OPPO手机上，"outputX和outputY都不能设置为0，裁剪的图片保存之后无法显示（不是有效图）。

除此之外，我在Android 8.0源码中发现了noFaceDetection参数的作用，如果该参数为true的话则支持人脸识别功能。

      if (faceBitmap != null && mDoFaceDetection) {
            FaceDetector detector = new FaceDetector(faceBitmap.getWidth(),
                    faceBitmap.getHeight(), mFaces.length);
            mNumFaces = detector.findFaces(faceBitmap, mFaces);
        }

解析一张人脸图，拿到人脸相关数据。

分析人脸数据的核心代码如下：

    private void handleFace(FaceDetector.Face f) {
        PointF midPoint = new PointF();

        int r = ((int) (f.eyesDistance() * mScale)) * 2;
        f.getMidPoint(midPoint);
        midPoint.x *= mScale;
        midPoint.y *= mScale;

        int midX = (int) midPoint.x;
        int midY = (int) midPoint.y;

        HighlightView hv = new HighlightView(mImageView);

        int width = mBitmap.getWidth();
        int height = mBitmap.getHeight();

        Rect imageRect = new Rect(0, 0, width, height);

        RectF faceRect = new RectF(midX, midY, midX, midY);
        faceRect.inset(-r, -r);
        if (faceRect.left < 0) {
            faceRect.inset(-faceRect.left, -faceRect.left);
        }

        if (faceRect.top < 0) {
            faceRect.inset(-faceRect.top, -faceRect.top);
        }

        if (faceRect.right > imageRect.right) {
            faceRect.inset(faceRect.right - imageRect.right,
                           faceRect.right - imageRect.right);
        }

        if (faceRect.bottom > imageRect.bottom) {
            faceRect.inset(faceRect.bottom - imageRect.bottom,
                           faceRect.bottom - imageRect.bottom);
        }

        hv.setup(mImageMatrix, imageRect, faceRect, mCircleCrop,
                 mAspectX != 0 && mAspectY != 0);

        mImageView.add(hv);
    }

人脸识别属于图像处理的范畴中，不是本章的终点，这里就此略过。

说到这里，是不是感觉到系统图片裁剪功能很坑？ 我这里只能找到Andorid各种版本的源码进行分析，但是无法找到各大厂商的源码，各大厂商做了一些定制。有关系统裁剪功能就分析到这里了，为了保证各大厂商系统的兼容性，我们可以使用最简单的图片裁剪功能，代码如下：

private Intent crop(Uri uri) {
    Intent intent = new Intent("com.android.camera.action.CROP");
    intent.setDataAndType(uri, "image/*");
    intent.putExtra("aspectX", 1);// 裁剪的宽比例
    intent.putExtra("aspectY", 1);// 裁剪的高比例
    intent.putExtra("outputX", 300);// 裁剪之后输出图片的宽度
    intent.putExtra("outputY", 300);// 裁剪之后输出图片的高度
    // 是否返回数据
    intent.putExtra("return-data", true);

    // 将裁剪的结果输出到制定的Uri
    String crop_path = Environment.getExternalStorageDirectory() + File.separator + "1" + File.separator + "crop_"+new DateFormat().format("yyyyMMddhhmmss", Calendar.getInstance(Locale.CHINA)) + ".jpg";
    intent.putExtra(MediaStore.EXTRA_OUTPUT, Uri.fromFile(new File(crop_path)));

    // 裁剪成的图片的输出格式
    intent.putExtra("outputFormat", Bitmap.CompressFormat.JPEG.toString());
    return intent;
}

//拿到图片资源后开始截图
startActivityForResult(crop(mImageUri), TAKEPHOTO_REQUEST_CODE);

其中有以下几点需要注意：

• outputX和outputY不能为0，有些手不支持为0的情况。
• outputX和outputY不能设置太大，我的demo中仅仅设置了300，但部分手机设置600之后系统层出现OOM现象。
• return-data属性值只能是true，否则不会返回数据。
• URI对象的获取必须是以下代码

Uri.fromFile(new File(crop_path))

如果写成

Uri.parse(crop_path)

则可能没有数据返回。

[本章完...]