This reference is for Processing 2.0+. 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.

Class | PImage
Name | ### copy()
Examples |
    PImage apples;

    void setup() {
      size(100, 100);
      apples = loadImage("apples.jpg");
      int x = width/2;
      apples.copy(x, 0, x, height, 0, 0, x, height);
    }

    void draw() {
      image(apples, 0, 0);
    }
Description | Copies a region of pixels from one image into another. If the source and destination regions aren't the same size, it will automatically resize source pixels to fit the specified target region. No alpha information is used in the process, however if the source image has an alpha channel set, it will be copied as well. As of release 0149, this function ignores imageMode().
Syntax |
    pimg.copy(sx, sy, sw, sh, dx, dy, dw, dh)
    pimg.copy(src, sx, sy, sw, sh, dx, dy, dw, dh)
Parameters |
pimg | PImage: any object of type PImage
sx | int: X coordinate of the source's upper left corner
sy | int: Y coordinate of the source's upper left corner
sw | int: source image width
sh | int: source image height
dx | int: X coordinate of the destination's upper left corner
dy | int: Y coordinate of the destination's upper left corner
dw | int: destination image width
dh | int: destination image height
src | PImage: an image variable referring to the source image.
Returns | void
Related | blend()

Updated on May 19, 2014 05:30:02pm PDT