文章目录







一、解码图片参数 inJustDecodeBounds


​1 . 解码图片参数 :​



​① 设置获取参数解码选项 :​ 设置解码时的 BitmapFactory.Options 对象的 inJustDecodeBounds 为 true ,

​② 解码图像 :​ 解析器返回的 Bitmap 对象为 null ;

​③ 解码选项 :​ BitmapFactory.Options 中的 outXxx 字段会被设置对应的图片属性值 ;

​④ 解码选项参数示例 :​ 如 : outWidth 输出图像的 宽度 , outHeight 输出高度 , outMimeType 输出类型 , outConfig 像素格式 , outColorSpace 输出颜色空间 ;



​2 . 代码示例 :​

// Bitmap 图片加载选项
BitmapFactory.Options options = new BitmapFactory.Options();
options.inJustDecodeBounds = true;
BitmapFactory.decodeResource(resources, iamgeResId, options);






二、计算图片的缩小比例


​计算图片的缩小比例 :​



​① 目标图片宽高要求 :​ 宽度和高度只要存在一个大于限定的最大值时 , 就进行缩小操作 ; 要求指定的图片必须能放到 maxBitmapWidth 宽度 , maxBitmapHeight 高度的矩形框中 ; 最终要求就是 宽度必须小于 maxBitmapWidth, 同时高度也要小于 maxBitmapHeight ;

​② 缩小倍数要求 :​ 缩小倍数只能是 2 的幂次方值 , 1 , 2 , 4 , 8 , 16 , 32 , 64 ;

/*
            计算缩小的比例
            宽度和高度只要存在一个大于限定的最大值时 , 就进行缩小操作
            要求指定的图片必须能放到 maxBitmapWidth 宽度 , maxBitmapHeight 高度的矩形框中
            最终要求就是 宽度必须小于 maxBitmapWidth, 同时高度也要小于 maxBitmapHeight
         */
        if(imageWidth > maxBitmapWidth || imageHeight > maxBitmapHeight){
            // 如果需要启动缩小功能 , 那么进入如下循环 , 试探最小的缩放比例是多少
            while ( imageWidth / inSampleSize > maxBitmapWidth ||
                    imageHeight / inSampleSize > maxBitmapHeight ){
                // 注意该值必须是 2 的幂次方值 , 1 , 2 , 4 , 8 , 16 , 32 , 64
                inSampleSize = inSampleSize * 2;
            }

            // 执行到此处 , 说明已经找到了最小的缩放比例 , 打印下最小比例
            Log.w(TAG, "getResizedBitmap inSampleSize=" + inSampleSize);
        }






三、设置图片缩小配置 inSampleSize


​1 . 图片缩小配置 inSampleSize :​



​① inSampleSize 设置大于 1 :​ 如果值大于 1 , 那么就会缩小图片 ;

​② 解码器操作 :​ 此时解码器对原始的图片数据进行子采样 , 返回较小的 Bitmap 对象 ;

​③ 样本个数 :​ 样本的大小是在两个维度计算的像素个数 , 每个像素对应一个解码后的图片中的单独的像素点 ;

​④ 样本个数计算示例 :​ 如果 inSampleSize 值为 2 , 那么宽度的像素个数会缩小 2 倍 , 高度也会缩小两倍 ; 整体像素个数缩小 4 倍 , 内存也缩小了 4 倍 ;




​2 . inSampleSize 取值要求 :​



​① 小于 1 取值 :​ 如果取值小于 1 , 那么就会被当做 1 , 1 相当于 2 的 0 次方 ;

​② 取值要求 :​ 该值必须是 2 的幂次方值 , 2 的次方值 , 如 1 , 2 , 4 , 8 , 16 , 32

​③ 不合法值 :​ 如果出现了不合法的值 , 就会就近四舍五入到最近的 2 的幂次方值




​3 . 代码示例 :​

BitmapFactory.Options options = new BitmapFactory.Options();
// ... 
options.inSampleSize = inSampleSize;






四、设置图片像素格式 inPreferredConfig


​1 . 解码像素格式 :​



​① 指定配置解码 :​ 如果配置为非空 , 解码器会将 Bitmap 的像素解码成该指定的非空像素格式 ;

​② 自动匹配配置解码 :​ 如果该配置为空 , 或者像素配置无法满足 , 解码器会尝试根据系统的屏幕深度 , 源图像的特点 , 选择合适的像素格式 ; 如果源图像有透明度通道 , 那么自动匹配的默认配置也有对应通道 ;

