Py5Graphics.image()#

The image() function draws an image to the Py5Graphics drawing surface.

Description#

The image() function draws an image to the Py5Graphics drawing surface. Images must be in the Sketch’s “data” directory to load correctly. Py5 currently works with GIF, JPEG, and PNG images.

The img parameter specifies the image to display and by default the a and b parameters define the location of its upper-left corner. The image is displayed at its original size unless the c and d parameters specify a different size. The Py5Graphics.image_mode() function can be used to change the way these parameters draw the image.

Use the u1, u2, v1, and v2 parameters to use only a subset of the image. These values are always specified in image space location, regardless of the current Py5Graphics.texture_mode() setting.

The color of an image may be modified with the Py5Graphics.tint() function. This function will maintain transparency for GIF and PNG images.

This method is the same as image() but linked to a Py5Graphics object. To see example code for how it can be used, see image().

Underlying Processing method: PGraphics.image

Signatures#

image(
    img: Py5Image,  # the image to display
    a: float,  # x-coordinate of the image by default
    b: float,  # y-coordinate of the image by default
    /,
) -> None

image(
    img: Py5Image,  # the image to display
    a: float,  # x-coordinate of the image by default
    b: float,  # y-coordinate of the image by default
    c: float,  # width to display the image by default
    d: float,  # height to display the image by default
    /,
) -> None

image(
    img: Py5Image,  # the image to display
    a: float,  # x-coordinate of the image by default
    b: float,  # y-coordinate of the image by default
    c: float,  # width to display the image by default
    d: float,  # height to display the image by default
    u1: int,  # x-coordinate of the upper left corner of image subset
    v1: int,  # y-coordinate of the upper left corner of image subset
    u2: int,  # x-coordinate of the lower right corner of image subset
    v2: int,  # y-coordinate of the lower right corner of image subset
    /,
) -> None

Updated on September 01, 2022 14:08:27pm UTC