cxImage在Debian中的实际应用案例

在 Debian 中，cxImage 常用于命令行批量格式转换、C++ 应用中的缩放与旋转、以及裁剪等典型场景。下面给出可直接复用的案例与要点。

命令行批量格式转换

• 安装与依赖
  • 更新索引并安装开发包：sudo apt update && sudo apt install libcximage-dev
  • 可选：安装常用图像库开发包以支持更多格式：libpng-dev、libjpeg-dev、libtiff-dev、libgif-dev
• 转换示例
  • 将 JPEG 转为 PNG：cximage -i input.jpg -o output.png -format png
  • 将 PNG 转为 JPEG：cximage -i input.png -o output.jpg -format jpg
  • 将 GIF 转为 JPEG：cximage -i input.gif -o output.jpg -format jpg
  • 将 TIFF 转为 PNG：cximage -i input.tif -o output.png -format png
• 说明
  • 上述命令依赖系统 PATH 中的 cximage 工具；若命令不存在，请确认已安装 libcximage-dev 或改用源码安装的可执行文件。

C++ 应用示例 缩放与旋转

• 代码示例（缩放与旋转）
  • 缩放至指定尺寸（如 800×600）并保存：

    #include "ximage.h"
    #include <iostream>
    int main() {
        CxImage image;
        if (!image.Load("input.jpg", CXIMAGE_FORMAT_JPG)) {
            std::cerr << "加载图像失败！" << std::endl;
            return -1;
        }
        if (!image.Resample(800, 600)) {
            std::cerr << "缩放图像失败！" << std::endl;
            return -1;
        }
        if (!image.Save("resized.jpg", CXIMAGE_FORMAT_JPG)) {
            std::cerr << "保存缩放后的图像失败！" << std::endl;
            return -1;
        }
        std::cout << "图像缩放成功！" << std::endl;
        return 0;
    }
    

  • 旋转 90° 并保存：

    #include <iostream>
    #include "cximage.h"
    int main() {
        CXImage image;
        if (!image.Load("input.jpg")) {
            std::cerr << "无法加载图像文件。" << std::endl;
            return 1;
        }
        image.Rotate(90);
        if (!image.Save("output.jpg")) {
            std::cerr << "无法保存图像文件。" << std::endl;
            return 1;
        }
        std::cout << "图像已成功旋转并保存。" << std::endl;
        return 0;
    }
    

• 编译与运行
  • 编译：g++ -o rotate_image rotate_image.cpp -lcximage
  • 运行：./rotate_image
• 说明
  • 缩放使用 Resample，旋转使用 Rotate；两者均依赖已安装的 libcximage-dev。

C++ 应用示例 裁剪

• 代码示例（从坐标 (100,100) 开始裁剪 200×200 区域）

  #include <iostream>
  #include "cxImage.h"
  int main() {
      cxImage image;
      if (!image.Load("input.jpg")) {
          std::cerr << "无法加载图像文件" << std::endl;
          return 1;
      }
      int x = 100, y = 100, w = 200, h = 200;
      if (!image.Crop(x, y, w, h)) {
          std::cerr << "裁剪失败" << std::endl;
          return 1;
      }
      if (!image.Save("output.jpg")) {
          std::cerr << "保存裁剪后的图像失败" << std::endl;
          return 1;
      }
      std::cout << "图像裁剪并保存成功" << std::endl;
      return 0;
  }
  

• 编译与运行
  • 编译：g++ -o crop_image crop_image.cpp -lcximage
  • 运行：./crop_image
• 说明
  • 裁剪区域必须在图像范围内，否则会失败；路径与权限需正确设置。

部署与最佳实践

• 安装与验证
  • 优先使用 APT：sudo apt update && sudo apt install libcximage-dev
  • 验证编译与链接参数：pkg-config --cflags --libs cximage
• 源码构建（当仓库无包时）
  • 安装构建工具与依赖：sudo apt install build-essential cmake libpng-dev libjpeg-dev libtiff-dev libgif-dev
  • 构建与安装（示例）：

    git clone https://github.com/antoniogarrote/cxImage.git
    cd cxImage
    mkdir build && cd build
    cmake ..
    make
    sudo make install
    

• 运行与链接
  • 编译选项：在链接阶段加入 -lcximage
  • 运行时库路径：若安装在 /usr/local/lib，可设置 LD_LIBRARY_PATH，例如：export LD_LIBRARY_PATH=/usr/local/lib:$LD_LIBRARY_PATH
• 格式支持扩展
  • 需要 WebP 等额外格式时，安装相应开发库（如 libwebp-dev）并重新构建。