cximage Linux版本怎么用

Linux 下使用 CXImage 的完整指南

一 准备与依赖

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

二 编译与安装

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

三 环境配置与验证

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

四 命令行与编程示例

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

五 常见问题与排查

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