Python Pillow - ImageChops.add_modulo() 函数

---

---

PIL.ImageChops.add_modulo 函数用于添加两张图像，而不裁剪结果。与 add() 函数不同，该函数不会裁剪超过最大值 (MAX) 限制的值，而是进行循环运算，类似于模运算。

以下公式给出了此运算的数学表示：

$$ \mathrm{out\:=\:((image1\:+\:image2)\%\:MAX) }$$

与 ImageChops.add() 函数不同，此运算是可逆的，这意味着可以根据结果重建原始像素值。

语法

以下是该函数的语法：

PIL.ImageChops.add_modulo(image1, image2)

参数

以下是该函数参数的详细信息：

• image1 - 这是要添加到另一张图像的第一个输入图像。

• image2 - 这是要添加到第一张图像的第二个输入图像。

返回值

此函数返回 Image 对象。

示例

示例 1

在此示例中，使用 NumPy 数组创建两个随机 RGB 图像 (image1 和 image2)。然后应用 ImageChops.add_modulo() 函数，以查看在执行模加运算后，两个图像的像素值如何在输出图像中表示。

from PIL import Image, ImageChops
import numpy as np

# Create two random RGB images
image1 = Image.fromarray(np.array([(235, 64, 3), (255, 0, 0), (255, 255, 0), (255, 255, 255), (164, 0, 3)]), mode="RGB")
print("Pixel values of image1 at (0, 0):", image1.getpixel((0, 0)))

image2 = Image.fromarray(np.array([(255, 14, 3), (25, 222, 0), (255, 155, 0), (255, 55, 100), (180, 0, 78)]), mode="RGB")
print("Pixel values of image2 at (0, 0):", image2.getpixel((0, 0)))

# Add the two images without clipping the result
result = ImageChops.add_modulo(image1, image2)
print("Pixel values of the result at (0, 0) after add_modulo:", result.getpixel((0, 0)))

输出

Pixel values of image1 at (0, 0): (235, 0, 0)
Pixel values of image2 at (0, 0): (255, 0, 0)
Pixel values of the result at (0, 0) after add_modulo: (234, 0, 0)

示例 2

在此示例中，ImageChops.add_modulo() 函数用于两个 JPEG 图像文件，以添加图像而不裁剪结果。

from PIL import Image, ImageChops

# Open two image files
image1 = Image.open('Images/TP logo.jpg')
image2 = Image.open('Images/pillow-logo-S.jpg')

# Add the two images without clipping the result
result = ImageChops.add_modulo(image1, image2)

# Display the input and resulting images
image1.show()
image2.show()
result.show()

输出

输入图像 1

输入图像 2

输出图像

示例 3

这是一个使用 ImageChops.add_modulo() 函数对两个 PNG 图像文件添加图像而不裁剪结果的示例。

from PIL import Image, ImageChops

# Open two image files
image1 = Image.open('Images/ColorDots.png')
image2 = Image.open('Images/pillow-w.png')

# Add the two images without clipping the result
result = ImageChops.add_modulo(image1, image2)

# Display the input and resulting images
image1.show()
image2.show()
result.show()

输出

输入图像 1

输入图像 2

输出图像