Python Pillow - ImageChops.logical_or() Function

---

---

The Python image processing library Pillow (PIL) provides several functions within its ImageChops module for performing arithmetical operations on images.

The PIL.ImageChops.logical_or() function performs a logical OR operation between corresponding pixels of two input images. Both input images must have mode "1", representing binary (black-and-white) images.

The logical_or operation is defined as follows −

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

Syntax

Following is the syntax of the function −

PIL.ImageChops.logical_or(image1, image2)

Parameters

Here are the details of this function parameters −

• image1 − The first input binary image with mode "1".

• image2 − The second input binary image with mode "1".

Return Value

The return type of this function is an Image.

Examples

Example 1

Here is an example that uses the ImageChops.logical_or() function to perform a logical AND operation between two binary images, which are created by the NumPy arrays.

from PIL import Image, ImageChops
import numpy as np

# Create two binary images with mode "1"
array1 = np.array([(255, 64, 3), (255, 0, 0), (255, 255, 0), (255, 255, 255), (164, 0, 3)], dtype=np.uint8)
array2 = np.array([(20, 14, 3), (25, 222, 0), (255, 155, 0), (255, 55, 100), (180, 0, 78)], dtype=np.uint8)

image1 = Image.fromarray(array1, mode="1")
image2 = Image.fromarray(array2, mode="1")

# Display the pixel values of the two input images
print("Pixel values of image1 at (0, 0):", image1.getpixel((0, 0)))
print("Pixel values of image2 at (0, 0):", image2.getpixel((0, 0)))

# Perform logical OR between the two images
result = ImageChops.logical_or(image1, image2)

# Display the pixel values of the resulting image at (0, 0)
print("Pixel values of the result at (0, 0) after logical OR:", result.getpixel((0, 0)))

Output

Pixel values of image1 at (0, 0): 255
Pixel values of image2 at (0, 0): 0
Pixel values of the result at (0, 0) after logical OR: 255

Example 2

In this example, the PIL.ImageChops.logical_or() function is used to perform a logical OR operation on two binary images (image1 and image2).

from PIL import Image, ImageChops

image1 = Image.open('Images/dark_img1.png').convert('1')
image2 = Image.open('Images/dark_img2.png').convert('1')

# Perform logical OR between the two images
result = ImageChops.logical_or(image1, image2)

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

Output

Input Image 1

Input Image 2

Output Image

Example 3

Here is another example of applying the logical_or() function on different set of input images.

from PIL import Image, ImageChops

# Create two binary images with mode "1"
image1 = Image.open('Images/Car_2.jpg').convert('1')
image2 = Image.open('Images/ColorDots.png').convert('1')

# Perform logical OR between the two images
result = ImageChops.logical_or(image1, image2)

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

Output

Input Image 1

Input Image 2

Output Image