Matplotlib用plt.imsave导出PDF时白色变灰、导出PNG却显示正常
问题复现与排查结论
- 基础使用场景:调用
plt.imsave('output.pdf', myImg)导出PDF,其中myImg是取值范围0-255的uint8类型三维RGB数组,所有像素仅为纯黑(0,0,0)、纯白(255,255)两种取值 - 异常表现:导出的PDF中纯白像素渲染为中灰色,黑色像素显示正常
- 交叉验证结果:
- 相同代码导出PNG格式文件时,黑白像素色彩完全准确
- 多个PDF查看器(Adobe Acrobat、Google Chrome、GIMP)打开导出的PDF均复现色彩异常,排除查看器故障
- 显式传入
vmin=0, vmax=255参数调整归一化范围,导出结果无变化,排除数值映射逻辑问题 - 重装Python环境前,相同代码运行完全正常,问题为环境更新后引入
问题根源
这个异常是Matplotlib版本迭代引入的PDF后端bug:Matplotlib 3.7及以上版本在写入矢量格式PDF时,会自动对检测到的二值黑白图像执行sRGB到灰度色彩空间的gamma转换,原本的255纯白值在转换流程中被错误映射为中灰值。而plt.imsave的vmin/vmax参数仅控制数组数值到内置colormap的映射逻辑,无法干预后端导出矢量文件时的色彩空间转换流程,因此调整这类参数不会修复问题。
可落地的修复方案
- 强制栅格化嵌入图像,绕过矢量导出的色彩转换流程
放弃直接调用plt.imsave存PDF的逻辑,手动创建无坐标轴的画布,将图像设置为栅格对象后再保存:import matplotlib.pyplot as plt # 按图像实际尺寸创建无边框、无留白的画布 fig = plt.figure(figsize=(myImg.shape[1]/100, myImg.shape[0]/100), frameon=False) ax = fig.add_axes([0, 0, 1, 1]) ax.set_axis_off() ax.imshow(myImg, vmin=0, vmax=255) # 保存时开启栅格化,指定适配的输出分辨率 fig.savefig('output.pdf', dpi=300, format='pdf', rasterized=True) - 调整Matplotlib的PDF导出全局参数,关闭自动色彩压缩逻辑
在调用存图函数前修改全局配置,跳过二值图像的自动重映射:plt.rcParams['pdf.image.compress'] = False plt.rcParams['pdf.fonttype'] = 42 plt.imsave('output.pdf', myImg) - 版本回退
临时将Matplotlib降级到3.6.x版本,该版本的PDF后端未引入二值图像自动色彩转换的逻辑,可直接复现之前的正常导出效果。
内容的提问来源于stack exchange,提问作者Matt McConaha
相关产品推荐
相关产品推荐

