TjpgDec技术手册.pdf

TjpgDec 技术手册 R0.01b 版 前言 相信大家对FATFS 文件系统都不陌生了，2012 年FATFS 的作者推出了JPG/JPEG 图 片的解码函数库TJpgDec 的R0.01b 版，使用方法和FATFS 文件系统的使用一样，仅仅 调用 2 个简单的库函数就能完成对 JPG/JPEG 图片的解码，而且输出的数据格式为 RGB888 或RGB565。 本文档是根据 ChaN 的专用网页提供的英文版技术手册翻译而来，因个人水平有限 以及时间仓促，错误之处在所难免。本文档原始版权归TJpgDec 的作者所有，本人只是 做了一下翻译的工作，把这篇文档献给所有嵌入式开发人员，希望能够帮到你们。 嵌入式奋勇前进 2013-10-20 一．前言： TJpgDec 是一款为小型嵌入式系统服务的高效且完善的JPEG 图片解码模块。它占用内存极少，因 此可以移植入像AVR,8051，PIC,Z80，Cortex-M0 等等小型单片机中。 二．特点：  库函数是按照ANSI-C 规范编写的，所以应用平台不受 约束。  易于使用的主模式操作方式。  完全可重入的架构。  非常小的内存占用： o RAM 仅占用3KB，而不受图片大小的影响。 o ROM 占用3.5-8.5KB，主要用于存储代码和const 常量。  输出格式: o 输出图片比例: 1/1, 1/2, 1/4 ，1/8 可选 o 输出像素格式: RGB888/RGB565 （可预设） 三．应用程序接口： 共有2 个应用程序接口函数，用于分析和解码JPEG 图片（译者注：移植TJpgDec 时需要在主程序中调 用这两个库函数）  jd_prepare –为解码一个JPEG 图片做准备  jd_decomp –解码JPEG 图片 四．I/O 接口函数： TJpgDec 需要用户自定义2 个I/O 接口函数，用于输入JPEG 数据和输出解码后得到的像素数据。  Input funciotn - 从输入的数据流中读取JPEG 的数据  Output function –把解码后得到的像素数据发送到输出设备 五．备注说明： TJpgDec 应用模块是一款可用于教育和研发的开源软件。你完全可以根据自己的项目需要或者商 业产品的需要，自由更改本软件，而不用担负任何个人责任。 六．ChaN 的个人网页：（即TjpgDec 库函数下载地址）/fsw/tjpg/00index.html 注：其他信息，如各版本信息，在此不作翻译了。 第一章 TjpgDec 使用方法 1. 如何使用TjpgDec 首先创建并运行下面的例程中的程序，这是使用TjpgDec 的基础，同时，这也是TjpgDec 的典型 用法，而且这种用法可以减少调试中的错误出现。TjpgDec 模块分为两个部分，第一个部分对JPEG 图片的信息进行分析，第二个部分用于解码JPEG 图片。 （译者注：原技术手册中的例程是一个在PC 机上运行的例程，能够作为MCU 移植的一个参考。在本文最后面，本人根据自己对TjpgDec 的移植情 况写出来了一个移植到STM32 单片机的例程。） 使用步骤： 1. 初始化输入的数据流（例如：打开一个图片文件）。 2. 分配JPEG 解压缩对象和工作区。 3. 调用函数jd_prepare() ，用于分析JPEG 图片的信息，并为接下来的解码做好准备。 4. 根据JPEG 图片信息分析得到的数据，对输出设备进行初始化 。 5. 调用函数jd_decomp() ，对JPEG 图片进行解码。 2.系统架构 3.例程： /**/ /* 可以在PC 机上运行的TjpgDec 模块快速评估测试例程*/ /**/ #include stdio.h #inc