libjpeg库使用实例细节分析

本文涉及的产品
公共DNS(含HTTPDNS解析),每月1000万次HTTP解析
云解析 DNS,旗舰版 1个月
全局流量管理 GTM,标准版 1个月
简介: libjpeg库使用实例细节分析

这段代码是一个使用libjpeg库进行JPEG文件解析的模块。以下是代码的主要功能和结构:

MyErrorMgr结构体定义了自定义的错误管理器,用于处理libjpeg库的错误。

isJPGFormat函数用于判断给定的文件是否为JPEG格式。它使用libjpeg库的函数来读取文件头并检查是否为有效的JPEG文件。

CovertOneLine函数用于将从JPEG文件中提取的一行像素数据转换为可以在显示设备上使用的格式。根据输入和输出的像素位数,它将像素数据转换为24位、16位或32位的格式。

GetPixelDatasFrmJPG函数用于从JPEG文件中提取图像数据并转换为可以在显示设备上使用的格式。它使用libjpeg库来解压缩JPEG数据并将其转换为指定的像素位数。

FreePixelDatasForJPG函数用于释放从JPEG文件中提取的像素数据所占用的内存。

JPGParserInit函数用于注册JPEG文件解析模块,将其添加到系统中。

该模块提供了一组函数来解析JPEG文件并将其转换为可以在显示设备上使用的像素数据。它使用libjpeg库提供的函数来处理JPEG文件的解码和转换过程。

错误管理器结构体

typedef struct MyErrorMgr
{
    struct jpeg_error_mgr pub;
    jmp_buf setjmp_buffer;
}T_MyErrorMgr, *PT_MyErrorMgr;

这段代码定义了一个名为 MyErrorMgr 的结构体,并使用 typedef 关键字定义了两个类型别名 T_MyErrorMgr 和 PT_MyErrorMgr。

MyErrorMgr 结构体包含两个成员变量:

pub:类型为 struct jpeg_error_mgr,是 libjpeg 库中定义的错误管理器结构体。

setjmp_buffer:类型为 jmp_buf,用于实现跳转缓冲区,用于错误处理。

通过 typedef 关键字,将 MyErrorMgr 结构体类型别名为 T_MyErrorMgr,并将指向 MyErrorMgr 结构体的指针类型别名为 PT_MyErrorMgr。

这样做的目的是定义一个自定义的错误管理器结构体,继承了 libjpeg 库中的错误管理器结构体,并添加了额外的字段用于自定义的错误处理。通过使用类型别名,可以方便地在代码中使用 T_MyErrorMgr 和 PT_MyErrorMgr 来表示该结构体类型和指针类型。

libjpeg库出错处理函数

static void MyErrorExit(j_common_ptr ptCInfo)
{
    static char errStr[JMSG_LENGTH_MAX];
    PT_MyErrorMgr ptMyErr = (PT_MyErrorMgr)ptCInfo->err;
    /* Create the message */
    (*ptCInfo->err->format_message) (ptCInfo, errStr);
    DBG_PRINTF("%s\n", errStr);
    longjmp(ptMyErr->setjmp_buffer, 1);
}

这段代码实现了一个自定义的错误处理函数 MyErrorExit,该函数用于处理由 libjpeg 库发生的错误。以下是对该函数的逐行解析:

static void MyErrorExit(j_common_ptr ptCInfo): 函数声明,接受一个名为 ptCInfo 的 j_common_ptr 类型参数,该参数是 libjpeg 库抽象出来的通用结构体指针。

static char errStr[JMSG_LENGTH_MAX];: 定义一个静态字符数组 errStr,长度为 JMSG_LENGTH_MAX,用于存储错误消息字符串。

PT_MyErrorMgr ptMyErr = (PT_MyErrorMgr)ptCInfo->err;: 声明并初始化一个名为 ptMyErr 的指针变量,将 ptCInfo->err 强制转换为 PT_MyErrorMgr 类型,即自定义的错误管理器结构体指针。

(*ptCInfo->err->format_message) (ptCInfo, errStr);: 调用 ptCInfo->err->format_message 函数指针指向的函数,将错误消息格式化为字符串,并将其存储在 errStr 中。

DBG_PRINTF(“%s\n”, errStr);: 将错误消息打印输出到调试输出中。

longjmp(ptMyErr->setjmp_buffer, 1);: 使用 longjmp 函数跳转到 ptMyErr->setjmp_buffer 所标记的位置,同时传递参数 1。

