cximage Linux版本如何用

Linux 下使用 CXImage 的完整指南

一 准备与依赖

1. 安装编译工具与基础依赖（以发行版为例）：
   1. Debian/Ubuntu：
      1. sudo apt-get update
      2. sudo apt-get install -y build-essential cmake libpng-dev libjpeg-dev libtiff-dev libgif-dev
   2. RHEL/CentOS/Fedora：
      1. sudo dnf groupinstall “Development Tools”
      2. sudo dnf install -y cmake libpng-devel libjpeg-turbo-devel libtiff-devel giflib-devel
2. 获取源码：
   1. 常见做法是从官方页面下载源码包（如 cximagexxx.zip/tar.gz），解压后进入目录；也可在 GitHub 搜索社区维护的镜像仓库（搜索关键词：cximage）。CXImage 在 Linux 下通常需自行编译使用。

二 编译与安装

1. 目录结构要点：CXImage 源码通常包含用于编解码的“基础库”（如 zlib、jpeg、png、tiff、raw 等）与封装后的 C++ 接口库（生成 libcximage.so）。推荐先编译基础库，再编译主库与示例。
2. 方式 A（经典 Make，很多教程与旧包使用）：
   1. 进入源码根目录，直接执行：
      1. make
      2. sudo make install
   2. 若子目录（基础库）需要先编译，请先进入对应子目录依次 make，再回到根目录 make。
3. 方式 B（CMake，部分仓库提供 CMakeLists.txt）：
   1. mkdir build && cd build
   2. cmake -DCMAKE_INSTALL_PREFIX=/usr/local …
   3. make -j$(nproc)
   4. sudo make install
4. 安装后文件通常位于：/usr/local/include/cximage.h、/usr/local/lib/libcximage.so（具体以 Makefile/CMake 配置为准）。

三 环境配置与验证

1. 让系统找到头文件与库文件（写入 ~/.bashrc 或 /etc/profile.d/cximage.sh 并 source 使其生效）：
   1. 头文件路径：export CPLUS_INCLUDE_PATH=/usr/local/include:$CPLUS_INCLUDE_PATH
   2. 库路径：export LIBRARY_PATH=/usr/local/lib:$LIBRARY_PATH
   3. 运行时库搜索路径：export LD_LIBRARY_PATH=/usr/local/lib:$LD_LIBRARY_PATH
2. 可选：刷新动态链接缓存
   1. sudo ldconfig
3. 快速验证（C++）：
   1. 代码示例（保存为 test.cpp）：
      1. #include <cximage.h>#include int main(){ CXImage img; if(img.Load(“test.png”)) std::cout<<“OKn”; else std::cerr<<“FAILn”; return 0; }
   2. 编译运行：
      1. g++ test.cpp -o test -lcximage
      2. ./test
4. 若提示找不到库，请确认 LD_LIBRARY_PATH 包含 /usr/local/lib，或已执行 sudo ldconfig。

四 命令行与编程示例

1. 命令行工具（若发行版或包提供了 cximage 命令行）：
   1. 格式转换示例：
      1. cximage -i input.jpg -o output.png -format png
      2. cximage -i input.png -o output.jpg -format jpg
   2. 注意：并非所有源码包都自带命令行工具，若没有，可用下方编程方式实现相同功能。
2. 编程示例
   1. 图像格式转换（C++）：
      1. #include <cximage.h>int main(){ CXImage img; if(img.Load(“in.jpg”) && img.Save(“out.png”,CXIMAGE_FORMAT_PNG)) return 0; return 1; }
      2. 编译：g++ convert.cpp -o convert -lcximage
   2. 图像裁剪（C++）：
      1. #include <cximage.h>int main(){ CXImage img; if(!img.Load(“in.jpg”)) return 1; if(!img.Crop(100,100,200,200)) return 1; img.Save(“out.jpg”); return 0; }
      2. 编译：g++ crop.cpp -o crop -lcximage
   3. 编译要点：CXImage 为 C++ 库，链接时加 -lcximage；若报未定义引用，确认链接顺序与库路径正确。

五 常见问题与排查

1. 找不到头文件或库：检查 CPLUS_INCLUDE_PATH、LIBRARY_PATH、LD_LIBRARY_PATH 是否包含安装前缀（如 /usr/local/include、/usr/local/lib），必要时执行 sudo ldconfig。
2. 链接失败（undefined reference）：确保使用 g++ 而非 gcc 链接 C++ 代码，并加上 -lcximage；若库不在默认路径，使用 -L/usr/local/lib。
3. 基础库未先编译导致链接错误：先编译子目录中的基础库（如 png、jpeg、tiff 等），再编译主库。
4. 发行版差异：部分发行版/教程使用 configure + make 流程，若源码包未提供 configure，请使用其自带 Makefile 或改用 CMake 方式。