cximage在Linux怎样集成

在 Linux 下集成 CxImage，通常有两种常见场景：
1️⃣ 源码编译集成（推荐，最通用）
2️⃣ 作为第三方库集成到你的项目中（CMake / Makefile）

下面以 Linux（Ubuntu / Debian / CentOS 等） 为例详细说明。

一、CxImage 简介（先说明一个关键点）

CxImage 本身是为 Windows / Visual Studio 设计的库，
在 Linux 下 不能直接用 MSVC 工程文件编译，需要先做适配或寻找 Linux 移植版本。

实际在 Linux 中使用时，常见做法有：

✅ 使用 CxImage 的 Linux 移植版本
✅ 使用 CxImage + ImageMagick / libpng / libjpeg 替代方案
✅ 在 Linux 下仅支持部分格式（BMP、PNG、JPEG）

二、准备依赖库（非常重要）

CxImage 依赖以下库（Linux 下需先安装）：

1️⃣ 安装依赖（Ubuntu / Debian）

sudo apt update
sudo apt install -y \
    build-essential \
    cmake \
    libpng-dev \
    libjpeg-dev \
    libtiff-dev \
    libgif-dev \
    zlib1g-dev

CentOS / Rocky / Alma

sudo yum groupinstall "Development Tools"
sudo yum install -y \
    libpng-devel \
    libjpeg-devel \
    libtiff-devel \
    giflib-devel \
    zlib-devel

三、获取 CxImage（Linux 适配版）

✅ 推荐：使用 GitHub 上的 Linux 移植版本

git clone https://github.com/WangTingMan/cximage.git
cd cximage

如果你找不到合适的 Linux 版本，也可以搜索： cximage linux port github

四、编译 CxImage（示例）

1️⃣ 进入源码目录

cd cximage

目录结构通常类似：

cximage/
├── CxImage/
│   ├── CxImage.cpp
│   ├── CxImagePng.cpp
│   └── ...
├── jpeg/
├── png/
├── zlib/
└── Makefile

2️⃣ 编译（Makefile 方式）

make

如果成功，会生成：

静态库：libcximage.a
或目标文件 .o

3️⃣ 若没有 Makefile，可手动编译

g++ -c CxImage/*.cpp -I. -Ijpeg -Ipng -Izlib
ar rcs libcximage.a *.o

五、集成到你的 Linux 项目

示例：CMake 集成

项目结构

project/
├── main.cpp
├── include/
│   └── CxImage/
├── lib/
│   └── libcximage.a
└── CMakeLists.txt

CMakeLists.txt

cmake_minimum_required(VERSION 3.10)
project(test_cximage)

include_directories(${PROJECT_SOURCE_DIR}/include)
include_directories(/usr/include/libpng /usr/include/libjpeg)

add_executable(test_cximage main.cpp)

target_link_libraries(test_cximage
    ${PROJECT_SOURCE_DIR}/lib/libcximage.a
    png
    jpeg
    z
)

编译：

mkdir build
cd build
cmake ..
make

六、示例代码（Linux）

#include "CxImage/ximage.h"
#include <iostream>

int main() {
    CxImage image;
    if (image.Load("test.jpg", CXIMAGE_FORMAT_JPG)) {
        image.Save("test.png", CXIMAGE_FORMAT_PNG);
        std::cout << "Convert success" << std::endl;
    }
    return 0;
}

七、常见问题

❓ Linux 下 CxImage 编译失败？

原因：

CxImage 使用 Windows API（如 BITMAPINFO）
部分代码需要条件编译

✅ 解决：

使用 Linux 移植版
或只启用 BMP / PNG / JPG
或直接改用 OpenCV / ImageMagick

❓ 是否推荐在 Linux 使用 CxImage？

场景	建议
新项目	❌ 不推荐
维护旧代码	✅ 可用
跨平台	❌ 不推荐
图像格式多	✅ ImageMagick

八、Linux 下的更佳替代方案 ✅

如果可以换库，推荐：

OpenCV（最常用）
ImageMagick（Magick++）
libpng + libjpeg

九、如果你愿意，我可以帮你：

✅ 找一个 可用的 CxImage Linux 移植版本
✅ 针对 你的 Linux 发行版 写完整编译脚本
✅ 帮你 把 CxImage 替换成 OpenCV
✅ 排查你当前的 编译错误

你可以直接贴：

Linux 版本
编译报错信息
使用场景（嵌入式 / 服务器 / 桌面）