TjpgDec技术手册（中文版） - 图文(2)

来源：网络收集时间：2026-05-22

导读： JDR_MEM2：输入缓冲区的容量过小， JD_SZBUF数据过� � JDR_PAR：入口参数错误，指定的工作区指针为NULL. JDR_FMT1: 入口参数错误，指定的JPEG数据无法读取 JDR_FMT2：非JPEG图像 JDR_FMT3：非标准格式的彩色JPEG图

JDR_MEM2：输入缓冲区的容量过小， JD_SZBUF数据过小。 JDR_PAR：入口参数错误，指定的工作区指针为NULL. JDR_FMT1: 入口参数错误，指定的JPEG数据无法读取 JDR_FMT2：非JPEG图像

JDR_FMT3：非标准格式的彩色JPEG图像备注：

jd_prepare函数是执行JPEG图片解码的第一步工作. 此函数用于分析JPEG图片的信息，并为后续的解码过程创建一个解码对象。此函数调用成功后,便可以调用jd_decomp函数执行解码的工作。此函数可以提取JPEG的尺寸参数，可用于配置用户自定义的对象信息，以及用于后续的解压工作。

2. jd_decomp

函数功能：解压JPEG图片，并输出RGB格式的数据函数头：JRESULT jd_decomp (

JDEC* jdec, /* 指向一个已定义的解码对象 */ UINT(*outfunc)(JDEC*,void*,JRECT*), /* 指向输出函数的指针 */ BYTE scale /* 图像解压尺寸比例配置 */ ); 入口参数：

Jdec：指向一个已定义的解码对象

（*outfunc）：指向一个用户定义的输出函数.用于以RGB格式输出图片的数据。

Scale：配置图像解压缩输出尺寸比例，输出图像的比例被配置为 1 / 2 ^ N (N = 0 to 3).这里需要配置的便是N的大小，如果输出比例功能被关闭 (JD_USE_SCALE == 0),那么这个数据必须是0；返回值：

JDR_OK：函数执行成功 JDR_INTR：解压缩的工作被输出函数中断，即输出函数中出现错误或者输出函数命令本函数解码中止。 JDR_INP：由于磁盘错误或者错误的数据结束标识而导致输入函数运行失败 JDR_PAR：给定的图像输出比例参数错误

JDR_FMT1：数据结构错误，无法加载JPEG图片的数据备注：

jd_decomp函数是解码一个JPEG图片的第二步工作.此函数解码JPEG图片，并通过用户提供的输出函数输出解码得到的RGB数据.此函数执行过以后，待解码对象自动失效。

图像输出比例参数可以被预设.它可以被预设为 1/2, 1/4 或者 1/8.例如：当使用1/4的图像输出比例解码一个大小为1024x768的JPEG 图像时,它的输出尺寸将会是 256x192. 一般情况下，图像输出比例为1/2、1/4时，与不进行比例输出时相比会轻微的降低解码的速度。但是当图像输出比例等于 1/8 时，将会比无输出比例时快 2/3 时间，因为解码的部分功能将会被省略. 这个特性被用于产生缩略图。 3.Input Function

函数功能：用户自定义的用于输入数据的函数

函数头：UINT in_func ( JDEC* jdec, /* 指向待解码对象的指针 */ BYTE* buff, /* 指向用于存储读取的数据的缓冲区的指针 */ UINT ndata /* 待读取数据的数量 */ );

入口参数：

Jdec：指向待解码对象的指针 Buff：指向用于存储读取的数据的缓冲区的指针. 当此指针为NULL时，将从输入数据流中删除数据。 Ndata：指定将要从输入数据流中读取/删除的数据的字节数。返回值：

返回读取/删除的字节数目；如果返回值为0，则jd_prepare和jd_decomp函数将返回JDR_INP。备注：

此函数是TjpgDec模块的数据输入接口. 相应的解码流程会使用被传递给函数jd_prepare的第5个入口参数的数据进行解码工作，此参数是用户自定义的解码对象信息，被存储于 jdec->device 。（译者注：在MCU的应用中，此数据类型仅使用FIL类型用以指向一个待解码的JPEG文件） 4. Output Function

函数功能：用户自定义的输出函数，用于向输出设备输出解码后的图片数据函数头：UINT out_func ( JDEC* jdec, /*指向一个已定义的解码对象*/ void* bitmap, /*指向已解码好但等待输出的RGB位图数据的指针*/ JRECT* rect /* bitmap所代表的待输出的像素块的大小 */ ); 入口参数：

