Qt Creator配置FreeImage库

短命女 2022-11-30 04:03 221阅读 0赞

# 第零步：前言 #

根据官网介绍：

> FreeImage 是一个开源库项目，面向希望支持当今多媒体应用程序所需的流行图形图像格式（如 PNG，BMP，JPEG，TIFF 和其他格式）的开发人员。FreeImage 易于使用，快速，多线程安全，与 Windows 的所有 32 位或 64 位版本兼容以及跨平台（适用于 Linux 和 Mac OS X）。
> 
> 凭借其 ANSI C 接口，FreeImage 可用于多种语言，包括 C，C ++，VB，C＃，Delphi，Java 和常见的脚本语言，如 Perl，Python，PHP，TCL 或 Ruby。
> 
> 该库有两个版本：可以与任何 WIN32 或 WIN64 C / C ++ 编译器链接的二进制 DLL 发行版和源码发行版。提供了 Microsoft VS.Net 2013 和 VS.Net 2017 的工程文件，以及 Linux，MinGW 和 Mac OS X 的 makefile。
> 
> 从 2000 年 1 月到 2002 年 7 月，FreeImage 由 Floris van den Berg 设计并主要开发。FreeImage 现在由 HervéDrolon 维护。

然后介绍下我的开发环境：MSVC2019 + Qt5.15.0-32位

# 第一步：下载FreeImage #

进入官网下载源码或者 DLL：[https://freeimage.sourceforge.io/download.html][https_freeimage.sourceforge.io_download.html]

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2dvbmdqaWFuYm8xOTky_size_16_color_FFFFFF_t_70][]

因为已经提供 Win 版的 DLL 了，所以我直接下的 DLL 版本。网上也有人自己编译的，参照：

[https://blog.csdn.net/yanlinei8571/article/details/80918276][https_blog.csdn.net_yanlinei8571_article_details_80918276]

（因为本身已经带了工程文件，所以编译还是比较方便的）

# 第二步：配置FreeImage #

先把 FreeImage 的头文件、lib、dll 拷贝到工程目录：

![20200823000139469.png][]

![20200823000155238.png][]

然后在 Qt pro 文件中加上对应的库路径：

#windows
    win32{
        contains(QT_ARCH, i386){
            #32bit
            LIBS += -L$$PWD/freeimage/x32/ -lFreeImage
            INCLUDEPATH += $$PWD/freeimage/x32
            DEPENDPATH += $$PWD/freeimage/x32
        }
        contains(QT_ARCH, x86_64){
            #64bit
            LIBS += -L$$PWD/freeimage/x64/ -lFreeImage
            INCLUDEPATH += $$PWD/freeimage/x64
            DEPENDPATH += $$PWD/freeimage/x64
        }
    }

现在我们可以使用 FreeImage 的 C 接口了：

void c_test() 
    {
     // 初始化
        FreeImage_Initialise(TRUE);
    
        // 文件名
        const char* imageFile = "F:/Src/code.png";
        const char* saveFile = "F:/Src/code2.png";
    
        // 图片格式
        FREE_IMAGE_FORMAT fif = FIF_UNKNOWN;
    
        // 获取图片格式
        /* 此处需要特别注意，即使后缀名是.png并不代表图片格式就真是PNG格式，这里先通过FreeImage_GetFileType函数获取图片格式，
            然后再进行加载，否则，也许会出现加载失败的情况。
            */
        fif = FreeImage_GetFileType(imageFile);
        if (fif == FIF_UNKNOWN)
            fif = FreeImage_GetFIFFromFilename(imageFile);
    
        FIBITMAP *bitmap1 = NULL;
        FIBITMAP *bitmap2 = NULL;
        if ((fif != FIF_UNKNOWN) && FreeImage_FIFSupportsReading(fif)){
            bitmap1 = FreeImage_Load(fif, imageFile, PNG_DEFAULT);
        }
        if (!bitmap1){
            fprintf(stderr, "Fail to Load Image!\n");
            exit(-1);
        }
        else{
            FreeImage_Save(fif, bitmap1, saveFile, PNG_DEFAULT);
            bitmap2 = FreeImage_Load(fif, saveFile, PNG_DEFAULT);
            if (!bitmap2){
                fprintf(stderr, "Fail to Load saved Image!\n");
                exit(-1);
            }
        }
    
        // 获取影像的宽高，都以像素为单位
        int width = FreeImage_GetWidth(bitmap1);
        int height = FreeImage_GetHeight(bitmap1);
    
        // 获取总共的像素数目
        int pixel_num = width*height;
    
        // 获取保存每个像素的字节数
        unsigned int channel = FreeImage_GetLine(bitmap1) / width;
    
        printf("Width:%d\t Height:%d\t PixelCount:%d\t Channel:%d\n", width, height, pixel_num, channel);
    
        // 获取保存图片的字节数组
        unsigned char *bits1 = FreeImage_GetBits(bitmap1);
        unsigned char *bits2 = FreeImage_GetBits(bitmap2);
        // rgb反序后保存
        int offset=0;
        for (int x = 0; x<pixel_num; x++){
            offset=x*channel;
            bits2[offset+0] = bits1[offset+2];
            bits2[offset+1] = bits1[offset+1];
            bits2[offset+2] = bits1[offset+0];
            bits2[offset+3] = bits1[offset+3];
        }
    
        // 保存更新后的图片
        FreeImage_Save(fif, bitmap2, saveFile, PNG_DEFAULT);
    
        // 从内存中删除载入图片，防止内存泄漏
        FreeImage_Unload(bitmap1);
        FreeImage_Unload(bitmap2);
        // 撤销初始化
        FreeImage_DeInitialise();
    }

运行结果：

![2020082300175952.png][]

# 第三步：配置 C++ 的封装 #

除了 C 接口，FreeImage 还提供了 C++ 等语言的封装：

![20200823000813517.png][]

封装也提供了工程文件便于生成库文件，但是我直接把 Wrapper 的源码拷贝到了我的工程里：

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2dvbmdqaWFuYm8xOTky_size_16_color_FFFFFF_t_70 1][]

