从CXImage的官方GitHub仓库或官网下载最新稳定版本的源码包。推荐使用Git克隆仓库(确保网络畅通):
git clone https://github.com/antaresware/cximage.git
或下载压缩包后解压(如cximage-x.x.x.tar.gz
):
tar xzvf cximage-x.x.x.tar.gz
cd cximage-x.x.x
CXImage依赖libpng
、libjpeg
、libtiff
等图像处理库,需提前安装开发包(开发包包含头文件和静态/动态库)。
sudo apt update
sudo apt install build-essential libpng-dev libjpeg-dev libtiff-dev
sudo dnf groupinstall "Development Tools" # 安装编译工具链
sudo dnf install libpng-devel libjpeg-turbo-devel libtiff-devel
推荐使用CMake(跨平台构建工具)生成Makefile,避免手动配置的复杂性:
cd cximage
mkdir build # 创建构建目录(隔离源码与编译文件)
cd build
cmake .. # 生成Makefile(自动检测依赖)
make # 编译源码(多线程加速:make -j$(nproc))
若编译过程中出现jasper库头文件缺失(如jas_config.h
)错误,需手动指定jasper头文件路径(假设jasper安装在/usr/local/include
):
cmake .. -DWITH_JASPER=ON -DJASPER_INCLUDE_DIR=/usr/local/include
make
编译完成后,将库文件、头文件安装到系统目录(默认/usr/local/lib
和/usr/local/include
):
sudo make install
若需自定义安装路径(如/opt/cximage
),可在cmake
命令中添加-DCMAKE_INSTALL_PREFIX=/opt/cximage
。
为让系统识别CXImage的头文件和库文件,需添加路径到环境变量:
~/.bashrc
(或~/.zshrc
,根据shell类型):export CPLUS_INCLUDE_PATH=/usr/local/include:$CPLUS_INCLUDE_PATH # 头文件路径
export LIBRARY_PATH=/usr/local/lib:$LIBRARY_PATH # 库文件路径
source ~/.bashrc # 或 source ~/.zshrc
编写测试程序(test_cximage.cpp
),检查CXImage是否能正常加载和保存图像:
#include <iostream>
#include <cximage.h>
int main() {
CXImage image;
if (image.Load("test.png")) { // 替换为本地存在的图像路径
std::cout << "Image loaded successfully!" << std::endl;
image.Save("output.jpg"); // 保存为JPEG格式
return 0;
} else {
std::cerr << "Failed to load image!" << std::endl;
return 1;
}
}
编译并运行:
g++ test_cximage.cpp -o test_cximage -lcximage
./test_cximage
若输出Image loaded successfully!
,则说明CXImage配置成功。
CMakeLists.txt
中添加CXImage的路径:include_directories(/usr/local/include) # 头文件路径
link_directories(/usr/local/lib) # 库文件路径
target_link_libraries(your_target_name cximage) # 链接CXImage库
sudo
提升权限。