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 才能启用相应编解码器。

0 赞

0 踩