CxImage在Ubuntu上的使用教程

在 Ubuntu 上使用 CxImage 的完整教程

一 环境准备与依赖安装

• 更新系统并安装编译工具与图像依赖库：
  • 安装工具链与常用依赖：sudo apt update & & sudo apt install -y build-essential cmake
  • 安装图像格式依赖：sudo apt install -y libpng-dev libjpeg-dev libtiff-dev zlib1g-dev
• 说明：CxImage 在 Linux 下以源码方式使用更常见，编译时需要系统已具备上述解码/编码库的开发头文件与库文件（.h 与 .so/.a）。

二 获取源码与编译安装

• 获取源码（两种常见方式，择一即可）：
  • 官方镜像仓库：git clone https://github.com/cximage/cximage.git
  • 社区维护仓库：git clone https://github.com/antaresware/cximage.git
• 编译与安装（推荐 CMake 方式）：
  • 在项目根目录执行：

    mkdir -p build &
        &
         cd build
    cmake -DCMAKE_BUILD_TYPE=Release ..
    make -j$(nproc)
    sudo make install
    

  • 安装完成后，头文件通常位于**/usr/local/include**，库文件位于**/usr/local/lib**（若使用发行版包管理器安装，则以包管理器路径为准）。

三 第一个示例程序 JPG 转 PNG

• 示例代码（保存为 main.cpp）：

  #include "ximage.h"
  #include <
      iostream>
  
  
  int main() {
      
      CxImage image;
  
      // 显式指定格式可避免自动探测失败
      if (!image.Load("input.jpg", CXIMAGE_FORMAT_JPG)) {
      
          std::cerr <
      <
       "加载 input.jpg 失败，请检查文件是否存在与格式是否受支持。\n";
      
          return -1;
  
      }
  
      if (!image.Save("output.png", CXIMAGE_FORMAT_PNG)) {
      
          std::cerr <
      <
       "保存 output.png 失败。\n";
      
          return -1;
  
      }
      
      std::cout <
      <
       "转换完成：input.jpg ->
       output.png\n";
      
      return 0;
  
  }
      
  

• 编译与运行（库名在不同发行版/构建方式下可能为 cximage 或 cximagecrt）：

  # 若链接名为 -lcximage
  g++ main.cpp -o main -I/usr/local/include -L/usr/local/lib -lcximage
  
  # 若链接名为 -lcximagecrt（某些构建会生成此名称）
  g++ main.cpp -o main -I/usr/local/include -L/usr/local/lib -lcximagecrt
  
  ./main
  

• 提示：
  • 若报“未定义引用”，请确认链接参数中的库名与安装目录是否一致。
  • 若报“找不到头文件”，请确认**-I**指向包含 ximage.h 的目录。

四 常见问题与排查

• 找不到库或头文件
  • 确认库与头文件安装路径（常见为**/usr/local/include/ximage.h与/usr/local/lib/libcximage.so**）。
  • 编译时显式指定：-I/usr/local/include -L/usr/local/lib，必要时在运行前设置LD_LIBRARY_PATH：

    export LD_LIBRARY_PATH=/usr/local/lib:$LD_LIBRARY_PATH
    

• 链接失败（undefined reference）
  • 检查库名是否为**-lcximage或-lcximagecrt**，并确认库文件确实存在。
  • 若使用静态库，需同时链接其依赖的编解码库（如libpng、libjpeg、libtiff、zlib），顺序通常为：目标库在前，依赖库在后。
• TIFF 相关编译问题
  • 部分旧版本在 Linux 下使用 TIFF 支持时，可能需要在构建前对源码打补丁（例如调整 TIFF 文件 I/O 适配层），否则会出现编译或运行时异常。
• 旧版 BMP 编解码问题
  • 个别旧版本在 Linux 下对 BMP 编解码存在结构体定义差异导致的偏移错误，需按平台调整相关结构体与写入逻辑后再编译。

五 进阶用法与实用命令

• 常用图像操作示例

  // 缩放
  image.Resample(800, 600);
      
  
  // 旋转（角度制）
  image.Rotate(90);
      
  
  // 保存为指定格式
  image.Save("resized.png", CXIMAGE_FORMAT_PNG);
      
  

• 构建与清理
  • 重新构建建议先清理：make clean
  • 并行编译加速：make -j$(nproc)
• 运行时库路径
  • 若未安装到系统目录，运行前可临时导出：export LD_LIBRARY_PATH=/usr/local/lib:$LD_LIBRARY_PATH
• 多格式支持
  • 确保系统已安装对应格式的开发库（如libpng-dev、libjpeg-dev、libtiff-dev、zlib1g-dev），CxImage 才能启用相应编解码器。

声明：本文内容由网友自发贡献，本站不承担相应法律责任。对本内容有异议或投诉，请联系2913721942#qq.com核实处理，我们将尽快回复您，谢谢合作！