然后在 pro 中导入下：

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2dvbmdqaWFuYm8xOTky_size_16_color_FFFFFF_t_70 2][]

现在还有 2 个问题：

第一，直接包含的源码，编译时报错，我改了两个地方，FreeImagePlus 头文件加上 FREEIMAGE\_LIB 宏，还有 fipWinImage 类我直接注释了；

![20200823001722284.png][]

第二，我使用的是 utf8 文本编码，但源码文件中作者的名字不能正常的用 utf8 显示，还导致编译有问题，我拿 VSCode 编辑器用 utf8 重新保存了。

现在可以跑我们的测试代码了：

（C++封装的在线文档：[https://freeimage.sourceforge.io/fip/annotated.html][https_freeimage.sourceforge.io_fip_annotated.html]）

void cpp_test()
    {
    #if defined(FREEIMAGE_LIB) || !defined(WIN32)
        FreeImage_Initialise();
    #endif
    
        fipImage image;
        image.load("F:/Src/code.png");
        if(!image.isValid())
            exit(-1);
    
        fipImage saveimage(image);
        //bpp参数位图深度，直接构造不好用，还是拷贝构造一个吧
        //fipImage saveimage(FIT_BITMAP,image.getWidth(),image.getHeight(),8);
        if(!saveimage.isValid())
            exit(-2);
    
        //或者用accessPixels
        for(unsigned int row=0;row<image.getHeight();row++)
        {
            const unsigned char *line=image.getScanLine(row);
            unsigned char *saveline=saveimage.getScanLine(row);
            for(unsigned int col=0;col<image.getWidth();col++)
            {
                //saveline[col*4+0]=line[col*4+0];
                saveline[col*4+1]=line[col*4+2];
                saveline[col*4+2]=line[col*4+1];
                //saveline[col*4+3]=line[col*4+3];
            }
        }
    
        saveimage.save(FIF_PNG,"F:/Src/code3.png",PNG_DEFAULT);
    
    
    #if defined(FREEIMAGE_LIB) || !defined(WIN32)
        FreeImage_DeInitialise();
    #endif
    }

运行结果：

![20200823001820296.png][]

[https_freeimage.sourceforge.io_download.html]: https://freeimage.sourceforge.io/download.html
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2dvbmdqaWFuYm8xOTky_size_16_color_FFFFFF_t_70]: /images/20221124/1b612788b5384c48933104fae4fb0309.png
[https_blog.csdn.net_yanlinei8571_article_details_80918276]: https://blog.csdn.net/yanlinei8571/article/details/80918276
[20200823000139469.png]: /images/20221124/ed6679a1a3e34909ab684a14be2be2ec.png
[20200823000155238.png]: /images/20221124/58d01047a47e4a5e9e8c8ee5f7d3cc2c.png
[2020082300175952.png]: /images/20221124/2225d5e514e04ffdb19ad4fd9611e3d6.png
[20200823000813517.png]: /images/20221124/ea6672e612564e44bd599771a2ae44a7.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2dvbmdqaWFuYm8xOTky_size_16_color_FFFFFF_t_70 1]: /images/20221124/c5b4cd1f2b854cc1a320cb678cbef4a2.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2dvbmdqaWFuYm8xOTky_size_16_color_FFFFFF_t_70 2]: /images/20221124/8e0869a5d5cf40099aa19e5cff0f7531.png
[20200823001722284.png]: /images/20221124/6272e2a7fa81442aa4ef0f803d07e9a7.png
[https_freeimage.sourceforge.io_fip_annotated.html]: https://freeimage.sourceforge.io/fip/annotated.html
[20200823001820296.png]: /images/20221124/64745e44c698425a8eee9b4f828d7bd3.png