在MCU上移植使用libjpeg

原创 嵌入式Lee 2024-11-26 17:46

一. 前言

在一些嵌入式项目中可能需要用到jpeg编解码,比如UVCMJPEG显示, 加载JPEG图片显示到TFT屏幕等,而往往很多通用MCU平台不带硬件jpeg编解码,此时就需要软件实现,这时就希望能有一个好用的jpeg编解码库,恰好官方就提供了这么一个c库即libjpeg。网址为https://libjpeg.sourceforge.net/可以方便将该库应用到自己的项目中,当然其实现也是学习jpeg编解码实现的不二之选。我们就来移植使用该项目源码,源码默认输入输出是针对文件的,我这里对其进行了一些可移植性改造,可以用户配置输入输出接口,这样可以针对缓存或者文件都可以,源码分享在了https://github.com/qinyunti/libjpeg_port.git.

二. 准备

这里先进入网站下载源码和相关的资料

进入网址https://libjpeg.sourceforge.net/

点击上述链接进入https://www.ijg.org/files/

最新版是jpegsr9f,上面还有一些pdf资料可以参考。

解压下载的压缩包jpegsr9f.zip

里面提供了VS相关的工程可以按照说明直接构建,但是我们这里是要移植到MCU上,所以只使用其源码,其他很多的图像格式处理相关的文件也暂时不添加以后有需要可以使用。

需要使用的源码如下,即只需要j开头的ch文件。

