【Android 内存优化】图片文件压缩 ( Android 原生 API 提供的图片压缩功能能 | 图片质量压缩 | 图片尺寸压缩 )

CompressFormat format 参数 : 被压缩的目标格式, 要将该图片压缩成什么格式 JPEG, PNG, WEBP , 压缩格式从下面的枚举类型中获取 ;
    /**
     * Bitmap 位图只能被压缩成以下三种格式
     */
    public enum CompressFormat {
        JPEG    (0),
        PNG     (1),
        WEBP    (2);
        CompressFormat(int nativeInt) {
            this.nativeInt = nativeInt;
        }
        final int nativeInt;
    }

/**
     * 写出该位图压缩后的版本到输出流中
     * 如果该方法返回 true, 该位图可以向 BitmapFactory.decodeStream() 传入对应输入流进行恢复. 
     * 传入的压缩配置并不是所有的格式都接收所有的配置,
     * 从 BitmapFactory 返回的位图极有可能与原图位深度不同,
     * 如果是 JPEG 格式, 其没有透明度通道, 只支持
     *
     * @param format   被压缩的目标格式, 要将该图片压缩成什么格式 JPEG, PNG, WEBP 
     * @param quality  给压缩器的质量, 0-100. 0 压缩到极限最小, 100 压缩时最高质量
     *        PNG 图片是无损图片格式, 其质量不能被降低, 会忽略该参数; 
     * @param stream   写出被压缩图片的输出流, 可以是文件输出流 , 也可以是网络流
     * @return 如果压缩成功, 并写出到指令的输出流, 返回 true
     */
    @WorkerThread
    public boolean compress(CompressFormat format, int quality, OutputStream stream) {
      // 首先检查该图片是否被回收, 如果已经被回收, 直接丢出异常退出
        checkRecycled("Can't compress a recycled bitmap");
        // 调用输出流时会调用 Native 方法, 显示检查该流是否合法
        if (stream == null) {
            throw new NullPointerException();
        }
        // 输入的质量是否合法
        if (quality < 0 || quality > 100) {
            throw new IllegalArgumentException("quality must be 0..100");
        }
        // 严格模式 
        StrictMode.noteSlowCall("Compression of a bitmap is slow");
        // 输出压缩过程中的执行细节
        Trace.traceBegin(Trace.TRACE_TAG_RESOURCES, "Bitmap.compress");
        // 执行 Native 方法, 压缩图片
        boolean result = nativeCompress(mNativePtr, format.nativeInt,
                quality, stream, new byte[WORKING_COMPRESS_STORAGE]);
        Trace.traceEnd(Trace.TRACE_TAG_RESOURCES);
        return result;
    }

**
     * 创建一个新的 Bitmap 对象 , 缩放一张已存在的位图 ;
     * 如果指定的宽高与当前源位图的宽高一致 , 那么直接将源位图返回
     *
     * @param src       位图原图
     * @param dstWidth  图片转换后的目标宽度
     * @param dstHeight 图片转换后的目标高度
     * @param filter    设置缩放图像时是否使用双线性滤波. 
     *      如果设置成 true , 则使用双线性滤波 , 
     *      当缩放时图片质量更好 , 但是会降低性能 ; 
     *      如果设置成 false , 使用最近邻法进行尺寸缩放 ,
     *      图片质量差 , 但是速度很快 ;
     *      推荐默认设置成 true , 双线性滤波开销很小 , 对于图像质量的改善效果显著 ;
     * @return 返回新的被缩放好的 Bitmap 位图 , 如果缩放失败 , 返回源图 ;
     * @throws IllegalArgumentException 如果传入的宽高值参数小于等于 0, 抛出异常 ;
     */
    public static Bitmap createScaledBitmap(@NonNull Bitmap src, int dstWidth, int dstHeight,
            boolean filter) {
        Matrix m = new Matrix();
        final int width = src.getWidth();
        final int height = src.getHeight();
        if (width != dstWidth || height != dstHeight) {
            final float sx = dstWidth / (float) width;
            final float sy = dstHeight / (float) height;
            m.setScale(sx, sy);
        }
        /*
          最终调用的是 public static Bitmap createBitmap(
          @NonNull Bitmap source, int x, int y, int width, int height,
            @Nullable Matrix m, boolean filter) 方法 , 后续博客有详细解析
         */
        return Bitmap.createBitmap(src, 0, 0, width, height, m, filter);
    }