​③ 默认配置 :​ 默认使用 ARGB_8888 进行解码



​2 . 代码示例 :​

options.inPreferredConfig = Bitmap.Config.RGB_565;






五、设置图片复用机制


​1 . 图片复用机制 :​



​① 图片复用 :​ 如果设置了一个 Bitmap 对象给 inBitmap 参数 , 解码方法会获取该 Bitmap 对象 , 当加载图片内容时 , 会尝试复用该 Bitmap 对象的内存

​② 无法复用抛出异常 :​ 如果解码方法无法复用该 Bitmap 对象 , 解码方法可能会抛出 IllegalArgumentException 异常 ;

​③ 图片可变性 :​ 当前的实现是很有必要的 , 被复用的图片必须是可变的 , 解码后的 Bitmap 对象也是可变的 , 即使当解码一个资源图片时 , 经常会得到一个不可变的 Bitmap 对象 ;




​2 . 解码结果判定 :​



​① 解码可能失败 :​ 该解码方法返回的 Bitmap 对象是可以使用的 , 鉴于上述约束情况 和 可能发生的失败故障 , 不能假定该图片解码操作是成功的 ;

​② 检查复用是否成功 :​ 解码检查解码返回的 Bitmap 对象是否与设置给 Options 对象的 inBitmap 相匹配 , 来判断该 inBitmap 是否被复用 ;

​③ 后续操作 :​ 不管有没有复用成功 , 你应该使用解码函数返回的 Bitmap 对象 , 保证程序的正常运行 ;




​3 . 与 BitmapFactory 配合使用 :​



​① Android 4.4 以后的复用机制 :​ 在 KITKAT 以后的代码中 , 只要被解码生成的 Bitmap 对象的字节大小 ( 缩放后的 ) , 小于等于 inBitmap 的字节大小 , 就可以复用成功 ;

​② Android 4.4 之前的复用机制 :​ 在 KITKAT ( Android 4.4 系统 , android-19 平台 ) 之前的代码中 , 被解码的图像必须是


  • JPEG 或 PNG 格式 ,
  • 并且 图像大小必须是相等的 ,
  • inssampleSize 设置为 1 ,

才能复用成功 , 另外被复用的图像的 像素格式 Config ( 如 RGB_565 ) 会覆盖设置的 inPreferredConfig 参数




​4 . 代码示例 :​

options.inBitmap = inBitmap;






六、Bitmap 图像尺寸缩小代码示例




1、图片缩小工具类



​图片缩小工具类 :​

package kim.hsl.bm.utils;

import android.content.Context;
import android.content.res.Resources;
import android.graphics.Bitmap;
import android.graphics.BitmapFactory;
import android.util.Log;

/**
 * Bitmap 尺寸缩小
 */
public class BitmapSizeReduce {
    private static final String TAG = "BitmapSizeReduce";

