Name
get()
Class
PImage
Description
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 x
and y parameters to get the value of one pixel. Get a section of
the display window by specifying an additional width and
height parameter. When getting an image, the x and
y parameters define the coordinates for the upper-left corner of
the image, regardless of the current imageMode().
If the pixel requested is outside the image window, 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 colorMode(HSB), the
numbers returned will be in RGB format.
Getting the color of a single pixel with get(x, y) is easy, but
not as fast as grabbing the data directly from pixels[]. The
equivalent statement to get(x, y) using pixels[] is
pixels[y*width+x]. See the reference for pixels[] for more information.
Examples
PImage sky = loadImage("tokyo-sky.jpg");; size(400, 400); background(sky); noStroke(); color c = sky.get(240, 360); fill(c); rect(100, 100, 200, 200);
PImage sky = loadImage("tokyo-sky.jpg"); size(400, 400); background(sky); PImage newSky = sky.get(200, 0, 200, 400); image(newSky, 0, 0);
Syntax
pimg.get(x, y)
pimg.get(x, y, w, h)
pimg.get()
Parameters
pimg
(PImage)
any object of type PImagex
(int)
x-coordinate of the pixely
(int)
y-coordinate of the pixelw
(int)
width of pixel rectangle to geth
(int)
height of pixel rectangle to get
Return
int or PImage
This work is licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License.