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。

0 赞

0 踩