.alpha_composite()

In Pillow, the .alpha_composite() method merges two images by overlaying the foreground onto the background using their alpha (transparency) channels. It returns a new image with the composite result.

Syntax

PIL.Image.alpha_composite(image1, image2)

Parameters:

• image1 (Image): The background image, which must be in RGBA mode.
• image2 (Image): The foreground image, which must also be in RGBA mode.

Return value:

Returns a new RGBA image with the composite result.

Note: The .alpha_composite() method requires both image1 and image2 parameters to have the same dimensions (width and height); otherwise, it won’t work as expected.

Example

The following example demonstrates the use of the .alpha_composite() method:

from PIL import Image

# Open background and foreground images
background = Image.open("ocean.png").convert("RGBA")
foreground = Image.open("ship.png").convert("RGBA")

# Composite the images
result = Image.alpha_composite(background, foreground)

# Display and save the result
result.show()
result.save('ship-on-ocean.png')

to clipboard
Copy to clipboard

Original Background Image:

Original Foreground Image:

Result Composite Image: