get() \ Language (API) \ Processing 1.0
Author: Casey Reas & Ben Fry
Description: Processing is an electronic sketchbook for developing ideas. It is a context for learning fundamentals of computer programming within the context of the electronic arts.
Keywords: Processing, Processing, Interactive Media, Electronic Arts, Programming, Java, Ben Fry, Casey Reas

Reference for Processing version 1.5. If you have a previous version, use the reference included with your software. If you see any errors or have suggestions, please let us know. If you prefer a more technical reference, visit the Processing Javadoc.

Name | ### get()
Examples |
    PImage myImage = loadImage("topanga.jpg");
    image(myImage, 0, 0);
    PImage cp = get();
    image(cp, 50, 0);
    PImage myImage = loadImage("topanga.jpg");
    image(myImage, 0, 0);
    color cp = get(30, 20);
    fill(cp);
    rect(30, 20, 55, 55);
Description | Reads the color of any pixel or grabs a section of an image. If no parameters are specified, the entire image is returned. Get the value of one pixel by specifying an x,y coordinate. Get a section of the display window by specifying an additional width and height parameter. If the pixel requested is outside of 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. 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]". Processing requires calling loadPixels() to load the display window data into the pixels[] array before getting the values. As of release 0149, this function ignores imageMode().
Syntax |
    get()
    get(x, y)
    get(x, y, width, height)
Parameters |
x | int: x-coordinate of the pixel
y | int: y-coordinate of the pixel
width | int: width of pixel rectangle to get
height | int: height of pixel rectangle to get
Returns | color or PImage
Usage | Web & Application
Related | set() pixels[] imageMode

Updated on August 30, 2010 04:29:39pm EDT