Android图片编码机制深度解析（Bitmap，Skia，libJpeg）

问题

工作中遇到了Android中有关图片压缩保存的问题，发现这个问题还挺深，而且网上资料比较有限，因此自己深入研究了一下，算是把这个问题自顶至下全部搞懂了，在此记录。

相关的几个问题如下：

1.Android系统是如何编码压缩保存图片的？

2.Skia库起到的作用？

3.libJpeg库起到的作用？

4.能不能自己调用Skia或libJpeg？

解答

一谈到Android上的图片压缩保存，基本都会想到android.graphics.Bitmap这个类，它提供了一个非常方便（事实上也只有这一个）的方法：

public boolean compress (Bitmap.CompressFormat format, int quality, OutputStream stream)

这个方法可以把当前的bitmap，根据参数提供的压缩格式（JPEG、PNG、WEBP）和压缩质量，将压缩好的数据输出到指定的输出流中。再跟进到这个函数中，发现如下代码，ok，又进入了神秘的native层，只能查看android的源码了

    public boolean compress(CompressFormat format, int quality, OutputStream stream) {
        checkRecycled("Can't compress a recycled bitmap");
        // do explicit check before calling the native method
        if (stream == null) {
            throw new NullPointerException();
        }
        if (quality < 0 || quality > 100) {
            throw new IllegalArgumentException("quality must be 0..100");
        }
        return nativeCompress(mNativeBitmap, format.nativeInt, quality,
                              stream, new byte[WORKING_COMPRESS_STORAGE]);
    }

在源码中的\frameworks\base\core\jni\android\graphics\Bitmap.cpp我发现了nativeCompress这个方法实际对应的C++函数，

static bool Bitmap_compress(JNIEnv* env, jobject clazz, SkBitmap* bitmap,int format, int quality,object jstream, jbyteArray jstorage) 

ok，这时大致可以回答第二个问题了——Skia库起到的作用。上层的compress函数其实最终调用的就是Skia的Bitmap_compress函数，java这层基本上啥也没做，99%的工作都是在native中调用skia库中的函数完成的。再解释一下这个函数的各个参数。其中，前两个参数是JNI函数必带的，bitmap是SkBitmap类型指针，在创建该Bitmap时分配。Format是压缩格式，有JPEG、PNG和WEBP三种。quality是压缩质量，0-100的整数。jstream是从java层传过来的输出流，用来将压缩好的图片数据输出，Jstorage是用于native层压缩类和输出流之间传递数据的。

接下来继续分析一下Bitmap_compress函数的内部,代码很好理解，而且大部分我都加了注释，

static bool Bitmap_compress(JNIEnv* env, jobject clazz, SkBitmap* bitmap,
                            int format, int quality,
                            jobject jstream, jbyteArray jstorage) {
    SkImageEncoder::Type fm;  //创建类型变量
    //将java层类型变量转换成Skia的类型变量
    switch (format) {
    case kJPEG_JavaEncodeFormat:
        fm = SkImageEncoder::kJPEG_Type;
        break;
    case kPNG_JavaEncodeFormat:
        fm = SkImageEncoder::kPNG_Type;
        break;
    case kWEBP_JavaEncodeFormat:
        fm = SkImageEncoder::kWEBP_Type;
        break;
    default:
        return false;
    }
    //判断当前bitmap指针是否为空
    bool success = false;
    if (NULL != bitmap) {
        SkAutoLockPixels alp(*bitmap);

        if (NULL == bitmap->getPixels()) {
            return false;
        }

    //创建SkWStream变量用于将压缩后的图片数据输出
        SkWStream* strm = CreateJavaOutputStreamAdaptor(env, jstream, jstorage);
        if (NULL == strm) {
            return false;
        }
    //根据编码类型，创建SkImageEncoder变量，并调用encodeStream对bitmap
    //指针指向的图片数据进行编码，完成后释放资源。
        SkImageEncoder* encoder = SkImageEncoder::Create(fm);
        if (NULL != encoder) {
            success = encoder->encodeStream(strm, *bitmap, quality);
            delete encoder;
        }
        delete strm;
    }
    return success;
}

