TJpgDec—轻量级JPEG解码器

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是一个免费软件，对教育、研究和开发开发。你可以使用、修改和重新分发它，对个人项目或商业产品没有任何限制和责任。
- 先读: TJpgDec 应用笔记2012年8月13日
- 下载: TJpgDec R0.01b 2012年9月3日
- 下载: TJpgDec 示例项目 (AVR, PIC24, LPC1114 and Win32)2012年2月19日
- 演示短片(MP4/3MB)
查看全文

相关阅读:
零基础学Python-第一章：Python介绍和安装-02.Python的发展历史与版本
 零基础学Python_汇总贴
 零基础学Python-第一章：Python介绍和安装-01.Python语言的特点
 Spring cloud微服务安全实战-3-11API安全机制之登录
 iOS play video
Http Live Streaming 实现iphone在线播放视频[转]
UIWebView分页显示
 ios7适配--uitableviewcell选中效果
 ios7 设置status bar风格
 ios7适配--隐藏status bar

原文地址：https://www.cnblogs.com/oloroso/p/5851505.html

TJpgDec—轻量级JPEG解码器

TJpgDec—轻量级JPEG解码器

特性

API接口

jd_prepare

jd_decomp

I/O函数

Input Function

Output Function

资源