Reads the color of any pixel or grabs a section of an image.
1 2 3 4 5 6 7
def setup(): mountains = py5.load_image("rockies.jpg") py5.background(mountains) py5.no_stroke() c = mountains.get(60, 90) py5.fill(c) py5.rect(25, 25, 50, 50)
1 2 3 4 5
def setup(): mountains = py5.load_image("rockies.jpg") py5.background(mountains) new_mountains = mountains.get(50, 0, 50, 100) py5.image(new_mountains, 0, 0)
Reads the color of any pixel or grabs a section of an image. If no parameters are specified, the entire image is returned. Use the
y parameters to get the value of one pixel. Get a section of the image by specifying additional
h parameters. When getting an image, the
y parameters define the coordinates for the upper-left corner of the returned image, regardless of the current image_mode().
If the pixel requested is outside of the image, black is returned. The numbers returned are scaled according to the current color ranges, but only
RGB values are returned by this function. For example, even though you may have drawn a shape with
color_mode(HSB), the numbers returned will be in
Getting the color of a single pixel with
get(x, y) is easy, but not as fast as grabbing the data directly from Py5Image.pixels. The equivalent statement to
get(x, y) using Py5Image.pixels is
pixels[y*width+x]. See the reference for Py5Image.pixels for more information.
Underlying Processing method: PImage.get
get() -> Py5Image get(x: int, y: int, /) -> int get(x: int, y: int, w: int, h: int, /) -> Py5Image
h: int - height of pixel rectangle to get
w: int - width of pixel rectangle to get
x: int - x-coordinate of the pixel
y: int - y-coordinate of the pixel
Updated on November 12, 2021 11:30:58am UTC