如何用Pillow根据二值掩码修改PNG的RGB值？附ImageChops报错问题

原始需求 #

我有一张PNG图像和一张黑白掩码，之前了解过用putalpha()设置alpha通道让掩码区域透明，但现在需要把掩码区域的RGB值直接改成255（纯白）——最终图像的白色区域要是实际的RGB(255,255,255)，不是仅设置alpha为0。

问题更新：使用ImageChops报错 #

尝试用ImageChops处理时遇到错误，代码如下：

from PIL import Image, ImageChops

im = Image.open('lena.jpg')
mask = Image.open('mask_circle.png')

print(im, mask)
darker = ImageChops.darker(im, mask)
darker.save('darker.png')

报错信息：

<PIL.JpegImagePlugin.JpegImageFile image mode=RGB size=400x225 at 0x24725330BF0> <PIL.PngImagePlugin.PngImageFile image mode=RGBA size=400x225 at 0x24724F2CD40>
Traceback (most recent call last):
  File "E:\test.py", line 7, in <module>
    darker = ImageChops.darker(im, mask)
             ^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "C:\...\Local\Programs\Python\Python312\Lib\site-packages\PIL\ImageChops.py", line 81, in darker
    return image1._new(image1.im.chop_darker(image2.im))
                       ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
ValueError: images do not match

解决方法 #

1. 报错原因及前置处理 #

报错核心是两张图像模式不匹配：原图为RGB模式，掩码为RGBA模式。需要先将掩码转为与原图一致的模式，同时确保掩码是黑白单通道（L模式）或RGB模式的黑白图。

2. 实现掩码区域转纯白的两种方案 #

方案一：使用Image.composite()（简洁高效）

该方法可直接通过掩码将指定区域替换为纯白：

from PIL import Image

# 打开并统一图像模式
im = Image.open('lena.jpg').convert('RGB')
mask = Image.open('mask_circle.png').convert('L')  # 转为单通道灰度掩码（白区域为255，黑为0）

# 创建与原图尺寸一致的纯白图像
white_img = Image.new('RGB', im.size, (255, 255, 255))

# 合成图像：掩码白色区域显示纯白图，黑色区域保留原图
result = Image.composite(white_img, im, mask)
result.save('result_white.png')

方案二：像素级操作（自定义性强）

适合需要更精细逻辑控制的场景：

from PIL import Image

im = Image.open('lena.jpg').convert('RGB')
mask = Image.open('mask_circle.png').convert('L')

# 获取图像像素列表
mask_pixels = list(mask.getdata())
im_pixels = list(im.getdata())

# 遍历替换像素：掩码为255的位置替换为纯白
new_pixels = []
for im_pix, mask_pix in zip(im_pixels, mask_pixels):
    new_pixels.append((255, 255, 255) if mask_pix == 255 else im_pix)

# 生成并保存结果图
result = Image.new('RGB', im.size)
result.putdata(new_pixels)
result.save('result_white_pixel.png')

关键注意事项 #

• 掩码需转为单通道灰度图（L模式），白色对应需替换的区域，黑色对应保留原图的区域
• 若掩码为RGBA模式，转L模式时会自动忽略alpha通道，仅保留RGB灰度值
• 合成前需确保所有图像的尺寸完全一致

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