debian怎样集成cximage

在 Debian 上“集成 CXImage”通常指两件事之一：

在 C/C++ 项目中直接使用 CXImage 源码
把 CXImage 编译成库（静态/动态），供其他程序调用

下面按最常见、最实用的方式说明（以 Debian 11/12 为例）。

一、准备编译环境

sudo apt update
sudo apt install -y build-essential git unzip

如果你要用 PNG / JPEG / TIFF 等格式，建议安装：

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

二、获取 CXImage 源码

CXImage 官方源码通常是 Windows 风格工程，但在 Linux 下可以直接用源码编译。

cd ~
git clone https://github.com/oscarbg/cximage.git
# 或手动下载 zip 解压

进入目录：

cd cximage

典型结构：

cximage/
├── CxImage/
│   ├── *.cpp
│   └── *.h
├── jpeg/
├── png/
├── tiff/
└── zlib/

三、编译为静态库（推荐）

1. 编译 CXImage 核心

cd CxImage
g++ -c *.cpp -I. -fPIC
ar rcs libcximage.a *.o

生成：

libcximage.a

2.（可选）编译依赖库

如果你使用自带 jpeg/png/tiff：

cd ../jpeg
g++ -c *.c -fPIC
ar rcs libjpeg.a *.o

cd ../png
g++ -c *.c -fPIC
ar rcs libpng.a *.o

四、在你的项目中集成

示例项目结构

myproject/
├── main.cpp
├── include/
│   └── CxImage.h
└── lib/
    └── libcximage.a

main.cpp

#include "CxImage.h"
#include <iostream>

int main() {
    CxImage image;
    if (image.Load("test.png", CXIMAGE_FORMAT_PNG)) {
        std::cout << "Width: " << image.GetWidth() << std::endl;
    }
    return 0;
}

编译

g++ main.cpp -Iinclude \
  -Llib -lcximage \
  -lpng -ljpeg -lz \
  -o myapp

五、编译为动态库（可选）

g++ -shared -fPIC *.cpp -I. -o libcximage.so

使用：

export LD_LIBRARY_PATH=$PWD
g++ main.cpp -lcximage -o myapp

六、Debian 下的注意事项

1. 头文件大小写

Linux 区分大小写：

#include "CxImage.h"  // 正确
#include "cximage.h"  // 可能失败

2. 去掉 Windows 特有代码

源码中可能包含：

#ifdef WIN32

Linux 下默认不走，一般无需修改。

3. 字符编码

Linux 默认 UTF-8，Windows 常用 GBK，路径含中文时注意转换。

七、简单验证

./myapp

能正确读取图片即集成成功。

如果你愿意，我可以：

帮你写一份 Debian Makefile
帮你封装成 CMake 项目
或说明 CXImage 在 Qt / GTK 项目中的用法

你现在是打算在 命令行 C++ 项目 还是 GUI 项目 里用？