Class Name



Datatype for storing images. Processing can display .gif, .jpg, .tga, and .png images. Images may be displayed in 2D and 3D space. Before an image is used, it must be loaded with the loadImage() function. The PImage class contains fields for the width and height of the image, as well as an array called pixels[] that contains the values for every pixel in the image. The methods described below allow easy access to the image's pixels and alpha channel and simplify the process of compositing.

Before using the pixels[] array, be sure to use the loadPixels() method on the image to make sure that the pixel data is properly loaded.

To create a new image, use the createImage() function. Do not use the syntax new PImage().


  • PImage photo;
    void setup() {
      size(400, 400);
      photo = loadImage("Toyokawa-city.jpg");
    void draw() {
      image(photo, 0, 0);
    Image output for example 1


  • PImage(width, height, format, factor)
  • PImage(width, height, pixels, requiresCheckAlpha, parent)
  • PImage(width, height, pixels, requiresCheckAlpha, parent, format, factor)
  • PImage(img)


  • pixels[]Array containing the color of every pixel in the image
  • widthThe width of the image in units of pixels
  • heightThe height of the image in units of pixels


  • loadPixels()Loads the pixel data for the image into its pixels[] array
  • updatePixels()Updates the image with the data in its pixels[] array
  • resize()Resize the image to a new width and height
  • get()Reads the color of any pixel or grabs a rectangle of pixels
  • set()Writes a color to any pixel or writes an image into another
  • mask()Masks part of an image with another image as an alpha channel
  • filter()Converts the image to grayscale or black and white
  • copy()Copies the entire image
  • blendColor()Blends two color values together based on the blending mode given as the MODE parameter
  • blend()Copies a pixel or rectangle of pixels using different blending modes
  • save()Saves the image to a TIFF, TARGA, PNG, or JPEG file