如之前所说，该函数调用来skia的encodeStream函数来对图片进行压缩编码。接下来大致介绍一下skia库。

Skia 是一个 c++实现的代码库，在android 中以扩展库的形式存在，目录为external/skia/。总体来说skia是个相对简单的库，在android中提供了基本的画图和简单的编解码功能。另外，skia 同样可以挂接其他第3方编码解码库或者硬件编解码库，例如libpng和libjpeg。在Android中skia就是这么做的，\external\skia\src\images文件夹下面，有几个SkImageDecoder_xxx.cpp文件，他们都是继承自SkImageDecoder.cpp类，并利用第三方库对相应类型文件解码，最后再通过SkTRegistry注册，代码如下所示，

 static SkTRegistry<SkImageDecoder*, SkStream*> gDReg(sk_libjpeg_dfactory);
 static SkTRegistry<SkImageDecoder::Format, SkStream*> gFormatReg(get_format_jpeg);
 static SkTRegistry<SkImageEncoder*, SkImageEncoder::Type> gEReg(sk_libjpeg_efactory);

至此，第一个问题也得到了解答，Android编码保存图片就是通过Java层函数——Native层函数——Skia库函数——对应第三方库函数（例如libjpeg），这一层层调用做到的。Android真是做到了“善假于物也”。

接下来分析第三方库中究竟是如何对位图(Bitmap)编码。由于工作中只涉及到了jpeg编码，因此我仅研究了Android中libjpeg中的编码方式，以及和标准libjpeg的区别。在\external\jpeg文件夹下面是google用于编译libjpeg.so库的代码和配置文件。需要注意的是，这份代码和libjpeg提供的标准版6b版本（http://sourceforge.net/projects/libjpeg/files/libjpeg/6b/）是不同的。我大致比较过两份代码的区别：主要是Android版修改/添加了一些额外的支持，

1.Android版本修改了内存管理方式，使用自己的方式。

2.Android版添加了把压缩数据输出到输出流的支持。

接下来讲一下libjpeg压缩图片的流程，这部分网上的资料就非常多了，因为libjpeg是个跨平台的开源库，只要有代码，不仅在Android系统，其他系统上依然可以编译出库。整个流程非常简单，直接上代码和注释

    //声明一些在压缩时需要的变量，jerr用于错误控制
    struct jpeg_compress_struct cinfo;
    struct jpeg_error_mgr jerr;
    cinfo.err = jpeg_std_error(&jerr);
    jerr.output_message=android_output_message;  //使用自定义的日志输出函数，不是必须的
    jerr.error_exit=myjpeg_error_exit;  //使用自定义的错误退出函数，不是必须的
    jpeg_create_compress(&cinfo);  //创建libjpeg的压缩结构体    cinfo.image_width = width;  //设置被压缩图片的宽、高、通道数和色彩空间
    cinfo.image_height = height;
    cinfo.input_components = ;
    cinfo.in_color_space = JCS_RGB;
    FILE * outfile;  //创建文件变量用于指定压缩数据的输出目标
    if ((outfile = fopen(imgPath, "wb")) == NULL) {
        fprintf(stderr, "can't open %s\n", imgPath);
        exit();
    }
    jpeg_set_defaults(&cinfo);  //对cinfo做一些默认设置
    jpeg_stdio_dest(&cinfo, outfile);  //将之前的outfile作为输出目标
    jpeg_set_quality(&cinfo,quality,TRUE);  //设置压缩jpeg图片的质量
    jpeg_start_compress(&cinfo, TRUE);  //开始压缩
    unsigned char * srcImg=(unsigned char *)imageData;  //逐行的获取图像数据，进行压缩处理
    while (cinfo.next_scanline < cinfo.image_height) {
        JSAMPROW row_pointer[];    /* pointer to JSAMPLE row[s] */
        row_pointer[] = srcImg;
        (void) jpeg_write_scanlines(&cinfo, row_pointer, );
        srcImg+=widthStep;
    }
