TIFF多页传真文件的特殊性在于其采用CCITT Group 3/4压缩、PHOTOMETRIC_MINISWHITE光度解释（0=白，1=黑），且每页图像参数可能不同，需用libtiff显式检测压缩类型与光度模式并校正反色，OpenCV imread直接读取常因不支持传真模式而失败或显示全黑。
TIFF多页传真文件的特殊性在哪
普通TIFF文件用libtiff读一页很轻松，但传真（Group 3/4）TIFF往往带TIFFTAG_FAXMODE、TIFFTAG_COMPRESSION=COMPRESSION_CCITTFAX3或COMPRESSION_CCITTFAX4，且每页可能有不同TIFFTAG_IMAGEWIDTH和TIFFTAG_ROWSPERSTRIP。更麻烦的是：很多传真TIFF的TIFFTAG_PHOTOMETRIC是PHOTOMETRIC_MINISWHITE（0=白，1=黑），而OpenCV默认按PHOTOMETRIC_MINISBLACK解释，直接TIFFReadScanline出来图是反的。
关键判断：不能当普通TIFF处理，必须显式检查压缩类型和光度解释。
用libtiff逐页读取并校正黑白逻辑
libtiff本身不自动解码CCITT，但TIFFReadEncodedStrip或TIFFReadEncodedTile能返回原始压缩数据，再交由libtiff内置解码器（需编译时启用LIBTIFF_CONFIG_SUPPORT_CCITT）处理。多数预编译包已支持，但务必验证：
- 调用
TIFFGetField(tif, TIFFTAG_COMPRESSION, &comp)确认comp是COMPRESSION_CCITTFAX3或COMPRESSION_CCITTFAX4 - 用
TIFFGetField(tif, TIFFTAG_PHOTOMETRIC, &photometric)判断是否为PHOTOMETRIC_MINISWHITE；若是，后续解码后需对每个像素做255 - pixel翻转 - 每页调用
TIFFSetDirectory(tif, page_index)切换目录，再用TIFFReadImage（自动解码+格式转换）比手动读strip更稳——但它默认输出uint8BGR顺序，注意通道布局
示例片段：
立即学习“C++免费学习笔记（深入）”；
TIFF* tif = TIFFOpen("fax.tiff", "r");
uint16 comp, photometric;
TIFFGetField(tif, TIFFTAG_COMPRESSION, &comp);
TIFFGetField(tif, TIFFTAG_PHOTOMETRIC, &photometric);
bool is_white_is_zero = (photometric == PHOTOMETRIC_MINISWHITE);
<p>for (int page = 0; TIFFSetDirectory(tif, page) == 1; page++) {
uint32 w, h;
TIFFGetField(tif, TIFFTAG_IMAGEWIDTH, &w);
TIFFGetField(tif, TIFFTAG_IMAGELENGTH, &h);
std::vector<uint8_t> buf(w * h);
if (TIFFReadImage(tif, buf.data(), w, h, 0, 0)) {
if (is_white_is_zero) {
for (auto& p : buf) p = 255 - p;
}
// buf now holds correct 8-bit grayscale
}
}
TIFFClose(tif);OpenCV imread直接加载为什么失败或变黑
cv::imread("fax.tiff", cv::IMREAD_GRAYSCALE)在多数OpenCV版本里会绕过libtiff，走内部TIFF loader，而该loader对CCITT压缩支持不全，尤其遇到PHOTOMETRIC_MINISWHITE时直接忽略，导致整页纯黑（因为0被当黑显示）。OpenCV 4.8+虽增强TIFF支持，但仍不保证传真模式全覆盖。
- 不要依赖
imread直接读传真TIFF，这是最常见踩坑点 - 若坚持用OpenCV，可先用
libtiff读成cv::Mat，再传给OpenCV处理，避免双重解码 -
cv::imdecode对TIFF无效——它只支持JPEG/PNG等内存buffer格式，TIFF必须走文件IO路径
如何快速验证TIFF是否为传真格式
终端一行命令最省事：tiffinfo fax.tiff（来自libtiff-tools包）。重点关注三行：
-
Compression Scheme: CCITT Group 3或CCITT Group 4 Photometric Interpretation: min-is-white-
Page Number: 1-n（确认多页）
如果tiffinfo报错“cannot read TIFF directory”，说明文件头损坏或非标准封装——这类传真TIFF常由老旧传真机生成，需先用tiffcp -c none input.tiff output.tiff尝试修复结构，再解析。
传真TIFF的坑不在代码量，而在光度解释和压缩模式的组合判断。漏查PHOTOMETRIC_MINISWHITE会导致整批图像反色，漏判COMPRESSION_CCITTFAX4可能让TIFFReadImage返回0字节。实际处理时，先用tiffinfo看清楚元数据，比写十行代码调试更快。
