This reference is for Processing 3.0+. If you have a previous version, use the reference included with your software in the Help menu. If you see any errors or have suggestions, please let us know. If you prefer a more technical reference, visit the Processing Core Javadoc and Libraries Javadoc.





example pic
PImage tower;

void setup() {
  size(100, 100);
  tower = loadImage("tower.jpg");
  int dimension = tower.width * tower.height;
  for (int i = 0; i < dimension; i += 2) { 
    tower.pixels[i] = color(0, 0, 0); 

void draw() {
  image(tower, 0, 0);
Description The pixels[] array contains the values for all the pixels in the image. These values are of the color datatype. This array is the size of the image, meaning if the image is 100 x 100 pixels, there will be 10,000 values and if the window is 200 x 300 pixels, there will be 60,000 values.

Before accessing this array, the data must loaded with the loadPixels() method. Failure to do so may result in a NullPointerException. After the array data has been modified, the updatePixels() method must be run to update the content of the display window.
pimg PImage: any object of type PImage
Updated on January 1, 2021 03:38:09am EST