//压缩保存完毕，对使用到的变量进行销毁
    jpeg_finish_compress(&cinfo);
    jpeg_destroy_compress(&cinfo);

至此，第三个问题也可以回答了，真正干活（对图像进行编码压缩）的才是libjpeg。

最后，说一下最后一个问题。理论上，是可以自己调用skia和libjpeg库函数的。有两种方式，一种是通过自己获取源代码，编译出自己的skia或libjpeg库，然后使用。这种做法也是网上写的最多的，优点是自己可以随意改代码，想怎么编码怎么编码，灵活度比较大，缺点就是最后生成的动态链接库会比较大。第二种方法是通过调用系统自带的动态链接库来使用库函数，优点是只需要在编译自己的动态库时包括进头文件即可，最终生成的库很小，缺点是灵活度较低，而且skia和libjpeg随着Android版本和生产商不同，版本也会改变，容易出现链接失败，即调用库函数失败。具体怎么用完全看自己的需求了。自己编译skia和lijpeg的网上例子很多也很容易做，在此不做介绍了。我介绍一下如何使用系统的动态链接库，

1.下载一份android系统的源码，把\external\jpeg下的.h头文件都复制到一个目录下，我为了方便，直接放在了工程的jni目录下，注意不能用libjpeg官网上面的头文件，因为版本可能对不上。

2.编写Android.mk文件，需要注意的是LOCAL_LDLIBS :=里面一定要加上-ljpeg，下面是我的mk文件，一些编译选项都是摘抄Android源码里面的

LOCAL_PATH := $(call my-dir)

include $(CLEAR_VARS)
LOCAL_MODULE    := AndroidJpegTest
LOCAL_SRC_FILES := AndroidJpegTest.cpp
LOCAL_LDLIBS :=-llog -ljpeg -ljnigraphics
LOCAL_C_INCLUDES := $(LOCAL_PATH)
LOCAL_CFLAGS += -O3 -fstrict-aliasing -fprefetch-loop-arrays
LOCAL_CFLAGS += -DUSE_ANDROID_ASHMEM
LOCAL_CFLAGS += -DAVOID_TABLES
LOCAL_CFLAGS += -DANDROID_TILE_BASED_DECODE
LOCAL_SDK_VERSION := 

include $(BUILD_SHARED_LIBRARY)

3.编写自己的测试cpp文件，基本按照上面将的libjpeg使用流程调用即可，需要注意的是libjpeg接受的输入色彩空间没有RGBA，因此需要自己把bitmap的RGBA转换成RGB，Skia里面是直接从RGBA转成YUV的。我的测试代码如下，功能很简单，接收一个bitmap、一个保存路径和一个质量因子，按照要求把bitmap保存成jpg图片。