Jdec：指向一个已定义的解码对象

Bitmap：指向已解码好但等待输出的RGB位图数据的指针

Rect: bitmap所代表的待输出的像素块的尺寸大小（译者注：看其定义可知，此结构体使用“上下左右”的值来表示一个矩形图片像素块的四个点）

返回值：一般情况下返回1.这个返回值将允许TjpgDec模块继续进行解码工作。当它的返回值为0时，jd_decomp函数将会终止解码工作，并返回JDR_INTR。这种利用out_func的返回值来终止解码的方式，是非常有用的。备注：此函数是TjpgDec模块的输出接口。相应的解码流程会使用被传递给函数jd_prepare的第5个入口参数的数据进行解码工作，此参数是用户自定义的解码对象信息，被存储于 jdec->device 。（译者注：在MCU的应用中，此数据类型仅使用FIL类型用以指向一个待解码的JPEG文件）解压后得到的RGB位图数据可以在此函数中被发送到显示设备或者数据缓冲区，RGB位图数据的第一个数据是图片的左上角的矩形块的像素数据，第二个数据是右边一个矩形块的像素数据，最后一个数据是图片右下角的矩形块的像素数据。每一个矩形像素块的大小是根据裁剪方式和图像输出比例的不同而从1x1到16x16不等的（译者注：像素块的大小是TjpgDec自由选择的，用户无法指定）。如果矩形块的大小超过了数据缓冲区的容量，那么在这个输出函数中需要进行一定的裁剪。

（译者注：在TjpgDec模块中，图像的像素数据的输出是以像素块为单位的，例如：当使用LCD显示图片时，可以看到图片是以一块一块的形式从左上角到右下角把整个图片显示出来的。所以，在MCU的使用中，当使用TFTLCD显示图片时，需要在这个输出函数中先根据rect提供的值在LCD上定义出一个图片显示的矩形窗口，然后再把bitmap数据输出到这个矩形窗口中，而TjpgDec会根据图片的信息自动改变rect的值，用户不用计算下一个像素块的显示位置。） RGB位图数据的格式需要使用配置选项中的JD_FORMAT进行定义。（在文件tjpgd.h中）当定义为24位真彩色（RGB888）时，RGB位图数据使用3个字节表示一个像素点：RRRRRRRR, GGGGGGGG, BBBBBBBB, RRRRRRRR, GGGGGGGG, BBBBBBBB, ... 当定义为RGB565格式时，RGB位图数据使用一个半字（16位）的数据表示一个像素点：RRRRRGGGGGGBBBBB, RRRRRGGGGGGBBBBB, RRRRRGGGGGGBBBBB, ...

第三章函数中使用的结构体

1. JDEC：此结构体存储有关解码使用的数据、指针和各种标志。（待解码对象信息记录表） struct JDEC {

UINT dctr; /* 输入缓冲区的容量 */

BYTE* dptr; /* 指向当前正在读取的数据的指针 */ BYTE* inbuf; /* 指向输入缓冲区的指针 */

BYTE dmsk; /* 当前正在读取的字节中的当前的一个位 */ BYTE scale; /* 图像输出比例 */

BYTE msx, msy; /* 单片机一个内存块的大小 (宽度和高度) */ BYTE qtid[3]; /* 每个组件的量化表的编号 */

SHORT dcv[3]; /* Previous DC element of each component */ WORD nrst; /* Restart inverval */

UINT width, height; /* 输入的图片的大小（像素） */

BYTE* huffbits[2][2];

/*霍夫曼比特分布表 [yc][dcac] */

WORD* huffcode[2][2]; /* 霍夫曼码字表 [yc][dcac] */ BYTE* huffdata[2][2]; /* 霍夫曼解码数据表 [yc][dcac] */ LONG* qttbl[4]; /* De-quaitizer tables [id] */ voi …… 此处隐藏：5900字，全部文档内容请下载后查看。喜欢就下载吧 ……

TjpgDec技术手册（中文版） - 图文(2).doc 将本文的Word文档下载到电脑，方便复制、编辑、收藏和打印

下载这篇word文档

本文链接：https://www.jiaowen.net/wendang/403403.html（转载请注明文章来源）

上一篇：简明中国文学史（下）作业参考资料
下一篇：2018-2019学年湘教版五年级语文上册第二单元测试卷及解析