BitmapFactory.Options中的inDensity,inTargetDensity,inScreenDensity详解

我们来看下这三个值的初始值分别是什么

inTargetDensity

通过搜索,这个值只在decodeResourceStream方法中进行了赋值操作

......
  if (opts.inTargetDensity == 0 && res != null) {
            opts.inTargetDensity = res.getDisplayMetrics().densityDpi;
        }
......

从代码中可以看出,inTargetDensity的取值是获取当前手机的densityDpi,即当前的手机运行环境的手机密度

inScreenDensity

搜索整个BitmapFactory的所有代码,发现这个变量并没有赋值的地方,只有一个使用的地方setDensityFromOptions

 private static void setDensityFromOptions(Bitmap outputBitmap, Options opts) {
        if (outputBitmap == null || opts == null) return;

        final int density = opts.inDensity;
        if (density != 0) {
            outputBitmap.setDensity(density);
            final int targetDensity = opts.inTargetDensity;
           //对desity和targetDensity进行比较
            if (targetDensity == 0 || density == targetDensity || density == opts.inScreenDensity) {
                return;
            }

            byte[] np = outputBitmap.getNinePatchChunk();
            final boolean isNinePatch = np != null && NinePatch.isNinePatchChunk(np);
            if (opts.inScaled || isNinePatch) {
                outputBitmap.setDensity(targetDensity);
            }
        } else if (opts.inBitmap != null) {
            // bitmap was reused, ensure density is reset
            outputBitmap.setDensity(Bitmap.getDefaultDensity());
        }
    }

从而,我们可以知道,这个值默认的情况下一直是0。

inDensity

同样的,搜索BitmapFactory的源码,可以搜索到赋值的地方是:

 public static Bitmap decodeResourceStream(Resources res, TypedValue value,
            InputStream is, Rect pad, Options opts) {
      ......
        if (opts.inDensity == 0 && value != null) {
            final int density = value.density;
            if (density == TypedValue.DENSITY_DEFAULT) {
                opts.inDensity = DisplayMetrics.DENSITY_DEFAULT;
            } else if (density != TypedValue.DENSITY_NONE) {
                opts.inDensity = density;
            }
        }
        ......
        return decodeStream(is, pad, opts);
    }

这个方法是在decodeResource中调用

    public static Bitmap decodeResource(Resources res, int id, Options opts) {
            ......
            final TypedValue value = new TypedValue();
            //通过资源的id去加载图片资源的信息,并保存在TypedValue中
            is = res.openRawResource(id, value);

            bm = decodeResourceStream(res, value, is, null, opts);
            .....
    }

这里代码其实就是分为两步:

  1. 通过资源的id去加载合适的资源,并把一些参数保存在TypedValue对象中,如图片的对应文件夹的density
  2. 通过第1步拿到资源流,去读取我们需要的图片

从上面的代码可以看到density的值是把从资源中读取的density赋值给它,其实就是我们的图片资源所在drawable对应的density,也就是下面表格的对应的值:


image.png

三个值的作用

从上面的赋值中,我们知道了这三个变量表示的意思,那么我们来看看这个三个变量是怎么使用的。

public final int getByteCount() {
    return getRowBytes() * getHeight();
}
public final int getRowBytes() {
    ......
    return nativeRowBytes(mNativePtr);
}

翻阅nativeRowBytes这个native的源码,可以知道一个bitmap对象在运行时所占内存大小是:bitmap占用的宽 * bitmap占用的高*每个像素占用的字节,那么这里的宽高又是什么呢?图片的宽高吗?我们来看下decodeResourceStream方法的源码:

  public static Bitmap decodeResourceStream(Resources res, TypedValue value,
            InputStream is, Rect pad, Options opts) {
        validate(opts);
        if (opts == null) {
            opts = new Options();
        }

        if (opts.inDensity == 0 && value != null) {
            final int density = value.density;
            if (density == TypedValue.DENSITY_DEFAULT) {
                opts.inDensity = DisplayMetrics.DENSITY_DEFAULT;
            } else if (density != TypedValue.DENSITY_NONE) {
                opts.inDensity = density;
            }
        }
        
        if (opts.inTargetDensity == 0 && res != null) {
            opts.inTargetDensity = res.getDisplayMetrics().densityDpi;
        }
        
        return decodeStream(is, pad, opts);
    }
    public static Bitmap decodeStream(InputStream is, Rect outPadding, Options opts) {
        ......
        Bitmap bm = null;

        Trace.traceBegin(Trace.TRACE_TAG_GRAPHICS, "decodeBitmap");
        try {
            if (is instanceof AssetManager.AssetInputStream) {
                final long asset = ((AssetManager.AssetInputStream) is).getNativeAsset();
                bm = nativeDecodeAsset(asset, outPadding, opts);
            } else {
                bm = decodeStreamInternal(is, outPadding, opts);
            }
         ......
        return bm;
    }

调用nativeDecodeAsset或者decodeStreamInternal方法,这两个方法最终都会调用到BitmapFactory.cpp中的doDecode方法

static jobject doDecode(JNIEnv* env, SkStreamRewindable* stream, jobject padding,
        jobject options, bool allowPurgeable, bool forcePurgeable = false) {


    if (options != NULL) {

        if (env->GetBooleanField(options, gOptions_scaledFieldID)) {
            const int density = env->GetIntField(options, gOptions_densityFieldID);
            const int targetDensity = env->GetIntField(options, gOptions_targetDensityFieldID);
            const int screenDensity = env->GetIntField(options, gOptions_screenDensityFieldID);
             //代码1
            if (density != 0 && targetDensity != 0 && density != screenDensity) {
                scale = (float) targetDensity / density;
            }
        }
    }
    //代码2
    int scaledWidth = decodingBitmap.width();
    int scaledHeight = decodingBitmap.height();

    //代码3
    if (willScale && mode != SkImageDecoder::kDecodeBounds_Mode) {
        scaledWidth = int(scaledWidth * scale + 0.5f);
        scaledHeight = int(scaledHeight * scale + 0.5f);
    }

    // update options (if any)
    if (options != NULL) {
        env->SetIntField(options, gOptions_widthFieldID, scaledWidth);
        env->SetIntField(options, gOptions_heightFieldID, scaledHeight);
        env->SetObjectField(options, gOptions_mimeFieldID,
                getMimeTypeString(env, decoder->getFormat()));
    }
}

从上面的代码中:
代码1处的代码:
根据density,targetDensity,screenDensity来计算缩放的比例scale,scale = (float) targetDensity / density
标志2处的代码:获取原始图片的原始宽高
标志3处的代码:根据上面计算的缩放比例scale,重新计算实际的宽高。那这个有什么作用呢?

总结:
这三个参数使用来计算bitmap对象的宽高的,总结来说一个bitmap的占用内存为:

bitmap的宽=原图片的宽 / inSampleSize * (inTargetDensity / inDensity+0.5f)
bitmap的高=原图片的高 / inSampleSize * (inTargetDensity / inDensity+0.5f)
bitmap所占内存的大小=bitmap的宽*bitmap的高*每个像素所占内存

推荐阅读更多精彩内容