zoukankan      html  css  js  c++  java

  • TJpgDec—轻量级JPEG解码器

    TJpgDec—轻量级JPEG解码器

    本文由乌合之众lym瞎编，欢迎转载blog.cnblogs.net/oloroso
    下文中解码一词皆由decompression/decompress翻译而来。

    TJpgDec是一个为小型嵌入式系统高度优化的创建JPEG图像的解码模块。它工作时占用的内存非常低，以便它可以集成到微控芯片,如AVR, 8051, PIC, Z80, Cortex-M0等。

    特性

    • 平台独立。使用ANSI-C编写
    • 易于使用的主操作模式
    • 完全可重入的体系结构

      Very small memory footprint:

    • 非常小的内存占用

      独立于图像尺寸的3K工作内存。
      3.5-8.5KB的文本和常数ROM.

    • 输出格式:

      缩放比例:1/1、1/2、1/4或1/8可选。
      像素格式:RGB888或RGB565预配置。

    API接口

    有两个函数用于分析和解码JPEG图像。

    jd_prepare

    jd_prepare - 准备解码JPEG图像

    jd_prepare分析JPEG数据并创建一个解码对象(decompression object)用于随后的解码过程。

    JRESULT jd_prepare (
			JDEC* jdec,            /* Pointer to blank decompression object */
			UINT(*infunc)(JDEC*,BYTE*,UINT), /* Pointer to input function */
			void* work,            /* Pointer to work area */
			UINT sz_work,          /* Size of the work area */
			void* device           /* Device identifier for the session */
			);

    参数

    • jdec

      指定解码对象去初始化。这个解码对象是用于后续的解码操作。

    • input

      指定用户定义的数据输入函数。jd_prepare和jd_decomp调用这个函数来从输入流读取JPEG数据.

    • work

      指向此会话工作区域的指针。它应该与word边界对齐或者它可以导致一个异常。

    • sz_work

      指定工作区域的字节数。TJpgDec至多需要3092字节的工作区域，这依赖于JPEG图像的内置参数表。通常情况下是3092字节工作区域.

    • device

      指定用户定义的会话设备标识。它保存在解码对象的device成员中。它可以用于I/O函数去识别当前会话。当I/O device固定在project或者不需要这个功能，设置为NULL并忽略它。

    返回值

    • JDR_OK

      Function succeeded and decompression object is valid.
      函数执行成功，且编码对象是有效的。

    • JDR_INP

      An error occured in input function due to hard error or wrong stream termination.
      一个错误发生在input函数，由于硬件错误或者流终止。

    • JDR_MEM1

      Insufficient work area for this JPEG image.
      工作区域不足解码这个JPEG图像。

    • JDR_MEM2

      Insufficient input buffer for this JPEG image. JD_SZBUF may be too small.
      输入缓冲器不足读取这个JPEG图像，JD_SZBUF可能过小。

    • JDR_PAR

      Parameter error. Given pointer to the work area is NULL.
      参数错误。传入的工作区指针为NULL。

    • JDR_FMT1

      Data format error. The JPEG data can be collapted.
      数据格式错误。JPEG数据损坏。

    • JDR_FMT2

      Right format but not supported. May be a grayscale image.
      格式正确，但不支持。也许是一个灰度图像。

    • JDR_FMT3

      Not supported JPEG standard. May be a progressive JPEG image.
      不支持JPEG标准，也许是一个先进的JPEG图像。

    描述

    jd_prepare函数是JPEG解码会话的第一阶段。它分析JPEG图像和创建解码参数表。函数成功后，会话准备好在jd_decomp函数解码JPEG图像。应用程序可以参考JPEG解码对象中存储的尺寸大小。这个信息将用于在后续的解码阶段配置输出设备(device)和参数。

    jd_decomp

    jd_decomp - 执行解码JPEG图像

    jd_decomp函数解码JPEG图像并输出RGB数据。

    JRESULT jd_decomp (
			JDEC* jdec,             /* Pointer to valid decompressor object */
			UINT(*outfunc)(JDEC*,void*,JRECT*), /* Pointer to output function */
			BYTE scale              /* Scaling factor */
			);

    参数

    • jdec

      指定有效的解码对象。

    • outfunc

      指定用户定义的输出函数。jd_decomp调用这个函数去输出解码JPEG图像的RGB形式。

    • scale

      指定输出比例因子N。输出图像的缩小比例为1/2^N(N = 0 to 3)。当缩放功能禁用时(JD_USE_SCALE == 0)，它必须是0.

    返回值

    • JDR_OK

      Function succeeded.
      函数执行成功。

    • JDR_INTR
      The decompression process is interrupted by output function.

      解码过程在输出函数中断。

    • JDR_INP

      An error occured in input function due to hard error or wrong stream termination.
      一个错误发生在input函数，由于硬件错误或者流终止。

    • JDR_PAR

      Parameter error. Given scale factor is invalid.
      参数错误。给定的缩放值无效。

    • JDR_FMT1

      Data format error. The JPEG data can be collapted.
      数据格式错误。JPEG数据损坏。

    描述

    jd_decomp是JPEG解码会话的第二阶段。它解码JPEG图像并通过用户定义的输出函数输出数据，在它之后，解码对象将不在有效。

    在解码时指定的比例因子，它将JPEG图像按1/2、1/4或1/8比例缩放尺寸。例如，当解码一个1024x768大小JPEG图像在1/4比例，它将输出256x192大小。相比不缩放，1/2和1/4的缩放由于求均值，解码速度略有下降。但是1/8缩放相比不缩放是2-3倍的速度输出，因为每个块IDCT和求均值可以跳过。这一特点适合创建缩略图。

    I/O函数

    输入JPEG数据并输出解码后像素，TJpgDec需要用户定义两个I/O函数

    Input Function

    Input funciotn - 从输入流读取JPEG数据

    用户定义的从输入流读取数据的输入函数。

    UINT in_func (
			JDEC* jdec,    /* Pointer to the decompression object */
			BYTE* buff,    /* Pointer to buffer to store the read data */
			UINT ndata     /* Number of bytes to read */
			);

    参数

    • jdec

      指定解码会话的解码对象。

    • buff

      指定读缓冲器去保存读取数据。传入NULL将数据从输入流移除。

    • ndata

      指定从输入流读取或移除的字节数。

    返回值

    返回读取或移除的字节数。若返回0，jd_prepare和jd_decomp函数将终止并返回JDR_INP。

    描述

    这个函数是TJpgDec模块的数据输入接口。可以通过指向设备标识符的指针来标识相应的解码会话。

    Output Function

    Output function - 写像素数据到输出设备

    用户定义的输出函数，写解码像素到输出设备。

    UINT out_func (
			JDEC* jdec,    /* Pointer to the decompression object */
			void* bitmap,  /* RGB bitmap to be output */
			JRECT* rect    /* Rectangular region to output */
			);

    参数

    • jdec

      指定会话的解码对象。

    • bitmap

      指定RGB位图(bitmap)用于输出。

    • rect

      指定在图像中的矩形区域去输出RGB位图。

    返回值

    通常返回1，以便TJpgDec继续解码过程。当它返回0，jd_decomp函数终止并返回JDR_INTR，这在中断减压过程中有用。

    描述

    这个函数是TJpgDec模块的数据输出函数。可以通过指向设备标识符的指针来标识相应的解码会话，jdec->device通过jd_prepare函数第五个参数确定。

    在这个函数中，位图发送到帧缓冲或显示设备。第一个像素是位图矩形的左上角位置，最后一个像素是右下角位置。矩形的大小从1x1到16x16取决于图像的裁剪、缩放和采样因子。如果矩形是帧缓冲区，它将在函数中倍裁剪。
    像素格式取决于JD_FORMAT参数的配置选项。当它配置为RGB888，位图是一个字节数组，每3个字节保存一个RGB像素：RRRRRRRR, GGGGGGGG, BBBBBBBB, RRRRRRRR, GGGGGGGG, BBBBBBBB, ...；配置为RGB565时，位图是一个WORD数组，RGB数据1word每像素：RRRRRGGGGGGBBBBB, RRRRRGGGGGGBBBBB, RRRRRGGGGGGBBBBB, ...。

    资源

    TJpgDec是一个免费软件，对教育、研究和开发开发。你可以使用、修改和重新分发它，对个人项目或商业产品没有任何限制和责任。
  • 相关阅读:
    第06组Alpha冲刺(4/6)
    第06组Alpha冲刺(3/6)
    第06组Alpha冲刺(2/6)
    第06组 Alpha冲刺 (1/6)
    08-js函数
    07-数组
    06-js分支
    05-js运算符
    04-js变量
    03-css3D转换
  • 原文地址：https://www.cnblogs.com/oloroso/p/5851505.html
Copyright © 2011-2022 走看看