libtiff读取多页TIFF的核心流程是手动遍历IFD链：先用TIFFSetDirectory切换目录，再TIFFGetField获取元信息，依Compression和Photometric选择TIFFReadEncodedStrip等接口解码，显式处理PlanarConfiguration、色彩空间转换与内存布局，不可依赖TIFFReadRGBAImage。
libtiff 读取多页 TIFF 的核心流程
TIFF 多页本质是多个 IFD（Image File Directory）链式组织，不是“一页一张图”简单叠加。libtiff 不提供自动遍历所有页的高层接口，必须手动跳转 IFD 并逐页解码。直接调用 TIFFReadRGBAImage 只能读第一页，这是最常踩的坑。
正确路径是：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，再手动合并。
立即学习“C++免费学习笔记（深入）”；
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
- 用
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<uint8_t> 和元数据结构，比追求“一键全解”更可靠。