总体而言,该函数的功能是在 libjpeg 库发生错误时,将错误消息格式化并输出到调试输出,然后通过 longjmp 函数跳转到错误处理的位置,以便进行进一步的处理或退出程序。

文件是否为JPG文件

/**********************************************************************
 * 函数名称: isJPGFormat
 * 功能描述: JPG模块是否支持该文件,即该文件是否为JPG文件
 * 输入参数: ptFileMap - 内含文件信息
 * 输出参数: 无
 * 返 回 值: 0 - 不支持, 1 - 支持
 ***********************************************************************/
static int isJPGFormat(PT_FileMap ptFileMap)
{
    struct jpeg_decompress_struct tDInfo;
    /* 默认的错误处理函数是让程序退出
     * 我们参考libjpeg里的bmp.c编写自己的错误处理函数
     */
    //struct jpeg_error_mgr tJErr;   
    T_MyErrorMgr tJerr;
    int iRet;
    fseek(ptFileMap->tFp, 0, SEEK_SET);
    // 分配和初始化一个decompression结构体
    // tDInfo.err = jpeg_std_error(&tJErr);
    tDInfo.err               = jpeg_std_error(&tJerr.pub);
    tJerr.pub.error_exit     = MyErrorExit;
    if(setjmp(tJerr.setjmp_buffer))
    {
        /* 如果程序能运行到这里, 表示JPEG解码出错 */
        jpeg_destroy_decompress(&tDInfo);
        return 0;;
    }
    jpeg_create_decompress(&tDInfo);
    // 用jpeg_read_header获得jpg信息
    jpeg_stdio_src(&tDInfo, ptFileMap->tFp);
    iRet = jpeg_read_header(&tDInfo, TRUE);
    jpeg_abort_decompress(&tDInfo);
    return (iRet == JPEG_HEADER_OK);
}

这段代码实现了一个函数 isJPGFormat,用于检查给定文件是否为 JPEG 格式。以下是对该函数的逐行解析:

static int isJPGFormat(PT_FileMap ptFileMap): 函数声明,接受一个名为 ptFileMap 的 PT_FileMap 类型参数,该参数是文件映射结构体指针。

struct jpeg_decompress_struct tDInfo;: 声明一个 jpeg_decompress_struct 结构体变量 tDInfo,用于存储 JPEG 解压缩相关的信息。

T_MyErrorMgr tJerr;: 声明一个 T_MyErrorMgr 结构体变量 tJerr,用于自定义的错误管理器。

int iRet;: 声明一个 int 类型变量 iRet,用于存储函数执行结果。

fseek(ptFileMap->tFp, 0, SEEK_SET);: 将文件指针移动到文件开头位置,以便进行后续的读取操作。

tDInfo.err = jpeg_std_error(&tJerr.pub);: 将 tJerr.pub 的错误管理器结构体赋值给 tDInfo.err,用于处理 JPEG 解压缩过程中的错误。

tJerr.pub.error_exit = MyErrorExit;: 将自定义的错误处理函数 MyErrorExit 赋值给 tJerr.pub.error_exit,以便在发生错误时执行相应的错误处理。

if (setjmp(tJerr.setjmp_buffer)): 使用 setjmp 函数设置一个跳转点,并检查跳转标记是否被设置。

jpeg_destroy_decompress(&tDInfo);: 在发生错误时,释放 JPEG 解压缩结构体 tDInfo 的资源。

return 0;: 返回 0,表示给定文件不是 JPEG 格式。

jpeg_create_decompress(&tDInfo);: 创建 JPEG 解压缩对象 tDInfo。

jpeg_stdio_src(&tDInfo, ptFileMap->tFp);: 将文件指针 ptFileMap->tFp 与 JPEG 解压缩对象 tDInfo 关联,以便从文件中读取 JPEG 数据。

iRet = jpeg_read_header(&tDInfo, TRUE);: 使用 jpeg_read_header 函数读取 JPEG 数据的头信息,并将结果存储在 iRet 变量中。

jpeg_abort_decompress(&tDInfo);: 中止 JPEG 解压缩过程,释放相关资源。

return (iRet == JPEG_HEADER_OK);: 返回比较结果 (iRet == JPEG_HEADER_OK),表示给定文件是否为有效的 JPEG 格式。

总体而言,该函数通过使用 libjpeg 库的函数来判断给定文件是否为 JPEG 格式。它首先尝试解析文件头信息,如果成功解析并返回 JPEG_HEADER_OK,则表示给定文件是有效的 JPEG 格式;否则,表示给定文件不是 JPEG 格式或解析过程中发生了错误。

