cxImage在Debian上的安装教程

在 Debian 上安装与使用 CXImage 的完整教程

一 安装方式概览

• 方式一 使用发行版仓库安装（推荐优先尝试）
  • 更新索引并安装开发包：sudo apt update && sudo apt install libcximage-dev
  • 验证：pkg-config --cflags --libs cximage（能输出版本与链接参数即成功）
• 方式二 从源码构建（仓库无包或需要自定义时）
  • 安装构建依赖：sudo apt install build-essential cmake git libpng-dev libjpeg-dev libtiff-dev libgif-dev
  • 获取源码并构建（两种常见仓库，任选其一）
    • 仓库A：git clone https://github.com/antaressoftware/cxImage.git
    • 仓库B：git clone https://github.com/oneiric/CXImage.git
  • 构建安装：mkdir build && cd build && cmake … && make && sudo make install
  • 验证：pkg-config --cflags --libs cximage；若提示找不到，见下文“常见问题”。

二 编译与验证最小示例

• 准备测试代码 test_cxImage.cpp
  • C++ 示例

    #include <iostream>
    #include "CXImage.h"
    int main() {
        CXIMAGE img;
        if (img.Load("test.jpg")) {
            std::cout << "Image loaded successfully!\n";
        } else {
            std::cerr << "Failed to load image.\n";
        }
        return 0;
    }
    

  • C 示例

    #include <stdio.h>
    #include <stdlib.h>
    #include "cxImage.h"
    int main(int argc, char* argv[]) {
        if (argc != 4) {
            printf("Usage: %s <input> <output> <format>\n", argv[0]);
            return 1;
        }
        CXIMAGE* image = new CXIMAGE();
        if (!image->Load(argv[1])) {
            printf("Failed to load image: %s\n", argv[1]);
            delete image;
            return 1;
        }
        if (!image->Save(argv[2], argv[3])) {
            printf("Failed to save image: %s\n", argv[2]);
            delete image;
            return 1;
        }
        delete image;
        printf("Convert success.\n");
        return 0;
    }
    

• 编译与运行
  • C++：g++ -o test_cxImage test_cxImage.cpp -lcximage && ./test_cxImage
  • C：gcc -o convert_image convert_image.c -lcximage && ./convert_image input.jpg output.png png
• 说明
  • 示例默认头文件为 CXImage.h（C++）或 cxImage.h（C）。若你的发行版或源码目录结构不同，请以实际头文件路径为准。

三 在项目中集成

• 直接使用命令行编译
  • g++ your_app.cpp -o your_app -lcximage（必要时加上 -I/usr/local/include -L/usr/local/lib）
• 使用 CMake
  • 最简示例 CMakeLists.txt

    cmake_minimum_required(VERSION 3.10)
    project(MyApp)
    set(CMAKE_CXX_STANDARD 11)
    include_directories(/usr/local/include)
    link_directories(/usr/local/lib)
    add_executable(myapp main.cpp)
    target_link_libraries(myapp cximage)
    

  • 构建：mkdir build && cd build && cmake … && make。

四 常见问题与处理

• pkg-config 找不到 cximage
  • 确认已安装开发包：sudo apt install libcximage-dev
  • 源码安装到 /usr/local 后，创建文件 /usr/local/lib/pkgconfig/cximage.pc，内容示例：

    prefix=/usr/local
    exec_prefix=${prefix}
    libdir=${exec_prefix}/lib
    includedir=${prefix}/include
    Name: cximage
    Description: CXImage image library
    Version: 7.02
    Libs: -L${libdir} -lcximage
    Cflags: -I${includedir}
    

  • 让 pkg-config 能搜索到：export PKG_CONFIG_PATH=/usr/local/lib/pkgconfig:$PKG_CONFIG_PATH
• 运行时报找不到库
  • 临时：export LD_LIBRARY_PATH=/usr/local/lib:$LD_LIBRARY_PATH
  • 永久：将 /usr/local/lib 加入 /etc/ld.so.conf 或创建文件 /etc/ld.so.conf.d/local.conf，内容为 /usr/local/lib，然后执行 sudo ldconfig
• 头文件找不到
  • 确认头文件位置（常见为 /usr/local/include/CXImage.h 或 /usr/include/CXImage.h），编译时加 -I 指定正确路径
• 需要更多图像格式支持
  • 安装相应开发库（如 libwebp-dev 等），然后重新编译 cxImage。