c++如何解析TIFF格式图像的多页数据【进阶】

先说说 TiFF 多页读取的核心问题。很多人以为多页 TIFF 就像翻书一样，一页就是一页，直接调用 TIFFReadRGBAImage 就能搞定——这其实是个大坑。实际上，TIFF 的多页机制是多个 IFD（Image File Directory）链式组织起来的，libtiff 并没有提供自动遍历所有页的高层接口。你只能逐个 IFD 跳转过去，一页一页解码。

正确的做法是：先用 TIFFSetDirectory 切换当前 IFD，然后通过 TIFFGetField 获取该页的元信息（比如宽度、高度、压缩类型、样本数等），接着根据 Photometric 和 Compression 选择对应的读取方式——TIFFReadScanline、TIFFReadEncodedStrip 或 TIFFReadEncodedTile。最后，手动分配缓冲区并转换像素布局。

这里面有几个容易忽略的细节：

• 每次 TIFFSetDirectory 后一定要检查返回值，失败意味着该 IFD 无效或已越界。
• 页数不能靠 TIFFNumberOfDirectories 预判后循环——有些 TIFF 文件末尾有损坏的 IFD，硬循环会直接崩溃。
• 如果需要 RGBA 输出，别依赖 TIFFReadRGBAImage，它内部不处理 CMYK 或 Lab 色彩空间，遇到这类情况会静默降级为灰度，结果可能完全不是你想要的。

LZW/ZIP 压缩与 PlanarConfiguration=2 的陷阱

多页 TIFF 在扫描文档或显微图像里很常见，这类文件特别喜欢用 LZW 或 Deflate 压缩，还动不动就启用 PlanarConfiguration=2（也就是平面分离的像素格式）。libtiff 默认支持解压，但前提是编译时启用了对应的 codec。链接 -ltiff 之前，务必确认系统 libtiff 是带 zlib + lzip 支持的版本——比如 Ubuntu 的 libtiff-dev 包。否则读到压缩页时，会返回 0，TIFFGetErrorMessage 显示“Unknown compression method”。

再说 PlanarConfiguration=2。这意味着 R/G/B 数据分别存在不同的 strip 里，不能用 TIFFReadRGBAScanline 直接读——它只适配 PlanarConfiguration=1（交错存储）。这时候必须用 TIFFReadEncodedStrip 分别读取每个 plane，再手动合并。

• 用 TIFFGetField(tif, TIFFTAG_PLANARCONFIG, &config) 显式检查配置，别假设默认是 1。
• 读取 strip 前，先调用 TIFFStripSize 获取单个 strip 的字节数，避免缓冲区溢出。
• LZW 解压失败常见于文件被截断。如果 TIFFReadEncodedStrip 返回 -1，立即 break 并停止处理下一页，不要继续。

内存布局与色彩空间转换的自主控制

libtiff 默认输出原生样本格式——比如 uint16 的 16-bit 灰度、uint8 的 CMYK，不会自动做归一化或色彩空间转换。所谓的“解析出图像”，通常是指得到 CPU 可以直接处理的 RGBA_8888 内存块。这一步必须自己实现，不能指望库帮你完成。

关键字段需要组合判断：BitsPerSample 决定数据位宽，SamplesPerPixel 和 Photometric 共同决定通道语义——例如 PHOTOMETRIC_SEPARATED + SamplesPerPixel=4 极大概率是 CMYK。还有 Orientation，它影响扫描线顺序：ORIENTATION_TOPLEFT 是标准，ORIENTATION_BOTLEFT 则需要垂直翻转。

• 16-bit 数据写入 8-bit 缓冲区前，必须做缩放。比如 (uint16_t*)src[i] >> 8，或者更准确的线性映射 (src[i] * 255) / 65535。
• CMYK 转 RGB 没有唯一标准。libtiff 自带的 TIFFCIELabToRGB 不适用。建议用 ICC profile（通过 TIFFTAG_ICCPROFILE 读取），或者用简化公式：R = 255*(1-C)*(1-K)，G = 255*(1-M)*(1-K)，B = 255*(1-Y)*(1-K)。
• 所有转换操作必须在每页独立完成。不同页可能有不同的 BitsPerSample 或 Photometric，不能假设统一。

跨平台读取 BigTIFF 与混合压缩页的兼容策略

现在的多页 TIFF 经常是 BigTIFF 格式（支持超过 4GB），或者单文件里混用了 LZW、JPEG、未压缩页。libtiff 4.0+ 原生支持 BigTIFF，但旧版本（比如 CentOS 7 自带的 4.0.3）对某些 JPEG-in-TIFF 的 subsampling 组合——比如 YCbCrSubsampling=(2,2)——解码会失败，报错“No JPEG support in this configuration”，即使链接了 -ljpeg 也没用。

解决路径不是升级系统 libtiff（可能会影响其他软件），而是编译自定义 libtiff：下载源码，configure 时显式启用 --with-jpeg --with-zlib --with-lzma，并指定 --enable-bigtiff。生成的静态库 libtiff.a 链入项目，就能彻底隔离环境差异。

• 运行时用 TIFFIsBigTIFF 快速识别格式，非 BigTIFF 无需走大文件逻辑。
• 遇到 COMPRESSION_JPEG 页，优先尝试 TIFFReadRGBAScanline（它内置 JPEG 解码）；失败则回退到 TIFFReadRawScanline + 外部 libjpeg 解码。
• 混合压缩页中，TIFFCurrentDirectory 返回的目录索引不连续，必须用 TIFFSetDirectory 逐个试探，直到返回 0。

多页 TIFF 解析真正的复杂点不在代码量，而在于每一页都可能是独立的小世界：不同压缩、不同位深、不同色彩模型、不同存储布局。把“读一页”封装成可重入函数，传入 TIFF* 和目录号，返回统一的 std::vector 和元数据结构，比追求“一键全解”更可靠。