PImage::pixels[] / Reference / Processing.org

Name

pixels[]

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 be 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.

Examples

```
PImage tower;

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

void draw() {
  image(tower, 0, 0);
}
```

Syntax

pimg.pixels[]

Parameters

pimg

This work is licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License.