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

一、 图片压缩

---

图片压缩 :

① 文件压缩 : 图片的文件压缩 , 一张图片可以经过压缩 , 占用更少的磁盘或网络空间 ;

② 文件压缩应用场景 :

• 网络传输图片 : 上传图片至服务器 , 为了 节省占用的带宽资源 , 将图片文件进行压缩 ;
• 保存图片 : 保存图片到设备的 SD 卡 , 为了 节省磁盘资源 , 将图片文件进行压缩 ;

③ 内存压缩 : 与文件压缩相对应的是内存压缩 , 在 内存中如何使用更少的内存显示出想要显示的图片 ; 在之后的博客中会详细介绍 ;

二、 图片文件压缩类型

---

图片文件压缩类型 :

① 质量压缩 :

• 压缩清晰度 : 将图片的清晰度降低 , 一些画面的细节被模糊掉了 , 这些细节尽量不要让肉眼观察出来 ;
• 有损压缩 : 压缩后有信息损失 , 无法复原 ;

② 尺寸压缩 : 减小图片的尺寸大小 , 明显这个也是有损的 , 无法复原 ;

③ 不同压缩格式的压缩率 : webp > jpeg > png ;

• 如果图片不需要透明度 ( alpha ) 通道的信息 , 推荐使用 JPEG ;
• webp 目前使用还不是很广泛 ;

三、 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;
    }

• int quality 参数 : 给压缩器的质量, 0-100 ; 0 压缩到极限最小 , 100 压缩时最高质量 , PNG 图片是无损图片格式 , 其质量不能被降低 , 会忽略该参数 ;
• OutputStream stream 参数 : 写出被压缩图片的输出流, 可以是文件输出流 , 也可以是网络流 ;

③ 返回值 : 如果压缩成功, 并写出到指令的输出流, 返回 true ;

    /**
     * 写出该位图压缩后的版本到输出流中
     * 如果该方法返回 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;
    }

四、 Android 原生 API 提供的尺寸压缩

---

图片尺寸压缩函数原型 : 下面的函数原型中给出了详细注释 ;

① 函数作用 : 创建一个新的 Bitmap 对象 , 缩放一张已存在的位图 ; 如果指定的宽高与当前源位图的宽高一致 , 那么直接将源位图返回 ;

② 参数解析 :

• Bitmap src 参数 : 位图原图 ;
• int dstWidth 参数 : 图片转换后的目标宽度 ;
• int dstHeight 参数 : 图片转换后的目标高度 ;
• boolean filter 参数 : 设置缩放图像时是否使用双线性滤波 ; 如果设置成 true , 则使用双线性滤波 , 当缩放时图片质量更好 , 但是会降低性能 ; 如果设置成 false , 使用最近邻法进行尺寸缩放 , 图片质量差 , 但是速度很快 ; 推荐默认设置成 true , 双线性滤波开销很小 , 对于图像质量的改善效果显著 ;

③ 返回值 : 返回新的被缩放好的 Bitmap 位图 , 如果缩放失败 , 返回源图 ;

    /**
     * 创建一个新的 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);
    }