src|-- jaricom.c|-- jcapimin.c|-- jcapistd.c|-- jcarith.c|-- jccoefct.c|-- jccolor.c|-- jcdctmgr.c|-- jchuff.c|-- jcinit.c|-- jcmainct.c|-- jcmarker.c|-- jcmaster.c|-- jcomapi.c|-- jcparam.c|-- jcprepct.c|-- jcsample.c|-- jctrans.c|-- jdapimin.c|-- jdapistd.c|-- jdarith.c|-- jdatadst.c|-- jdatasrc.c|-- jdcoefct.c|-- jdcolor.c|-- jddctmgr.c|-- jdhuff.c|-- jdinput.c|-- jdmainct.c|-- jdmarker.c|-- jdmaster.c|-- jdmerge.c|-- jdpostct.c|-- jdsample.c|-- jdtrans.c|-- jerror.c|-- jfdctflt.c|-- jfdctfst.c|-- jfdctint.c|-- jidctflt.c|-- jidctfst.c|-- jidctint.c|-- jmemmgr.c|-- jquant1.c|-- jquant2.c`-- jutils.c
0 directories, 45 files
inc/|-- jdct.h|-- jerror.h|-- jinclude.h|-- jioport.h|-- jmemsys.h|-- jmorecfg.h|-- jpegint.h|-- jpeglib.h`-- jversion.h
0 directories, 9 files
port/|-- jioport.c|-- jmemansi.c|-- jmemdos.c|-- jmemmac.c|-- jmemname.c|-- jmemnobs.c`-- jmemport.c
0 directories, 7 files

我这里的源码如下

三. 配置

使用jconfig.h进行编译时静态配置

该文件由源码目录下的jconfig.txt生成,我们这里复制该文件手动修改为jconfig.h添加到自己的工程中去。

会有很多warning: unused parameter所以我们直接

添加编译参数-Wno-unused-variable,-Wno-unused-parameter忽略该告警。

3.1适配mem接口

添加jmemport.c

我这里不使用stdlib.hmallocfree所以

jpegsr9f/inc/jconfig.h

删除#define HAVE_STDLIB_H

参考jmemnobs.c新建我们自己的jmemport.c

实现以下接口

jpeg_get_small

jpeg_free_small

jpeg_get_large

jpeg_free_large

jpeg_mem_available

jpeg_open_backing_store

jpeg_mem_init

jpeg_mem_term

#include "FreeRTOS.h"//#ifndef HAVE_STDLIB_H   /*  should declare malloc(),free() *///extern void * malloc JPP((size_t size));//extern void free JPP((void *ptr));//#endif

替换mallocfree为我们自己的实现,我这里使用的是freertos

pvPortMallocvPortFree,如果支持标准cmallocfree则可以使用jmemansi.c

实现如下

/* * jmemport.c * * Copyright (C) 1992-1996, Thomas G. Lane. * Modified 2019 by Guido Vollbeding. * This file is part of the Independent JPEG Group's software. * For conditions of distribution and use, see the accompanying README file. * * This file provides a really simple implementation of the system- * dependent portion of the JPEG memory manager.  This implementation * assumes that no backing-store files are needed: all required space * can be obtained from malloc(). * This is very portable in the sense that it'll compile on almost anything, * but you'd better have lots of main memory (or virtual memory) if you want * to process big images. * Note that the max_memory_to_use option is respected by this implementation. */
#define JPEG_INTERNALS#include "jinclude.h"#include "jpeglib.h"#include "jmemsys.h" /* import the system-dependent declarations */#include "FreeRTOS.h"//#ifndef HAVE_STDLIB_H /* should declare malloc(),free() *///extern void * malloc JPP((size_t size));//extern void free JPP((void *ptr));//#endif

/* * Memory allocation and freeing are controlled by the regular library * routines malloc() and free(). */
GLOBAL(void *)jpeg_get_small (j_common_ptr cinfo, size_t sizeofobject){ void* ret; ret = (void *) pvPortMalloc(sizeofobject); #if JPEG_LOG jprintf("jpeg_get_small %p size:%ld r\n",ret, sizeofobject); #endif return ret;}
GLOBAL(void)jpeg_free_small (j_common_ptr cinfo, void * object, size_t sizeofobject){ #if JPEG_LOG jprintf("jpeg_free_small %p \r\n",object); #endif vPortFree(object);}

/* * "Large" objects are treated the same as "small" ones. * NB: although we include FAR keywords in the routine declarations, * this file won't actually work in 80x86 small/medium model; at least, * you probably won't be able to process useful-size images in only 64KB. */
GLOBAL(void FAR *)jpeg_get_large (j_common_ptr cinfo, size_t sizeofobject){ void* ret; ret = (void FAR *) pvPortMalloc(sizeofobject); #if JPEG_LOG jprintf("jpeg_get_small %p size:%ld r\n",ret, sizeofobject); #endif return ret;}
GLOBAL(void)jpeg_free_large (j_common_ptr cinfo, void FAR * object, size_t sizeofobject){ #if JPEG_LOG jprintf("jpeg_free_large %p \r\n",object); #endif vPortFree(object);}

/* * This routine computes the total memory space available for allocation. */
GLOBAL(long)jpeg_mem_available (j_common_ptr cinfo, long min_bytes_needed, long max_bytes_needed, long already_allocated){ if (cinfo->mem->max_memory_to_use) return cinfo->mem->max_memory_to_use - already_allocated;
/* Here we say, "we got all you want bud!" */ return max_bytes_needed;}

/* * Backing store (temporary file) management. * Since jpeg_mem_available always promised the moon, * this should never be called and we can just error out. */
GLOBAL(void)jpeg_open_backing_store (j_common_ptr cinfo, backing_store_ptr info, long total_bytes_needed){ ERREXIT(cinfo, JERR_NO_BACKING_STORE);}

/* * These routines take care of any system-dependent initialization and * cleanup required. Here, there isn't any. */
GLOBAL(long)jpeg_mem_init (j_common_ptr cinfo){ return 0; /* just set max_memory_to_use to 0 */}
GLOBAL(void)jpeg_mem_term (j_common_ptr cinfo){ /* no work */}

jdatadst.cmalloc/free替换

jpegsr9f/src/jdatadst.c

#ifndef HAVE_STDLIB_H   /*  should declare malloc(),free() */extern void * malloc JPP((size_t size));extern void free JPP((void *ptr));#endif

不使用stdlib则这里依赖外部实现的mallocfree,这里可移植性不好,这里直接依赖mem接口即。

注释掉

//#ifndef HAVE_STDLIB_H   /*  should declare malloc(),free() *///extern void * malloc JPP((size_t size));//extern void free JPP((void *ptr));//#endif

后面的malloc改为jpeg_get_small

free改为jpeg_free_small

nextbuffer = (JOCTET *) malloc(nextsize);

改为

nextbuffer = (JOCTET *) jpeg_get_small(0,nextsize);

dest->newbuffer = *outbuffer = (unsigned char *) malloc(OUTPUT_BUF_SIZE);

改为

dest->newbuffer = *outbuffer = (unsigned char *) jpeg_get_small(0,OUTPUT_BUF_SIZE);

free(dest->newbuffer);

改为

jpeg_free_small(0,dest->newbuffer,0);

jpegsr9f/src/jdatadst.c中需要

#include "jmemsys.h"

3.2不使用getenv

jpegsr9f/src/jmemmgr.c

#ifndef NO_GETENV#ifndef HAVE_STDLIB_H   /*  should declare getenv() */extern char * getenv JPP((const char * name));#endif#endif

我们不使用getenv则需要定义NO_GETENV

jpegsr9f/inc/jconfig.h中添加

#define NO_GETENV

3.3适配IO操作

我们在jpegsr9f/inc/jconfig.h

定义#define JPEG_USE_FILE_IO_CUSTOM

不定义JPEG_HAVE_FILE_IO_CUSTOM

走如下路线

即用户需要实现

jfread
jfwrite
jfflush
jferror

jpegsr9f/inc/jinclude.h中,FILE*改为void*,这样可移植

extern size_t jfread(void * __ptr, size_t __size, size_t __n, FILE * __stream);extern size_t jfwrite(const void * __ptr, size_t __size, size_t __n, FILE * __stream);extern int    jfflush(FILE * __stream);extern int    jferror(FILE * __fp);
改为extern size_t jfread(void * __ptr, size_t __size, size_t __n, void * __stream);extern size_t jfwrite(const void * __ptr, size_t __size, size_t __n, void * __stream);extern int    jfflush(void * __stream);extern int    jferror(void * __fp);

为了可移植性

jdatadst.c

jdatasrc.c,

jmemsys.h

jpeglib.h

FILE改为void

为了方便适配不同的输入输出方式,我这里添加了jioport.c/jioport.h可以用户设置对应的接口

h文件

#ifndef JPEG_IOPORT_H#define JPEG_IOPORT_H
#ifdef __cplusplus extern "C" {#endif
#include #include
typedef struct{  size_t (*read)(void * __ptr, size_t __size, size_t __n, void * __stream);  size_t (*write)(const void * __ptr, size_t __size, size_t __n, void * __stream);  int    (*flush)(void * __stream);  int    (*error)(void * __fp);  size_t infile_len;} jioport_st;
size_t jfread(void * __ptr, size_t __size, size_t __n, void * __stream);size_t jfwrite(const void * __ptr, size_t __size, size_t __n, void * __stream);int    jfflush(void * __stream);int    jferror(void * __fp);
void jioport_set(jioport_st* port);
#ifdef __cplusplus}#endif
#endif

c文件

#include "jconfig.h"#include "jioport.h"
jioport_st* s_jioport = (jioport_st*)0;
size_t jfread(void * __ptr, size_t __size, size_t __n, void * __stream){  #if JPEG_LOG  jprintf("jfread ptr:%p size:%ld n:%ld stream:%p\r\n",__ptr,__size,__n,__stream);  #endif  if((s_jioport != (jioport_st*)0) && (s_jioport->read != 0))  {    return s_jioport->read(__ptr, __size, __n, __stream);  }  return 0;}
size_t jfwrite(const void * __ptr, size_t __size, size_t __n, void * __stream){  #if JPEG_LOG  jprintf("jfwrite ptr:%p size:%ld n:%ld stream:%p\r\n",__ptr,__size,__n,__stream);  #endif  if((s_jioport != (jioport_st*)0) && (s_jioport->write != 0))  {    return s_jioport->write(__ptr, __size, __n, __stream);  }  return 0;}
int    jfflush(void * __stream){  #if JPEG_LOG  jprintf("jfflush stream:%p\r\n",__stream);  #endif  if((s_jioport != (jioport_st*)0) && (s_jioport->flush != 0))  {    return s_jioport->flush(__stream);  }  return 0;}
int    jferror(void * __fp){  #if JPEG_LOG  jprintf("jferror fp:%p\r\n",__fp);  #endif  if((s_jioport != (jioport_st*)0) && (s_jioport->error != 0))  {    return s_jioport->flush(__fp);  }  return 0;}
void jioport_set(jioport_st* port){  s_jioport = port;}

3.4适配打印

jpegsr9f/src/jerror.c

注释掉 //exit(EXIT_FAILURE);

因为一般MCU平台没有exit

fprintf(stderr, "%s\n", buffer);

改为

jprintf("%s\n", buffer);

jpegsr9f/inc/jconfig.h中实现jprintf

#include 
#define jprintf(fmt, arg...) printf(fmt, ##arg)

四. 测试

可以直接在pc上测试,参加git源码

编译

./build.sh

4.1 编码

源码见

jpeg_encode_buffer.c/h

encode_test.c

注意输入bmp图片必须是24位格式,且一行数据量要是4的倍数,widthx34的倍数.

./encode_test testimg.bmp testimg.jpg 320 240 50

生成testimg.jpg如下

4.2解码

源码见

jpeg_decode_buffer.c/h

decode_test.c

./decode_test testimg.jpg testimg.rgb 320

使用YUView软件查看输出文件testimg.rgb

五. 总结

ligjpegTom LaneIJG开发的对jpeg的实现,广泛使用。本文分享了将其进行简单的移植改造适合MCU等任意嵌入式平台使用。

以上测试是在pc上进行,在mcu上比如freertos上则只需要使用jmemport.c,如果不是使用freertos则替换自己的动态分配接口,使用jconfig.h修改#define jprintf(fmt, arg...) printf(fmt, ##arg)宏为自己的打印宏即可。









评论
  • 《高速PCB设计经验规则应用实践》+PCB绘制学习与验证读书首先看目录,我感兴趣的是这一节;作者在书中列举了一条经典规则,然后进行详细分析,通过公式推导图表列举说明了传统的这一规则是受到电容加工特点影响的,在使用了MLCC陶瓷电容后这一条规则已经不再实用了。图书还列举了高速PCB设计需要的专业工具和仿真软件,当然由于篇幅所限,只是介绍了一点点设计步骤;我最感兴趣的部分还是元件布局的经验规则,在这里列举如下:在这里,演示一下,我根据书本知识进行电机驱动的布局:这也算知行合一吧。对于布局书中有一句:
    wuyu2009 2024-11-30 20:30 84浏览
  • 艾迈斯欧司朗全新“样片申请”小程序,逾160种LED、传感器、多芯片组合等产品样片一触即达。轻松3步完成申请,境内免费包邮到家!本期热荐性能显著提升的OSLON® Optimal,GF CSSRML.24ams OSRAM 基于最新芯片技术推出全新LED产品OSLON® Optimal系列,实现了显著的性能升级。该系列提供五种不同颜色的光源选项,包括Hyper Red(660 nm,PDN)、Red(640 nm)、Deep Blue(450 nm,PDN)、Far Red(730 nm)及Ho
    艾迈斯欧司朗 2024-11-29 16:55 152浏览
  • 学习学习笔记&记录学习学习笔记&记录学习学习笔记&记录学习学习笔记&记录学习学习笔记&记录学习笔记&记录学习习笔记&记学习学习笔记&记录学习学习笔记&记录学习习笔记&记录学习学习笔记&记录学习学习笔记记录学习学习笔记&记录学习学习笔记&记录学习学习笔记&记录学习学习笔记&记录学习学习笔记&记录学习习笔记&记录学习学习笔记&记录学习学习笔记&记录学习学习笔记&记录学习学习笔记&记录学习学习笔记&记录学习学习笔记&记录学习学习笔记&学习学习笔记&记录学习学习笔记&记录学习学习笔记&记录学习学习笔记&
    youyeye 2024-11-30 14:30 62浏览
  • 国产光耦合器正以其创新性和多样性引领行业发展。凭借强大的研发能力,国内制造商推出了适应汽车、电信等领域独特需求的专业化光耦合器,为各行业的技术进步提供了重要支持。本文将重点探讨国产光耦合器的技术创新与产品多样性,以及它们在推动产业升级中的重要作用。国产光耦合器创新的作用满足现代需求的创新模式新设计正在满足不断变化的市场需求。例如,高速光耦合器满足了电信和数据处理系统中快速信号传输的需求。同时,栅极驱动光耦合器支持电动汽车(EV)和工业电机驱动器等大功率应用中的精确高效控制。先进材料和设计将碳化硅
    克里雅半导体科技 2024-11-29 16:18 157浏览
  • 国产光耦合器因其在电子系统中的重要作用而受到认可,可提供可靠的电气隔离并保护敏感电路免受高压干扰。然而,随着行业向5G和高频数据传输等高速应用迈进,对其性能和寿命的担忧已成为焦点。本文深入探讨了国产光耦合器在高频环境中面临的挑战,并探索了克服这些限制的创新方法。高频性能:一个持续关注的问题信号传输中的挑战国产光耦合器传统上利用LED和光电晶体管进行信号隔离。虽然这些组件对于标准应用有效,但在高频下面临挑战。随着工作频率的增加,信号延迟和数据保真度降低很常见,限制了它们在电信和高速计算等领域的有效
    腾恩科技-彭工 2024-11-29 16:11 106浏览
  • 戴上XR眼镜去“追龙”是种什么体验?2024年11月30日,由上海自然博物馆(上海科技馆分馆)与三湘印象联合出品、三湘印象旗下观印象艺术发展有限公司(下简称“观印象”)承制的《又见恐龙》XR嘉年华在上海自然博物馆重磅开幕。该体验项目将于12月1日正式对公众开放,持续至2025年3月30日。双向奔赴,恐龙IP撞上元宇宙不久前,上海市经济和信息化委员会等部门联合印发了《上海市超高清视听产业发展行动方案》,特别提到“支持博物馆、主题乐园等场所推动超高清视听技术应用,丰富线下文旅消费体验”。作为上海自然
    电子与消费 2024-11-30 22:03 70浏览
  • RDDI-DAP错误通常与调试接口相关,特别是在使用CMSIS-DAP协议进行嵌入式系统开发时。以下是一些可能的原因和解决方法: 1. 硬件连接问题:     检查调试器(如ST-Link)与目标板之间的连接是否牢固。     确保所有必要的引脚都已正确连接,没有松动或短路。 2. 电源问题:     确保目标板和调试器都有足够的电源供应。     检查电源电压是否符合目标板的规格要求。 3. 固件问题: &n
    丙丁先生 2024-12-01 17:37 57浏览
  • 在电子技术快速发展的今天,KLV15002光耦固态继电器以高性能和强可靠性完美解决行业需求。该光继电器旨在提供无与伦比的电气隔离和无缝切换,是现代系统的终极选择。无论是在电信、工业自动化还是测试环境中,KLV15002光耦合器固态继电器都完美融合了效率和耐用性,可满足当今苛刻的应用需求。为什么选择KLV15002光耦合器固态继电器?不妥协的电压隔离从本质上讲,KLV15002优先考虑安全性。输入到输出隔离达到3750Vrms(后缀为V的型号为5000Vrms),确保即使在高压情况下,敏感的低功耗
    克里雅半导体科技 2024-11-29 16:15 119浏览
  • 光伏逆变器是一种高效的能量转换设备,它能够将光伏太阳能板(PV)产生的不稳定的直流电压转换成与市电频率同步的交流电。这种转换后的电能不仅可以回馈至商用输电网络,还能供独立电网系统使用。光伏逆变器在商业光伏储能电站和家庭独立储能系统等应用领域中得到了广泛的应用。光耦合器,以其高速信号传输、出色的共模抑制比以及单向信号传输和光电隔离的特性,在光伏逆变器中扮演着至关重要的角色。它确保了系统的安全隔离、干扰的有效隔离以及通信信号的精准传输。光耦合器的使用不仅提高了系统的稳定性和安全性,而且由于其低功耗的
    晶台光耦 2024-12-02 10:40 53浏览
  • 最近几年,新能源汽车愈发受到消费者的青睐,其销量也是一路走高。据中汽协公布的数据显示,2024年10月,新能源汽车产销分别完成146.3万辆和143万辆,同比分别增长48%和49.6%。而结合各家新能源车企所公布的销量数据来看,比亚迪再度夺得了销冠宝座,其10月新能源汽车销量达到了502657辆,同比增长66.53%。众所周知,比亚迪是新能源汽车领域的重要参与者,其一举一动向来为外界所关注。日前,比亚迪汽车旗下品牌方程豹汽车推出了新车方程豹豹8,该款车型一上市就迅速吸引了消费者的目光,成为SUV
    刘旷 2024-12-02 09:32 58浏览
  • By Toradex胡珊逢简介嵌入式领域的部分应用对安全、可靠、实时性有切实的需求,在诸多实现该需求的方案中,QNX 是经行业验证的选择。在 QNX SDP 8.0 上 BlackBerry 推出了 QNX Everywhere 项目,个人用户可以出于非商业目的免费使用 QNX 操作系统。得益于 Toradex 和 QNX 的良好合作伙伴关系,用户能够在 Apalis iMX8QM 和 Verdin iMX8MP 模块上轻松测试和评估 QNX 8 系统。下面将基于 Apalis iMX8QM 介
    hai.qin_651820742 2024-11-29 15:29 150浏览
  • 光耦合器作为关键技术组件,在确保安全性、可靠性和效率方面发挥着不可或缺的作用。无论是混合动力和电动汽车(HEV),还是军事和航空航天系统,它们都以卓越的性能支持高要求的应用环境,成为现代复杂系统中的隐形功臣。在迈向更环保技术和先进系统的过程中,光耦合器的重要性愈加凸显。1.混合动力和电动汽车中的光耦合器电池管理:保护动力源在电动汽车中,电池管理系统(BMS)是最佳充电、放电和性能监控背后的大脑。光耦合器在这里充当守门人,将高压电池组与敏感的低压电路隔离开来。这不仅可以防止潜在的损坏,还可以提高乘
    腾恩科技-彭工 2024-11-29 16:12 117浏览
我要评论
0
点击右上角,分享到朋友圈 我知道啦
请使用浏览器分享功能 我知道啦