a port of the Processing Visualization Language
Class PImage
Name

loadPixels()

Examples
example pic
// @pjs preload must be used to preload the image
/* @pjs preload="topanga.jpg"; */
int halfImage = width*height/2;
PImage myImage = loadImage("topanga.jpg");
myImage.loadPixels();
for (int i = 0; i < halfImage; i++) {
  myImage.pixels[i+halfImage] = pixels[i];
}
myImage.updatePixels();
image(myImage, 0, 0);
Description

Loads the pixel data for the image into its pixels[] array. This function must always be called before reading from or writing to pixels[].

Certain renderers may or may not seem to require loadPixels() or updatePixels(). However, the rule is that any time you want to manipulate the pixels[] array, you must first call loadPixels(), and after changes have been made, call updatePixels(). Even if the renderer may not seem to use this function in the current Processing release, this will always be subject to change.

Syntax
img.loadPixels()
Parameters
img PImage: any variable of type PImage
Returns void
Usage Web & Application

This reference is licensed under the CC BY-NC-SA 2.0 license:

Creative Commons License
Fork me on GitHub