如何用libvips将含渐变的PDF栅格化为16位深度图像？

首先明确核心事实：

• libvips依赖的PDF渲染库（poppler或libpdfium）本身支持16位栅格化，但pdfload接口默认返回8位图像
• 要生成真16位TIFF，必须先将加载后的8位图像转换为16位格式，再执行保存操作

正确实现代码 #

import pyvips

# 加载PDF指定页面，设置目标分辨率
img = pyvips.Image.pdfload('test.pdf', page=0, n=1, dpi=300)
# 将8位图像转换为16位无符号整数格式，同时把0-255的色彩范围映射到0-65535
# 257是65535/255的精确值，确保渐变细节无损失
img_16bit = img.cast('ushort') * 257
# 保存为16位LZW压缩TIFF
img_16bit.tiffsave('t.tif', compression='lzw', bitdepth=16)

关键细节说明 #

1. 格式转换的必要性：pdfload默认输出8位图像，直接指定bitdepth=16保存只会把8位数据填充到16位容器中，本质还是8位精度。必须通过cast转换为16位类型后，再缩放数值范围才能获得真16位数据。
2. 数值映射逻辑：8位像素值（0-255）乘以257刚好对应16位的全范围（0-65535），能完整保留PDF中的渐变过渡细节，避免量化损失。
3. 底层库能力：无论是poppler还是libpdfium，都具备16位栅格化能力，但libvips上层接口默认采用8位以平衡性能和内存占用，需要手动触发高比特深度处理。

额外注意事项 #

• 确保使用的pyvips版本≥2.10.0，旧版本可能存在cast或tiffsave参数兼容问题
• 彩色PDF场景下，上述逻辑同样适用，RGB三个通道会被自动转换并映射范围

内容的提问来源于stack exchange，提问作者matth