qtoverlay - Python

Overview

qtoverlay is a simple Python library for overlaying one image on top of another. It is built on top of the popular Pillow library and offers a user-friendly interface to create overlays.

Installation

You can install qtoverlay using pip:

pip install qtoverlay

Usage

Overlaying Images

To overlay one image on top of another, simply call the overlay() function:

from qtoverlay import overlay

# open the base image
base_image = Image.open('base_image.png')

# open the overlay image
overlay_image = Image.open('overlay_image.png')

# overlay the images
overlay_result = overlay(base_image, overlay_image)

# display the result
overlay_result.show()

Customizing Overlays

qtoverlay offers several options to customize the overlay image. For example, you can adjust the opacity of the overlay image:

from qtoverlay import overlay

# open the base image
base_image = Image.open('base_image.png')

# open the overlay image
overlay_image = Image.open('overlay_image.png')

# overlay the images with opacity of 50%
overlay_result = overlay(base_image, overlay_image, opacity=0.5)

# display the result
overlay_result.show()

You can also specify the position of the overlay image:

from qtoverlay import overlay, Position

# open the base image
base_image = Image.open('base_image.png')

# open the overlay image
overlay_image = Image.open('overlay_image.png')

# overlay the images at position (10,10)
overlay_result = overlay(base_image, overlay_image, position=Position(x=10, y=10))

# display the result
overlay_result.show()

Saving Results

You can save the result of an overlay operation to a file by calling the save() method of the resulting image:

from qtoverlay import overlay

# open the base image
base_image = Image.open('base_image.png')

# open the overlay image
overlay_image = Image.open('overlay_image.png')

# overlay the images
overlay_result = overlay(base_image, overlay_image)

# save the result to a file
overlay_result.save('overlay_result.png')

Conclusion

qtoverlay offers a simple and user-friendly way to overlay images using Python. Its customizable options make it a versatile tool for image processing and manipulation.