# Py5Image.update_pixels()

Updates the image with the data in its [](py5image_pixels) array.

## Examples

<div class="example-table">

<div class="example-row"><div class="example-cell-image">

![example picture for update_pixels()](/images/reference/Py5Image_update_pixels_0.png)

</div><div class="example-cell-code">

```python
def setup():
    global my_image
    global half_image
    half_image = py5.width * py5.height//2
    my_image = py5.load_image("apples.jpg")
    my_image.load_pixels()
    for i in range(0, half_image):
        my_image.pixels[i+half_image] = my_image.pixels[i]

    my_image.update_pixels()


def draw():
    py5.image(my_image, 0, 0)
```

</div></div>

</div>

## Description

Updates the image with the data in its [](py5image_pixels) array. Use in conjunction with [](py5image_load_pixels). If you're only reading pixels from the array, there's no need to call `update_pixels()`.

Underlying Processing method: [PImage.updatePixels](https://processing.org/reference/PImage_updatePixels_.html)

## Signatures

```python
update_pixels() -> None

update_pixels(
    x: int,  # x-coordinate of the upper-left corner
    y: int,  # y-coordinate of the upper-left corner
    w: int,  # width
    h: int,  # height
    /,
) -> None
```

Updated on March 06, 2023 02:49:26am UTC