取出的一行象素数据,转换为能在显示设备上使用的格式

/**********************************************************************
 * 函数名称: CovertOneLine
 * 功能描述: 把已经从JPG文件取出的一行象素数据,转换为能在显示设备上使用的格式
 * 输入参数: iWidth      - 宽度,即多少个象素
 *            iSrcBpp     - 已经从JPG文件取出的一行象素数据里面,一个象素用多少位来表示
 *            iDstBpp     - 显示设备上一个象素用多少位来表示
 *            pudSrcDatas - 已经从JPG文件取出的一行象素数所存储的位置
 *            pudDstDatas - 转换所得数据存储的位置
 * 输出参数: 无
 * 返 回 值: 0 - 成功, 其他值 - 失败
 ***********************************************************************/
static int CovertOneLine(int iWidth, int iSrcBpp, int iDstBpp, unsigned char *pudSrcDatas, unsigned char *pudDstDatas)
{
    unsigned int dwRed;
    unsigned int dwGreen;
    unsigned int dwBlue;
    unsigned int dwColor;
    unsigned short *pwDstDatas16bpp = (unsigned short *)pudDstDatas;
    unsigned int   *pwDstDatas32bpp = (unsigned int *)pudDstDatas;
    int i;
    int pos = 0;
    if (iSrcBpp != 24)
    {
        return -1;
    }
    if (iDstBpp == 24)
    {
        memcpy(pudDstDatas, pudSrcDatas, iWidth*3);
    }
    else
    {
        for (i = 0; i < iWidth; i++)
        {
            dwRed   = pudSrcDatas[pos++];
            dwGreen = pudSrcDatas[pos++];
            dwBlue  = pudSrcDatas[pos++];
            if (iDstBpp == 32)
            {
                dwColor = (dwRed << 16) | (dwGreen << 8) | dwBlue;
                *pwDstDatas32bpp = dwColor;
                pwDstDatas32bpp++;
            }
            else if (iDstBpp == 16)
            {
                /* 565 */
                dwRed   = dwRed >> 3;
                dwGreen = dwGreen >> 2;
                dwBlue  = dwBlue >> 3;
                dwColor = (dwRed << 11) | (dwGreen << 5) | (dwBlue);
                *pwDstDatas16bpp = dwColor;
                pwDstDatas16bpp++;
            }
        }
    }
    return 0;
}


目录
相关文章
|
7月前
|
机器学习/深度学习 存储 Python
|
7月前
|
SQL 关系型数据库 数据库
|
7月前
|
Python
在Python中快捷引入缺失包的技巧和实践
在Python中快捷引入缺失包的技巧和实践
50 0
|
7月前
|
C语言
转载 - gcc/ld 动态连接库和静态连接库使用方法
本文介绍了如何在GCC中实现部分程序静态链接、部分动态链接。使用`-Wl`标志传递链接器参数,`-Bstatic`强制链接静态库,`-Bdynamic`强制链接动态库。
|
7月前
|
存储 JSON JavaScript
50+常用工具函数之xijs更新指南(v1.2.4)
50+常用工具函数之xijs更新指南(v1.2.4)
67 4
|
存储 Serverless
FreeType使用实例细节分析
FreeType使用实例细节分析
240 0
|
缓存 并行计算 PyTorch
终于可用可组合函数转换库!PyTorch 1.11发布,弥补JAX短板,支持Python 3.10
终于可用可组合函数转换库!PyTorch 1.11发布,弥补JAX短板,支持Python 3.10
414 0
终于可用可组合函数转换库!PyTorch 1.11发布,弥补JAX短板,支持Python 3.10
python--测试使用不同的方式计算位涡平流项的差异
python--测试使用不同的方式计算位涡平流项的差异
python--测试使用不同的方式计算位涡平流项的差异
|
JSON 缓存 数据格式
由浅入深:Python 中如何实现自动导入缺失的库?
在写 Python 项目的时候,我们可能经常会遇到导入模块失败的错误:ImportError: No module named 'xxx' 或者 ModuleNotFoundError: No module named 'xxx' 。 导入失败问题,通常分为两种:一种是导入自己写的模块(即以 .py 为后缀的文件),另一种是导入三方库。
298 0
由浅入深:Python 中如何实现自动导入缺失的库?
|
运维 Python
python filecmp模块文件差异对比详解
python filecmp模块文件差异对比详解

热门文章

最新文章