CXImage在Ubuntu环境如何运行

在 Ubuntu 上运行 CXImage 的完整指南

一安装方式选择

优先使用发行版包管理器安装（简单、稳定）：执行 sudo apt install libcximage-dev。安装后用 pkg-config --cflags --libs cximage 验证是否可用。若命令输出了编译与链接参数，说明开发文件与库已就绪。
若仓库版本过旧或需要特定分支/补丁，则从源码构建（可控、可定制）：安装构建工具与图像依赖后，使用 CMake 或 Autotools 构建并安装。

二方式一使用 APT 安装并验证

三方式二从源码构建

安装依赖与工具：sudo apt install build-essential cmake git；以及图像格式依赖 libpng-dev libjpeg-dev libtiff-dev libgif-dev libwebp-dev zlib1g-dev。
获取源码：git clone https://github.com/cximage/cximage.git && cd cximage。
构建与安装（CMake，推荐）：mkdir build && cd build && cmake … && make -j$(nproc) && sudo make install。
构建与安装（Autotools，备选）：执行 autotools 流程（如 aclocal、autoconf、automake）后 ./configure && make && sudo make install。
验证：pkg-config --cflags --libs cximage；若提示找不到，检查安装前缀是否为 /usr/local 并在需要时设置 PKG_CONFIG_PATH。
注意：旧版本（如 599c）在 TIFF 支持上可能需要补丁或额外配置，若使用老版本请参考对应说明。

四运行与集成要点

编译自己的程序：g++ main.cpp -o app $(pkg-config --cflags --libs cximage)；若未使用 pkg-config，可手动添加 -I/usr/local/include -L/usr/local/lib -lcximage。
头文件引用：常见为 #include “cximage.h” 或 #include <cximage.h>，以实际安装的头文件路径为准。
运行时库路径：若安装在 /usr/local/lib，可能需要导出 LD_LIBRARY_PATH=/usr/local/lib:$LD_LIBRARY_PATH，或将其写入 ~/.bashrc 并执行 source ~/.bashrc。
最小示例：
#include “cximage.h”
int main(){ CxImage img; if(img.Load(“in.png”, CXIMAGE_FORMAT_PNG)) img.Save(“out.jpg”, CXIMAGE_FORMAT_JPG); return 0; }
链接选项：多数发行版构建的库名为 libcximage.so，链接用 -lcximage；若你的构建产物名为 libCxImage.so，则改为 -lCxImage。

五常见问题与排查

找不到头文件或库：确认安装了 libcximage-dev；源码安装时检查 /usr/local/include/cximage.h 与 /usr/local/lib/libcximage.so 是否存在；必要时设置 CPLUS_INCLUDE_PATH、LIBRARY_PATH、LD_LIBRARY_PATH 或 PKG_CONFIG_PATH。
pkg-config 找不到 cximage：确认开发包已安装，或设置 PKG_CONFIG_PATH 指向包含 cximage.pc 的目录（如 /usr/local/lib/pkgconfig）。
链接失败：确保使用正确的链接标志（如 -lcximage 或 -lCxImage），并链接相关图像库（多数发行版已通过 .pc 文件或构建系统自动处理）。
老版本 TIFF 兼容问题：旧版源码（如 599c）在 tif_xfile.cpp 等处可能需要补丁；升级到新版本或按教程修补后再编译。

最新问答