#ifdef __cplusplus
extern "C" {
#endif

#include <jni.h>
#include <stdio.h>
#include <stdlib.h>
#include<android/bitmap.h>
#include<android/log.h>
#include"jpeglib.h"

#define TAG "JPEGTEST"
#define LOGI(...) __android_log_print(ANDROID_LOG_INFO,TAG,__VA_ARGS__)

static void myjpeg_error_exit(j_common_ptr jcs)
{
    jpeg_error_mgr* error = (jpeg_error_mgr*)jcs->err;
    (*error->output_message) (jcs);
    jpeg_destroy(jcs);
    exit(EXIT_FAILURE);
}

static void android_output_message(j_common_ptr cinfo) {
    char buffer[];
    /* Create the message */
    (*cinfo->err->format_message)(cinfo, buffer);
    LOGI("%s", buffer);
}

JNIEXPORT jint Java_com_example_yuvconv_NativeFunc_convert
  (JNIEnv *env, jclass thiz, jobject bmpObj,jstring filepath,jint quality)
{
    const char *imgPath = env->GetStringUTFChars(filepath, );
    AndroidBitmapInfo bmpinfo = {};
    if (AndroidBitmap_getInfo(env, bmpObj, &bmpinfo) < )
    {
        LOGI("read failed");
        return JNI_FALSE;
    }

    int width = bmpinfo.width;
    int height =bmpinfo.height;
    int widthStep = (width*+)/*;
    if(bmpinfo.width <=  || bmpinfo.height <=  ||
       bmpinfo.format != ANDROID_BITMAP_FORMAT_RGBA_8888)
    {
        LOGI("format error");
        return JNI_FALSE;
    }
    void* bmpFromJObject = NULL;
    if (AndroidBitmap_lockPixels(env,bmpObj,(void**)&bmpFromJObject) < )
    {
        LOGI("lockPixels failed");
        return JNI_FALSE;
    }
    unsigned char*imageData= (unsigned char*)malloc(sizeof(unsigned char)*(width*+)/**height);
    unsigned char* pBuff = (unsigned char*)bmpFromJObject;
    unsigned char* pImgData = imageData;
    for (int y = ; y < height; y++)
    {
        unsigned char* p1 = pImgData;
        unsigned char* p2 = pBuff;
        for (int x = ; x < width; x++)
        {
            p1[] = p2[];    //R
            p1[] = p2[];    //G
            p1[] = p2[];    //B
            p1 += ;
            p2 += ;
        }
        pImgData +=widthStep;
        pBuff += bmpinfo.stride;
    }
    struct jpeg_compress_struct cinfo;
    struct jpeg_error_mgr jerr;
    cinfo.err = jpeg_std_error(&jerr);
    jerr.output_message=android_output_message;
    jerr.error_exit=myjpeg_error_exit;
    jpeg_create_compress(&cinfo);

    cinfo.image_width = width;
    cinfo.image_height = height;
    cinfo.input_components = ;
    cinfo.in_color_space = JCS_RGB;

    FILE * outfile;
    if ((outfile = fopen(imgPath, "wb")) == NULL) {
        fprintf(stderr, "can't open %s\n", imgPath);
        return JNI_FALSE;
    }

    jpeg_set_defaults(&cinfo);
    jpeg_stdio_dest(&cinfo, outfile);
    jpeg_set_quality(&cinfo,quality,TRUE);

    jpeg_start_compress(&cinfo, TRUE);
    unsigned char * srcImg=(unsigned char *)imageData;
    while (cinfo.next_scanline < cinfo.image_height) {
        JSAMPROW row_pointer[];    /* pointer to JSAMPLE row[s] */
        row_pointer[] = srcImg;
        (void) jpeg_write_scanlines(&cinfo, row_pointer, );
        srcImg+=widthStep;
    }
    jpeg_finish_compress(&cinfo);
    jpeg_destroy_compress(&cinfo);
    env->ReleaseStringUTFChars(filepath, imgPath);
    return JNI_TRUE;
}

#ifdef __cplusplus
}
#endif

4.编译的时候，会发现提示找不到libjpeg.so库，找一部手机，从system/lib下面把libjpeg.so抓出来，然后放在编译提示找不到库的那个目录下，我的目录是\android-ndk-r10d\toolchains\arm-linux-androideabi-4.8\prebuilt\windows-x86_64\lib\gcc\arm-linux-androideabi\4.8

5.重新编译，大功告成！把java的调用部分写好测试一下，没问题就ok了。可以看到，这样生成的so库只有10k多，比用libjpeg源码编译的几百k的库小很多。

调用系统的skia库也是类似的过程，不过skia变动的比较频繁，不建议这么使用，如果有需要还是用源码编译自己的libskia比较好。

参考文献

skia 文档：http://chromium-skia-gm.commondatastorage.googleapis.com/doxygen/doxygen/html/index.html

skia 源码解析 http://www.eoeandroid.com/thread-27841-1-1.html

使用系统自带libjpeg时问题 http://stackoverflow.com/questions/5208817/failing-to-link-against-libjpeg-so-in-jni-ndk-shared-library