官方文档 API : BitmapRegionDecoder
在【Android 内存优化】自定义组件长图组件 ( 自定义组件构造方法 ) 基础上继续开发 ;
显示的图像是一张长图 , 在该组件中 , 宽度肯定要完整显示出来 , 解码图片的不同高度的数据 ;
首先要测量图片数据的真实宽高 , 然后根据图像的宽高 , 与组件的宽高 , 以及要显示的图像位置 , 计算要解码的图像区域 ;
参考 【Android 内存优化】Bitmap 图像尺寸缩小 ( 设置 Options 参数 | inJustDecodeBounds | inSampleSize | 工具类实现 ) 一、解码图片参数 inJustDecodeBounds 章节内容 , 有图片解码的详细步骤 ;
1 . 图片尺寸数据解码 :
① 创建解码选项 : 创建 BitmapFactory.Options 对象 ;
② 设置解码尺寸数据 : 设置 BitmapFactory.Options 对象的 inJustDecodeBounds 为 true , 解码图像时 , 不解码图像数据 , 只获取图像的尺寸数据 ;
③ 解码图像尺寸数据 : 调用 BitmapFactory.decodeStream 方法 , 解码图片 , 图片相关的尺寸数据保存到了 mOptions 选项中 ;
④ 获取图片尺寸 : mOptions.outWidth 是解码出的图像宽度 , mOptions.outHeight 是解码出的图像高度 ;
2 . 代码示例 :
/**
* Bitmap 解码选项
*/
private BitmapFactory.Options mOptions;
/**
* 图片宽度
*/
private int mImageWidth;
/**
* 图片高度
*/
private int mImageHeight;
// ...
// 解码选项
mOptions = new BitmapFactory.Options();
// 读取图片的尺寸数据
mOptions.inJustDecodeBounds = true;
// 解码图片 , 图片相关的尺寸数据保存到了 mOptions 选项中
BitmapFactory.decodeStream(inputStream, null, mOptions);
// 获取图片宽高
mImageWidth = mOptions.outWidth;
mImageHeight = mOptions.outHeight;
1 . 显示区域计算原则 : 这是一张长图 , 宽度完全显示 , 高度显示部分 ; 根据组件的宽高计算图像显示的区域 , 组件的宽高已知 , 宽高比例确定 ; 该宽高比例下 , 图片显示的区域也必须是该比例 ;
2 . 图像宽高与组件宽高比例 : 加载的图像高度宽度 , 与组件的高度宽度比例一致 ;
3 . 缩放因子 : 由于宽度必须填充慢组件宽度 , 这里需要缩放图片 , 高分辨率手机需要缩小图片 , 低分辨率手机需要放大图片 ;
4 . 计算区域高度 : 图像截取的宽度已知 , 组件的宽高已知 , 计算图像截取的高度 :
5 . 代码示例 : 在 onMeasure 方法中 , 获取最新测量出来的组件宽高 , 根据以上公式 , 计算出要解码图像的宽高 ;
@Override
protected void onMeasure(int widthMeasureSpec, int heightMeasureSpec) {
super.onMeasure(widthMeasureSpec, heightMeasureSpec);
// 获取测量的自定义 View 组件宽高
mViewWidth = getMeasuredWidth();
mViewHeight = getMeasuredHeight();
// 根据组件的宽高 , 确定要加载的图像的宽高
if(mBitmapRegionDecoder != null){
mRect.left = 0;
mRect.top = 0;
// 绘制的宽度就是图像的宽度
mRect.right = mImageWidth;
// 根据图像宽度 和 组件宽度 , 计算出缩放比例
// 组件宽度 / 图像宽度 = 缩放因子
mScale = (float)mViewWidth / (float)mImageWidth;
/*
加载的图像高度宽度 , 与组件的高度宽度比例一致
mViewWidth / 加载的图像宽度 = mViewHeight / 加载的图像高度
此处加载的图像宽度就是实际的宽度
加载的图像高度 = mViewHeight / ( mViewWidth / 加载的图像宽度 )
mViewWidth / 加载的图像宽度 就是缩放因子
加载的图像高度 = mViewHeight / 缩放因子
*/
// 根据缩放因子计算解码高度
mRect.bottom = (int) (mViewHeight / mScale);
}
}
设置图像解码参数 :
① 关闭尺寸解码 : 之前解码图像尺寸 , 将 BitmapFactory.Options 的 inJustDecodeBounds 属性设置为了 true , 现在要开始解码图像数据了 , 需要关闭该选项 , 设置为 false ;
② 设置像素格式 : 如果不需要显示透明度 , 就设置 BitmapFactory.Options 的 inPreferredConfig 像素格式为 Bitmap.Config.RGB_565 , 该像素格式每个像素占 2 字节内存 ;
③ 设置可变 : 这是内存复用生效的前提 , 设置 inMutable 为 true ;
④ 设置复用内存的 Bitmap 对象 : 每次解码操作前都要设置一次 , 解码时会复用该 Bitmap 中的内存 ;
2 . 代码示例 :
/**
* Bitmap 解码选项
*/
private BitmapFactory.Options mOptions;
// ...
// 设置 Bitmap 内存复用
mOptions.inMutable = true; // 设置可变
// 内存复用
mOptions.inBitmap = mBitmap;
mOptions.inPreferredConfig = Bitmap.Config.RGB_565; // 设置像素格式 RGB 565
mOptions.inJustDecodeBounds = false; // 读取完毕之后, 就需要解析实际的 Bitmap 图像数据了
1 . 图像绘制 :
① 设置图像区域解码器 : 在为自定义组件设置图片时 , 设置区域解码器 , 因为要设置区域解码的数据源 , 因此必须在用户设置图片时 , 才可以创建区域解码器 ;
② 设置内存复用 : 每次解码时 , 都要设置一下内存复用的 Bitmap 对象 ; mOptions.inBitmap = mBitmap;
③ 解码图片 : 调用区域解码器的 mBitmapRegionDecoder.decodeRegion 方法 , 解码图片的特定区域 ;
④ 设置图片缩放 : 使用 Matrix 进行图像缩放 ; 图像与自定义组件的尺寸不同 , 因此需要将解码区域完全填充到自定义组件中显示 ;
⑤ 图像绘制 : 调用 canvas.drawBitmap 绘制图像 , 如果需要缩放 , 传入 Matrix 参数 ;
2 . 代码示例 :
/**
* 图像区域解码器
*/
private BitmapRegionDecoder mBitmapRegionDecoder;
// ...
/**
* 设置显示的图片
* @param inputStream
*/
public void setImage(InputStream inputStream){
// ...
try {
// Bitmap 区域解码器
mBitmapRegionDecoder = BitmapRegionDecoder.newInstance(inputStream, false);
} catch (IOException e) {
e.printStackTrace();
}
// 设置图片完毕后 , 刷新自定义组件
requestLayout();
}
// ...
@Override
protected void onDraw(Canvas canvas) {
super.onDraw(canvas);
if(mBitmapRegionDecoder == null) return;
// 内存复用
mOptions.inBitmap = mBitmap;
// 解码图片
mBitmap = mBitmapRegionDecoder.decodeRegion(mRect, mOptions);
// 设置绘制的图像缩放 , x 轴和 y 轴都在 Bitmap 大小的区域基础上 , 缩放 mScale 倍
Matrix matrix = new Matrix();
matrix.setScale(mScale, mScale);
canvas.drawBitmap(mBitmap, matrix, null);
}
竖屏效果 :
横屏效果 :
源码及资源下载地址 :