Linux下cximage配置步驟

Linux下CXImage配置步驟

1. 下載CXImage源碼

從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

2. 安裝依賴庫

CXImage依賴libpng、libjpeg、libtiff等圖像處理庫，需提前安裝開發包（開發包包含頭文件和靜態/動態庫）。

• Debian/Ubuntu系統：

  sudo apt update
  sudo apt install build-essential libpng-dev libjpeg-dev libtiff-dev
  

• Red Hat/CentOS/Fedora系統：

  sudo dnf groupinstall "Development Tools"  # 安裝編譯工具鏈
  sudo dnf install libpng-devel libjpeg-turbo-devel libtiff-devel
  

3. 編譯CXImage

推薦使用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

4. 安裝CXImage

編譯完成后，將庫文件、頭文件安裝到系統目錄（默認/usr/local/lib和/usr/local/include）：

sudo make install

若需自定義安裝路徑（如/opt/cximage），可在cmake命令中添加-DCMAKE_INSTALL_PREFIX=/opt/cximage。

5. 配置環境變量

為讓系統識別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
  

6. 驗證安裝

編寫測試程序（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配置成功。

注意事項

• 若使用CMake構建項目，需在CMakeLists.txt中添加CXImage的路徑：

  include_directories(/usr/local/include)  # 頭文件路徑
  link_directories(/usr/local/lib)        # 庫文件路徑
  target_link_libraries(your_target_name cximage)  # 鏈接CXImage庫
  

• 若遇到權限問題，可在安裝或編譯時使用sudo提升權限。
• 若依賴庫版本不兼容（如libjpeg版本過高），需調整依賴庫版本或修改CXImage源碼適配。