    /**
     * 获取指定尺寸于鏊求的 Bitmap 对象
     * 该方法有缺陷 , 计算值的时候没有考虑像素密度
     * 如果从不同像素密度的资源文件中加载
     * 可能计算出的值与指定的 maxBitmapWidth maxBitmapHeight 略有出入
     *
     * @param context           上下文对象
     * @param iamgeResId        要解析的图片资源 id
     * @param maxBitmapWidth    Bitmap 的最大宽度
     * @param maxBitmapHeight   Bitmap 的最大高度
     * @param hasAlphaChannel   是否包含 ALPHA 通道, 即透明度信息
     * @param inBitmap          复用的 Bitmap, 将新的 Bitmap 对象解析到该 Bitmap 内存中
     * @return  返回新的 Bitmap 对象
     */
    public static Bitmap getResizedBitmap(Context context,
                                          int iamgeResId, int maxBitmapWidth, int maxBitmapHeight,
                                          boolean hasAlphaChannel, Bitmap inBitmap){

        // 0. 声明方法中使用的局部变量

        // 用于解析资源
        Resources resources = context.getResources();
        // Bitmap 图片加载选项
        BitmapFactory.Options options = new BitmapFactory.Options();
        // 图片宽度
        int imageWidth;
        // 图片高度
        int imageHeight;
        /*
            根据 图片宽度 imageWidth , 图片高度 imageHeight ,
            最大宽度 maxBitmapWidth , 最大高度 maxBitmapHeight ,
            计算出的图片缩放系数 , 该值最终要设置到 BitmapFactory.Options 对象中
         */
        int inSampleSize = 1;

        // 1. 解析图片参数 : 该阶段不解析所有的数据 , 否则会将实际的图片数据解析到内存中 , 这里只解析图片的宽高信息

        /*
            设置 inJustDecodeBounds 为 true , 解析器会返回 null
            但是 outXxx 字段会被设置对应的图片属性值 ,
            如 : outWidth 输出图像的 宽度 , outHeight 输出高度 , outMimeType 输出类型 ,
            outConfig 像素格式 , outColorSpace 输出颜色空间
         */
        options.inJustDecodeBounds = true;

        /*
            由于设置了 inJustDecodeBounds = true , 该方法返回值为空 ;
            但是传入的 BitmapFactory.Options 对象中的 outXxx 字段都会被赋值 ;
            如 outWidth , outHeight , outConfig , outColorSpace 等 ;
            可以获取该图片的宽高 , 像素格式 , 颜色空间等信息
         */
        BitmapFactory.decodeResource(resources, iamgeResId, options);

        // 获取 iamgeResId 图片资源对应的图片宽度
        imageWidth = options.outWidth;
        // 获取 iamgeResId 图片资源对应的图片高度
        imageHeight = options.outHeight;


        // 2. 计算图片缩小比例

        /*
            计算缩小的比例
            宽度和高度只要存在一个大于限定的最大值时 , 就进行缩小操作
            要求指定的图片必须能放到 maxBitmapWidth 宽度 , maxBitmapHeight 高度的矩形框中
            最终要求就是 宽度必须小于 maxBitmapWidth, 同时高度也要小于 maxBitmapHeight
         */
        if(imageWidth > maxBitmapWidth || imageHeight > maxBitmapHeight){
            // 如果需要启动缩小功能 , 那么进入如下循环 , 试探最小的缩放比例是多少
            while ( imageWidth / inSampleSize > maxBitmapWidth ||
                    imageHeight / inSampleSize > maxBitmapHeight ){
                // 注意该值必须是 2 的幂次方值 , 1 , 2 , 4 , 8 , 16 , 32 , 64
                inSampleSize = inSampleSize * 2;
            }

            // 执行到此处 , 说明已经找到了最小的缩放比例 , 打印下最小比例
            Log.w(TAG, "getResizedBitmap inSampleSize=" + inSampleSize);
        }


        // 3. 设置图像解码参数

        /*
            inSampleSize 设置大于 1 : 如果值大于 1 , 那么就会缩小图片 ;
            解码器操作 : 此时解码器对原始的图片数据进行子采样 , 返回较小的 Bitmap 对象 ;

            样本个数 : 样本的大小是在两个维度计算的像素个数 , 每个像素对应一个解码后的图片中的单独的像素点 ;
            样本个数计算示例 :
            如果 inSampleSize 值为 2 , 那么宽度的像素个数会缩小 2 倍 , 高度也会缩小两倍 ;
            整体像素个数缩小 4 倍 , 内存也缩小了 4 倍 ;

            小于 1 取值 : 如果取值小于 1 , 那么就会被当做 1 , 1 相当于 2 的 0 次方 ;
            取值要求 : 该值必须是 2 的幂次方值 , 2 的次方值 , 如 1 , 2 , 4 , 8 , 16 , 32
            如果出现了不合法的值 , 就会就近四舍五入到最近的 2 的幂次方值
         */
        options.inSampleSize = inSampleSize;

        // 用户设置的是否保留透明度选项 , 如果不保留透明度选项 , 设置像素格式为 RGB_565
        // 每个像素占 2 字节内存
        if (!hasAlphaChannel){
            /*
                指定配置解码 : 如果配置为非空 , 解码器会将 Bitmap 的像素解码成该指定的非空像素格式 ;
                自动匹配配置解码 : 如果该配置为空 , 或者像素配置无法满足 , 解码器会尝试根据系统的屏幕深度 ,
                源图像的特点 , 选择合适的像素格式 ;
                如果源图像有透明度通道 , 那么自动匹配的默认配置也有对应通道 ;
                默认配置 : 默认使用 ARGB_8888 进行解码
             */
            options.inPreferredConfig = Bitmap.Config.RGB_565;
        }

        /*
            注意解码真实图像的时候 , 要将 inJustDecodeBounds 设置为 false
            否则将不会解码 Bitmap 数据 , 只会将
            outWidth , outHeight , outConfig , outColorSpace 等 outXxx 图片参数解码出来
         */
        options.inJustDecodeBounds = false;

        /*
            设置图片可以被复用
         */
        options.inMutable = true;

        /*
            如果设置了一个 Bitmap 对象给 inBitmap 参数
            解码方法会获取该 Bitmap 对象 , 当加载图片内容时 , 会尝试复用该 Bitmap 对象的内存

            如果解码方法无法复用该 Bitmap 对象 , 解码方法可能会抛出 IllegalArgumentException 异常 ;
            当前的实现是很有必要的 , 被复用的图片必须是可变的 , 解码后的 Bitmap 对象也是可变的 ,
            即使当解码一个资源图片时 , 经常会得到一个不可变的 Bitmap 对象 ;

            确保是否解码成功 :
            该解码方法返回的 Bitmap 对象是可以使用的 ,
            鉴于上述约束情况 和 可能发生的失败故障 , 不能假定该图片解码操作是成功的 ;

            检查解码返回的 Bitmap 对象是否与设置给 Options 对象的 inBitmap 相匹配 ,
            来判断该 inBitmap 是否被复用 ;

            不管有没有复用成功 , 你应该使用解码函数返回的 Bitmap 对象 , 保证程序的正常运行 ;

            与 BitmapFactory 配合使用 :

            在 KITKAT 以后的代码中 , 只要被解码生成的 Bitmap 对象的字节大小 ( 缩放后的 )
            小于等于 inBitmap 的字节大小 , 就可以复用成功 ;

            在 KITKAT 之前的代码中 , 被解码的图像必须是
            JPEG 或 PNG 格式 ,
            并且 图像大小必须是相等的 ,
            inssampleSize 设置为 1 ,
            才能复用成功 ;
            另外被复用的图像的 像素格式 Config ( 如 RGB_565 ) 会覆盖设置的 inPreferredConfig 参数
         */
        options.inBitmap = inBitmap;


        // 4. 解码图片 , 并返回被解码的图片

        return BitmapFactory.decodeResource(resources, iamgeResId, options);
    }

}




