Reference Manual: (offline | online) Quickstart: (offline | online)

# im.Composite

Function: im.Composite( | size, *args, **properties)

This image manipulator composites one or more images together.

This takes a variable number of arguments. The first argument is size, which is either the desired size of the image (in pixels), or None to indicate that the size should be the size of the first image.

It then takes an even number of further arguments. (For an odd number of total arguments.) The second and other even numbered arguments contain position tuples, while the third and further odd-numbered arguments give images (or image manipulators). A position argument gives the position of the image immediately following it, with the position expressed as a tuple giving an offset from the upper-left corner of the image. The images are composited in bottom-to-top order, with the last image being closest to the user.

## Example

    init:
        image cyan composite = im.Composite((200, 300),
                                            (0, 0), "cyan.png",
                                            (0, 50), "cyan.png",
                                            (0, 100), "cyan.png")

Reference Manual: (offline | online) Quickstart: (offline | online)