Ubuntu CxImage自定义设置

Ubuntu 下 CxImage 自定义设置指南

一 环境准备与源码获取

• 安装构建工具与图像依赖：
  • 构建工具：build-essential cmake
  • 图像库：libpng-dev libjpeg-dev libtiff-dev libgif-dev
  • 可选：libwebp-dev（启用 WebP 支持）
• 获取源码（任选其一，注意不同仓库的 API/构建系统 可能不同）：
  • git clone https://github.com/antaresware/cximage.git
  • git clone https://github.com/antoniogarrote/cxImage.git
• 建议目录结构：将源码放在如 ~/src/cximage 下，便于多版本管理。

二 自定义构建与安装路径

• 标准构建安装（默认安装到 /usr/local）：
  • mkdir build && cd build
  • cmake -DCMAKE_BUILD_TYPE=Release …
  • make -j$(nproc)
  • sudo make install
• 自定义安装前缀（便于多版本并存与打包）：
  • cmake -DCMAKE_INSTALL_PREFIX=/opt/cximage/3.0 -DCMAKE_BUILD_TYPE=Release …
  • make -j$(nproc) && sudo make install
• 安装后头文件与库的典型路径：
  • 头文件：/opt/cximage/3.0/include
  • 库文件：/opt/cximage/3.0/lib/libcximage.so
• 后续项目编译示例（按你的前缀调整 -I/-L/-l）：
  • g++ app.cpp -o app -I/opt/cximage/3.0/include -L/opt/cximage/3.0/lib -lcximage
• 若使用系统包管理器安装开发包（如 libcximage-dev），可直接获得头文件与库，但自定义能力受限；源码构建便于开启/关闭编解码器与做深度定制。

三 启用或禁用编解码器与功能开关

• 常见做法（不同仓库可能提供不同的 CMake 选项或 config 头）：
  • 开启 WebP：安装 libwebp-dev，在 CMake 中打开相应开关（如 -DWITH_WEBP=ON），随后重新构建安装。
  • 开启 TIFF/GIF：安装 libtiff-dev/libgif-dev，并在构建配置中启用相关选项（如 -DWITH_TIFF=ON -DWITH_GIF=ON）。
  • 关闭不需要的编解码器：关闭相应开关以减少依赖与体积（如 -DWITH_JPEG=OFF 等）。
• 验证编解码器是否生效（C++ 示例）：
  • #include <cximage.h> int main(){ CXImage i; i.Load(“test.png”); i.Save(“out.jpg”); return 0; }
  • 编译：g++ demo.cpp -I/opt/cximage/3.0/include -L/opt/cximage/3.0/lib -lcximage
  • 若保存失败，通常是对应编码器未启用或库未安装。
• 提示：不同仓库的开关名称与默认行为可能不同，请以实际仓库的 CMakeLists.txt/README 为准。

四 自定义滤镜与处理管线

• 思路：在你的应用中链接 libcximage，对 CxImage 对象进行处理后保存。
• 示例（灰度滤镜）：
  • #include <cximage.h> bool Grayscale(CxImage& img){ if(img.IsNull()) return false; long w=img.GetWidth(),h=img.GetHeight(); for(long y=0;y<h;++y){ for(long x=0;x<w;++x){ RGBQUAD c; img.GetPixelColor(x,y,&c); BYTE g=(BYTE)(0.299c.rgbRed+0.587c.rgbGreen+0.114c.rgbBlue); c.rgbRed=c.rgbGreen=c.rgbBlue=g; img.SetPixelColor(x,y,&c); } } return true; } int main(int argc,char argv[]){ if(argc!=3){ printf(“Usage: %s in out\n”,argv[0]); return 1; } CxImage img; if(!img.Load(argv[1])) return 1; Grayscale(img); img.Save(argv[2]); return 0; }
  • 编译：g++ -o custom_filter custom_filter.cpp -I/opt/cximage/3.0/include -L/opt/cximage/3.0/lib -lcximage
  • 运行：./custom_filter input.jpg output.jpg
• 扩展建议：
  • 性能优化：对大图按分块/多线程处理，必要时使用 SIMD（如 SSE/AVX）。
  • 管线组合：Resize → Filter → FormatConvert，统一在内存中完成，减少磁盘 I/O。

五 运行环境与常见问题处理

• 运行时库路径：
  • 若安装到 /usr/local 或自定义前缀，运行前确保动态库可被找到：
    • 临时：export LD_LIBRARY_PATH=/opt/cximage/3.0/lib:$LD_LIBRARY_PATH
    • 永久：写入 /etc/ld.so.conf.d/cximage.conf（内容为：/opt/cximage/3.0/lib），然后执行 sudo ldconfig
• 头文件与链接路径（开发时）：
  • 可写入 ~/.bashrc 或项目 CMakeLists.txt 的 include_directories / link_directories，便于统一管理多个版本。
• 常见问题速查：
  • 找不到头文件：检查 -I 路径是否为你的安装前缀 include。
  • 链接失败：检查 -L 路径与 -lcximage 名称，确认库文件存在。
  • 保存失败（如 JPG/PNG 不支持）：确认相应编解码器已启用且依赖库已安装，再重新构建安装。
  • 多版本并存：使用不同的 CMAKE_INSTALL_PREFIX，通过 LD_LIBRARY_PATH 或 ldconfig 精确切换运行时版本。