2、Activity 调用工具类代码



​Activity 代码 :​

package kim.hsl.bm;

import androidx.appcompat.app.AppCompatActivity;

import android.graphics.Bitmap;
import android.graphics.BitmapFactory;
import android.os.Bundle;
import android.util.Log;
import android.widget.TextView;

import kim.hsl.bm.utils.BitmapSizeReduce;

public class MainActivity extends AppCompatActivity {

    static {
        System.loadLibrary("native-lib");
    }

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        TextView tv = findViewById(R.id.sample_text);
        tv.setText(stringFromJNI());

        // 缩小图像尺寸
        sizeReduce();


    }

    /**
     * 图像尺寸缩小
     */
    private void sizeReduce(){
        // 从资源文件中加载内存
        Bitmap bitmap = BitmapFactory.decodeResource(getResources(), R.drawable.blog);
        // 打印 Bitmap 对象的宽高, 字节大小
        Log.i("Bitmap", "blog : " + bitmap.getWidth() + " , " +
                bitmap.getHeight() + " , " +
                bitmap.getByteCount());

        // 从资源文件中加载内存
        Bitmap reduceSizeBitmap = BitmapSizeReduce.getResizedBitmap(this, R.drawable.blog,
                100, 100 , false , null);
        // 打印 Bitmap 对象的宽高, 字节大小
        Log.i("Bitmap", "reduceSizeBitmap : " + reduceSizeBitmap.getWidth() + " , " +
                reduceSizeBitmap.getHeight() + " , " +
                reduceSizeBitmap.getByteCount());
    }

    public native String stringFromJNI();
}




3、执行结果



​执行结果 :​

2020-06-30 22:04:22.959 3766-3766/? I/Bitmap: blog : 5224 , 2678 , 55959488
2020-06-30 22:04:22.960 3766-3766/? W/BitmapSizeReduce: getResizedBitmap inSampleSize=32
2020-06-30 22:04:22.980 3766-3766/? I/Bitmap: reduceSizeBitmap : 163 , 81 , 26406



​分析结果 :​

​① 源图像分析 :​ 从资源中加载 , 普通情况下宽度 5224 像素 , 高度 2678 像素 , ARGB_8888 像素格式 , 每个像素 4 4 4 字节 , 计算公式为

5224 × 2678 × 4 = 55 , 959 , 488 5224 \times 2678 \times 4 = 55,959,488 5224×2678×4=55,959,488



​② 缩小后的图像分析 :​ 从资源中加载 , 普通情况下宽度 163 像素 , 高度 81 像素 , RGB_565 像素格式 , 每个像素 2 2 2 字节 , 计算公式为

163 × 81 × 2 = 26 , 406 ‬ 163 \times 81 \times 2 = 26,406‬ 163×81×2=26,406‬