可以用于 Ubuntu 开发
cximage 是跨平台的 C++ 图像处理库，可在 Linux/Ubuntu 下使用 GCC 编译与链接，常见用途包括图像的加载、格式转换、缩放、旋转、亮度/对比度调整与灰度化等。它不自带 GUI，适合作为后台图像处理引擎嵌入到 Qt/GTK/FLTK 等桌面应用中。
快速上手步骤
- 安装依赖与工具
- 更新索引并安装编译工具与图像依赖：sudo apt update && sudo apt install -y build-essential cmake libpng-dev libjpeg-dev libgif-dev
- 获取源码并构建
- 克隆与编译（CMake 方式）：git clone https://github.com/cximage/cximage.git && cd cximage && mkdir build && cd build && cmake … && make -j$(nproc) && sudo make install
- 让系统识别库与头文件
- 更新动态库缓存：sudo ldconfig
- 可选（若未自动生效）：在 ~/.bashrc 中添加 export LD_LIBRARY_PATH=/usr/local/lib:$LD_LIBRARY_PATH 并 source ~/.bashrc
- 编译与运行测试
- 示例保存为 test.cpp，编译：g++ test.cpp -o test -lcximage
- 运行：./test
- 最小可用示例
- #include <cximage.h> 与 using namespace cximage;（按实际头文件为准）
- CxImage img; if (img.Load(“input.jpg”)) { img.GrayScale(); img.Save(“output.png”); }
- 编译：g++ test.cpp -o test -lcximage
常见问题与排查
- 链接错误 undefined reference
- 编译命令需显式链接：g++ your.cpp -o app -lcximage；若库不在默认路径，增加 -L/usr/local/lib
- 头文件找不到
- 确认头文件路径在包含路径中（/usr/local/include 或项目 -I 指定）；代码中按实际头文件名包含（如 “cximage.h” 或 “ximage.h”）
- 运行时找不到 libcximage.so
- 执行 sudo ldconfig /usr/local/lib 更新缓存，或临时设置 LD_LIBRARY_PATH 后再运行
- 旧版 GCC 兼容性
- 较老系统（如 Ubuntu 18.04）可尝试切换仓库的 gcc4-compatible 分支后重新编译
与 GUI 框架集成简述
- cximage 本身不提供界面，建议在 Qt/GTK/FLTK 等框架中编写 UI，在槽函数里调用 cximage 完成解码与处理，再将结果转为 QImage/QPixmap 显示。示例工程结构可用 CMake 管理，链接时 target_link_libraries(your_app … /usr/local/lib/libcximage.so)。
