debian编译cximage要注意啥

在 Debian 上编译 CxImage（一个老牌的 C++ 图像处理库）时，有几个常见坑和注意点，下面按「准备 → 编译 → 常见问题」给你梳理一下。

一、编译前的准备

1. 安装基础编译环境

sudo apt update
sudo apt install build-essential g++ make

如果你要用 autotools / cmake，也要装：

sudo apt install cmake

2. CxImage 源码结构（很重要）

CxImage 不是“一个库”，而是一组模块：

cximage/
├── CxImage/
├── CxImageCrt/
├── jpeg/
├── png/
├── tiff/
├── zlib/
├── jasper/
├── mng/
└── ...

很多子目录是 第三方库源码（jpeg/png/tiff 等），编译方式不统一。

二、常见编译方式

方式 1：用官方 VC 工程思路在 Linux 手动编（最常用）

CxImage 官方主要面向 Windows（VC++），Linux 下一般：

• 自己写 Makefile
• 或只编译你需要的部分（比如 CxImage + jpeg + png）

示例最小编译：

g++ -I. -I./CxImage -I./jpeg -I./png \
    *.cpp ./jpeg/*.cpp ./png/*.cpp \
    -o test_cx

⚠️ 注意：

• 不要直接 g++ *.cpp，会重复定义
• 第三方库要单独编成 .a 或 .o

方式 2：用 CMake（社区维护）

有些 fork 提供了 CMake：

mkdir build
cd build
cmake ..
make

但原版 CxImage 没有官方 CMake，要小心版本兼容性。

三、Debian 上特别容易踩的坑

1. 头文件大小写问题（非常常见）

CxImage 早期代码里常写：

#include "CxImage.h"

但在 Linux 上文件名是：

cximage.h

解决：

sed -i 's/CxImage.h/cximage.h/g' *.cpp

或改代码（推荐）

2. BOOL / TRUE / FALSE 未定义

Linux 下没有 Windows 的 windef.h

解决（加在公共头或编译参数）：

typedef int BOOL;
#define TRUE 1
#define FALSE 0

或在编译时：

-DBOOL=int -DTRUE=1 -DFALSE=0

3. min / max 宏冲突

CxImage 会用：

std::min / std::max

但老代码直接写 min(a,b)，在 GCC 下报错。

解决：

#define NOMINMAX

或改成 std::min

4. 第三方库版本冲突

Debian 自带：

libjpeg-dev
libpng-dev
libtiff-dev

强烈建议：

• 用系统库，而不是 CxImage 自带的旧 jpeg/png
• 否则容易 ABI 不兼容

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

然后只编译 CxImage 核心。

5. C++ 标准问题

CxImage 很老，建议：

-std=c++98 或 -std=c++11

不要用太新的标准（如 c++20）

四、推荐在 Debian 上的“稳妥方案”

✅ 最省事做法：

1. 用系统库（jpeg/png/tiff）
2. 只编译 CxImage 核心
3. 封装成静态库 .a

示例：

g++ -c -I. cximage.cpp -o cximage.o
ar rcs libcximage.a cximage.o

五、如果你只是“想用图像处理”

说句实话：CxImage 已严重过时（最后更新大约 2013 年）。

在 Debian 上更推荐：

• OpenCV
• FreeImage
• stb_image（单文件）

除非你维护老项目，否则不建议新项目用 CxImage。

如果你愿意，可以告诉我：

• Debian 版本（11 / 12？）
• 是否需要 静态库 / 动态库
• 用到哪些格式（jpg/png/tiff？）

我可以直接给你一份能编译的 Makefile。