CXImage如何配置CentOS环境

在 CentOS 上配置 CxImage 环境

一 准备与依赖

• 系统建议：CentOS 7/8/Stream（64 位），已安装可用的开发工具链。
• 安装编译与图像格式依赖（开发包）：
  • 安装开发工具组与基础依赖：
    • sudo yum groupinstall “Development Tools”
    • sudo yum install cmake
  • 安装图像编解码依赖（按需，建议全装以减少缺格式问题）：
    • sudo yum install libpng-devel libjpeg-devel libtiff-devel zlib-devel
• 说明：CxImage 在 Linux 下以第三方源码方式使用，需本地编译；上述依赖提供 PNG/JPEG/TIFF/ZLIB 等编解码支持。

二 获取源码与目录结构

• 获取源码（两种常用方式，二选一）：
  • 发布包：从官网下载源码压缩包（如 cximage-xxx.tar.gz），解压后进入目录。
  • Git 仓库：git clone https://github.com/DavidePizzolato/CxImage.git
• 目录要点：源码根目录通常包含 CxImage 子目录（含头文件如 ximage.h 与实现文件），以及若干示例/工具目录。后续构建与安装均在该源码根目录或其子目录中进行。

三 编译与安装

• 推荐采用 CMake 的“out-of-source”构建：
  1. 在源码根目录创建并进入构建目录：
     • mkdir build && cd build
  2. 生成 Makefile（默认会检测系统库并配置构建）：
     • cmake …
  3. 编译（可加 -j 并行）：
     • make -j$(nproc)
  4. 安装到系统目录（默认前缀为 /usr/local）：
     • sudo make install
• 安装完成后，头文件通常位于 /usr/local/include/CxImage，库文件位于 /usr/local/lib/libcximage.so（或 .a）。如需自定义安装前缀，可在 cmake 时指定 -DCMAKE_INSTALL_PREFIX=/your/path。

四 环境配置与验证

• 让系统找到头文件与库文件（若安装到 /usr/local，通常可省略；若自定义前缀需配置）：
  • 写入环境变量（示例为 ~/.bashrc 或 /etc/profile）：
    • echo ‘export CPLUS_INCLUDE_PATH=/usr/local/include:$CPLUS_INCLUDE_PATH’ >> ~/.bashrc
    • echo ‘export LIBRARY_PATH=/usr/local/lib:$LIBRARY_PATH’ >> ~/.bashrc
    • source ~/.bashrc
  • 运行时库搜索路径（可选，避免运行时找不到 .so）：
    • echo ‘/usr/local/lib’ | sudo tee /etc/ld.so.conf.d/cximage.conf
    • sudo ldconfig
• 编译与运行测试程序（示例）：
  • 保存为 test_cximage.cpp：
    • #include “ximage.h” #include int main() { CxImage image; if (image.Load(“test.jpg”, CXIMAGE_FORMAT_JPG)) { std::cout << “Image loaded successfully!\n”; image.Save(“out.png”, CXIMAGE_FORMAT_PNG); } else { std::cerr << “Failed to load image.\n”; } return 0; }
  • 编译与运行：
    • g++ test_cximage.cpp -o test_cximage -lcximage
    • ./test_cximage
• 常见排错要点：
  • 未找到头文件：检查 CPLUS_INCLUDE_PATH 是否包含 /usr/local/include/CxImage。
  • 未找到库文件：检查 LIBRARY_PATH 与 /etc/ld.so.conf.d/*.conf 是否包含 /usr/local/lib，并执行 ldconfig。
  • 格式不支持：确认已安装 libpng/libjpeg/libtiff/zlib 开发包，并在 CMake 配置阶段未被禁用。