cximage Linux使用技巧有哪些

一、安装CXImage库

1. 准备依赖环境：
   不同Linux发行版的依赖安装命令有所差异。Debian/Ubuntu系统需运行：sudo apt update && sudo apt install build-essential libpng-dev libjpeg-dev libtiff-dev；CentOS/RHEL系统需运行：sudo yum groupinstall "Development Tools" && sudo yum install libpng-devel libjpeg-turbo-devel。这些依赖是CXImage编译和运行的基础。
2. 获取源码：
   可通过GitHub克隆最新版本（如git clone https://github.com/antiresware/cximage.git），或从官方网站下载稳定版源码包。
3. 编译与安装：
   进入源码目录，创建并进入build目录，执行cmake ..生成Makefile，再通过make编译，最后用sudo make install将库文件安装到系统目录（默认路径为/usr/local/lib和/usr/local/include）。
4. 配置环境变量（可选）：
   若编译时提示找不到头文件或库，可将以下内容添加到~/.bashrc或~/.zshrc中：export CPLUS_INCLUDE_PATH=/usr/local/include:$CPLUS_INCLUDE_PATH（头文件路径）、export LIBRARY_PATH=/usr/local/lib:$LIBRARY_PATH（库文件路径），然后运行source ~/.bashrc使配置生效。

二、项目集成配置

1. CMakeLists.txt设置：
   在项目中创建CMakeLists.txt文件，添加以下内容以关联CXImage：

   cmake_minimum_required(VERSION 3.10)
   project(YourProjectName)
   set(CMAKE_CXX_STANDARD 11)
   include_directories(/usr/local/include)  # CXImage头文件路径
   link_directories(/usr/local/lib)        # CXImage库文件路径
   target_link_libraries(YourTargetName cximage libjpeg libpng libtiff)  # 链接CXImage及依赖库
   

   替换YourProjectName和YourTargetName为实际项目名称。
2. 编译项目：
   在项目根目录执行mkdir build && cd build && cmake .. && make，即可生成可执行文件。

三、基本图像操作

1. 加载与保存图像：
   使用CxImage类的Load和Save方法实现格式转换。示例代码：

   #include "cximage.h"
   int main() {
       CxImage image;
       if (!image.Load("input.jpg", CXIMAGE_FORMAT_JPG)) {
           std::cerr << "加载图像失败！" << std::endl;
           return -1;
       }
       if (!image.Save("output.png", CXIMAGE_FORMAT_PNG)) {
           std::cerr << "保存图像失败！" << std::endl;
           return -1;
       }
       return 0;
   }
   

   编译时需链接CXImage库：g++ your_program.cpp -o your_program -lcximage。
2. 图像缩放与旋转：
   • 缩放：使用Resample方法指定目标宽度和高度（第二个参数为0时保持比例），如image.Resample(800, 0)将图像宽度缩至800像素，高度自动调整。
   • 旋转：使用Rotate方法指定旋转角度（顺时针），如image.Rotate(90)将图像顺时针旋转90度。
3. 滤镜效果应用：
   CXImage提供多种滤镜，如灰度化（GrayScale()）、高斯模糊（GaussianBlur(3)，3为模糊半径）、锐化（Sharpen()）、亮度调整（AdjustBrightness(20)，增加20亮度）、对比度调整（AdjustContrast(1.2)，提高20%对比度）、饱和度调整（AdjustSaturation(0.8)，降低20%饱和度）。

四、常见问题解决

1. 编译错误：
   • 无法解析外部符号：检查是否遗漏依赖库（如libjpeg、libpng），编译时需添加对应链接选项（如-ljpeg -lpng）。
   • 重复定义错误：确保项目运行库设置与CXImage库一致（如均使用多线程DLL或静态库）。
2. 运行时问题：
   • 库文件路径错误：若运行时提示libcximage.so not found，需将CXImage库路径添加到LD_LIBRARY_PATH环境变量（如export LD_LIBRARY_PATH=/usr/local/lib:$LD_LIBRARY_PATH），或修改/etc/ld.so.conf后运行sudo ldconfig更新缓存。
   • 版本兼容性：确保CXImage版本与编译环境（如GCC版本）匹配，避免因API变更导致错误。