- Processing
- p5.js
- Processing.py
- Processing for Android
- Processing for Pi

- Processing Foundation

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.

Class | PImage
Name | ### pixels[]
Examples |
    PImage tower;

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

    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.
Syntax |
    pimg.pixels[]
Parameters |
pimg | PImage: any object of type PImage

Updated on January 1, 2021 03:38:09am EST
This work is licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License.