cximage Linux环境配置步骤

CXImage在Linux环境下的配置步骤

1. 准备工作

确保Linux系统已更新（适用于Debian/Ubuntu/Fedora等主流发行版）：

sudo apt update && sudo apt upgrade  # Debian/Ubuntu
sudo dnf upgrade                     # Fedora/CentOS

安装必要工具链：

sudo apt install build-essential cmake git  # Debian/Ubuntu
sudo dnf groupinstall "Development Tools" && sudo dnf install cmake git  # Fedora/CentOS

2. 下载CXImage源码

从GitHub克隆最新版本（推荐）：
```
git clone https://github.com/antaresware/cximage.git
cd cximage
```
注：也可从官方网站下载源码压缩包，解压后进入目录。

3. 安装依赖库

CXImage依赖以下图像处理库，需提前安装对应开发包：

Debian/Ubuntu系统：

sudo apt install libpng-dev libjpeg-dev libtiff-dev

Fedora/CentOS系统：

sudo dnf install libpng-devel libjpeg-turbo-devel libtiff-devel

4. 编译与安装CXImage

创建构建目录并进入：
```
mkdir build && cd build
```
使用CMake生成Makefile（可自定义安装路径，如-DCMAKE_INSTALL_PREFIX=/usr/local）：
```
cmake ..
```

编译源码：

make -j$(nproc)  # 使用多核加速编译

安装到系统目录：
```
sudo make install
```
默认安装路径：头文件→/usr/local/include，库文件→/usr/local/lib。

5. 配置环境变量（可选但推荐）

为避免编译项目时找不到CXImage的头文件和库，需添加以下路径到环境变量：

编辑~/.bashrc（或~/.zshrc，根据shell类型）：

echo 'export CPLUS_INCLUDE_PATH=/usr/local/include:$CPLUS_INCLUDE_PATH' >> ~/.bashrc
echo 'export LIBRARY_PATH=/usr/local/lib:$LIBRARY_PATH' >> ~/.bashrc
echo 'export LD_LIBRARY_PATH=/usr/local/lib:$LD_LIBRARY_PATH' >> ~/.bashrc  # 动态链接库路径

使配置生效：
```
source ~/.bashrc
```

6. 验证安装

测试头文件是否存在：

ls /usr/local/include/cximage.h  # 应存在该文件

编译测试程序：
创建test_cximage.cpp，内容如下：

#include <iostream>
#include <cximage.h>
int main() {
    CXImage image;
    if (image.Load("test.jpg")) {  // 替换为本地图片路径
        std::cout << "Image loaded successfully!" << std::endl;
        image.Save("output.png");
    } else {
        std::cerr << "Failed to load image." << std::endl;
    }
    return 0;
}

编译并运行：
```
g++ test_cximage.cpp -o test_cximage -lcximage
./test_cximage
```
若输出“Image loaded successfully!”且生成output.png，则说明安装成功。

注意事项

若编译时出现依赖缺失错误，需根据提示安装对应开发包（如libgif-dev等）。
自定义安装路径时，需在CMake命令中指定-DCMAKE_INSTALL_PREFIX，并相应调整环境变量路径。
生产环境中建议使用静态链接（-static-libstdc++）或打包动态库，避免依赖冲突。