public class MemoryImageSource extends Object implements ImageProducer
      int w = 100;
      int h = 100;
      int pix[] = new int[w * h];
      int index = 0;
      for (int y = 0; y < h; y++) {
          int red = (y * 255) / (h - 1);
          for (int x = 0; x < w; x++) {
              int blue = (x * 255) / (w - 1);
              pix[index++] = (255 << 24) | (red << 16) | blue;
          }
      }
      Image img = createImage(new MemoryImageSource(w, h, pix, 0, w));
 
      int pixels[];
      MemoryImageSource source;
      public void init() {
          int width = 50;
          int height = 50;
          int size = width * height;
          pixels = new int[size];
          int value = getBackground().getRGB();
          for (int i = 0; i < size; i++) {
              pixels[i] = value;
          }
          source = new MemoryImageSource(width, height, pixels, 0, width);
          source.setAnimated(true);
          image = createImage(source);
      }
      public void run() {
          Thread me = Thread.currentThread( );
          me.setPriority(Thread.MIN_PRIORITY);
          while (true) {
              try {
                  Thread.sleep(10);
              } catch( InterruptedException e ) {
                  return;
              }
              // Modify the values in the pixels array at (x, y, w, h)
              // Send the new data to the interested ImageConsumers
              source.newPixels(x, y, w, h);
          }
      }
 ImageProducer| Constructor and Description | 
|---|
| MemoryImageSource(int w,
                 int h,
                 ColorModel cm,
                 byte[] pix,
                 int off,
                 int scan)Constructs an ImageProducer object which uses an array of bytes
 to produce data for an Image object. | 
| MemoryImageSource(int w,
                 int h,
                 ColorModel cm,
                 byte[] pix,
                 int off,
                 int scan,
                 Hashtable<?,?> props)Constructs an ImageProducer object which uses an array of bytes
 to produce data for an Image object. | 
| MemoryImageSource(int w,
                 int h,
                 ColorModel cm,
                 int[] pix,
                 int off,
                 int scan)Constructs an ImageProducer object which uses an array of integers
 to produce data for an Image object. | 
| MemoryImageSource(int w,
                 int h,
                 ColorModel cm,
                 int[] pix,
                 int off,
                 int scan,
                 Hashtable<?,?> props)Constructs an ImageProducer object which uses an array of integers
 to produce data for an Image object. | 
| MemoryImageSource(int w,
                 int h,
                 int[] pix,
                 int off,
                 int scan)Constructs an ImageProducer object which uses an array of integers
 in the default RGB ColorModel to produce data for an Image object. | 
| MemoryImageSource(int w,
                 int h,
                 int[] pix,
                 int off,
                 int scan,
                 Hashtable<?,?> props)Constructs an ImageProducer object which uses an array of integers
 in the default RGB ColorModel to produce data for an Image object. | 
| Modifier and Type | Method and Description | 
|---|---|
| void | addConsumer(ImageConsumer ic)Adds an ImageConsumer to the list of consumers interested in
 data for this image. | 
| boolean | isConsumer(ImageConsumer ic)Determines if an ImageConsumer is on the list of consumers currently
 interested in data for this image. | 
| void | newPixels()Sends a whole new buffer of pixels to any ImageConsumers that
 are currently interested in the data for this image and notify
 them that an animation frame is complete. | 
| void | newPixels(byte[] newpix,
         ColorModel newmodel,
         int offset,
         int scansize)Changes to a new byte array to hold the pixels for this image. | 
| void | newPixels(int[] newpix,
         ColorModel newmodel,
         int offset,
         int scansize)Changes to a new int array to hold the pixels for this image. | 
| void | newPixels(int x,
         int y,
         int w,
         int h)Sends a rectangular region of the buffer of pixels to any
 ImageConsumers that are currently interested in the data for
 this image and notify them that an animation frame is complete. | 
| void | newPixels(int x,
         int y,
         int w,
         int h,
         boolean framenotify)Sends a rectangular region of the buffer of pixels to any
 ImageConsumers that are currently interested in the data for
 this image. | 
| void | removeConsumer(ImageConsumer ic)Removes an ImageConsumer from the list of consumers interested in
 data for this image. | 
| void | requestTopDownLeftRightResend(ImageConsumer ic)Requests that a given ImageConsumer have the image data delivered
 one more time in top-down, left-right order. | 
| void | setAnimated(boolean animated)Changes this memory image into a multi-frame animation or a
 single-frame static image depending on the animated parameter. | 
| void | setFullBufferUpdates(boolean fullbuffers)Specifies whether this animated memory image should always be
 updated by sending the complete buffer of pixels whenever
 there is a change. | 
| void | startProduction(ImageConsumer ic)Adds an ImageConsumer to the list of consumers interested in
 data for this image and immediately starts delivery of the
 image data through the ImageConsumer interface. | 
public MemoryImageSource(int w,
                         int h,
                         ColorModel cm,
                         byte[] pix,
                         int off,
                         int scan)
w - the width of the rectangle of pixelsh - the height of the rectangle of pixelscm - the specified ColorModelpix - an array of pixelsoff - the offset into the array of where to store the
        first pixelscan - the distance from one row of pixels to the next in
        the arrayComponent.createImage(java.awt.image.ImageProducer)public MemoryImageSource(int w,
                         int h,
                         ColorModel cm,
                         byte[] pix,
                         int off,
                         int scan,
                         Hashtable<?,?> props)
w - the width of the rectangle of pixelsh - the height of the rectangle of pixelscm - the specified ColorModelpix - an array of pixelsoff - the offset into the array of where to store the
        first pixelscan - the distance from one row of pixels to the next in
        the arrayprops - a list of properties that the ImageProducer
        uses to process an imageComponent.createImage(java.awt.image.ImageProducer)public MemoryImageSource(int w,
                         int h,
                         ColorModel cm,
                         int[] pix,
                         int off,
                         int scan)
w - the width of the rectangle of pixelsh - the height of the rectangle of pixelscm - the specified ColorModelpix - an array of pixelsoff - the offset into the array of where to store the
        first pixelscan - the distance from one row of pixels to the next in
        the arrayComponent.createImage(java.awt.image.ImageProducer)public MemoryImageSource(int w,
                         int h,
                         ColorModel cm,
                         int[] pix,
                         int off,
                         int scan,
                         Hashtable<?,?> props)
w - the width of the rectangle of pixelsh - the height of the rectangle of pixelscm - the specified ColorModelpix - an array of pixelsoff - the offset into the array of where to store the
        first pixelscan - the distance from one row of pixels to the next in
        the arrayprops - a list of properties that the ImageProducer
        uses to process an imageComponent.createImage(java.awt.image.ImageProducer)public MemoryImageSource(int w,
                         int h,
                         int[] pix,
                         int off,
                         int scan)
w - the width of the rectangle of pixelsh - the height of the rectangle of pixelspix - an array of pixelsoff - the offset into the array of where to store the
        first pixelscan - the distance from one row of pixels to the next in
        the arrayComponent.createImage(java.awt.image.ImageProducer), 
ColorModel.getRGBdefault()public MemoryImageSource(int w,
                         int h,
                         int[] pix,
                         int off,
                         int scan,
                         Hashtable<?,?> props)
w - the width of the rectangle of pixelsh - the height of the rectangle of pixelspix - an array of pixelsoff - the offset into the array of where to store the
        first pixelscan - the distance from one row of pixels to the next in
        the arrayprops - a list of properties that the ImageProducer
        uses to process an imageComponent.createImage(java.awt.image.ImageProducer), 
ColorModel.getRGBdefault()public void addConsumer(ImageConsumer ic)
addConsumer in interface ImageProduceric - the specified ImageConsumerNullPointerException - if the specified
           ImageConsumer is nullImageConsumerpublic boolean isConsumer(ImageConsumer ic)
isConsumer in interface ImageProduceric - the specified ImageConsumertrue if the ImageConsumer
 is on the list; false otherwise.ImageConsumerpublic void removeConsumer(ImageConsumer ic)
removeConsumer in interface ImageProduceric - the specified ImageConsumerImageConsumerpublic void startProduction(ImageConsumer ic)
startProduction in interface ImageProduceric - the specified ImageConsumer
 image data through the ImageConsumer interface.ImageConsumerpublic void requestTopDownLeftRightResend(ImageConsumer ic)
requestTopDownLeftRightResend in interface ImageProduceric - the specified ImageConsumerImageConsumerpublic void setAnimated(boolean animated)
This method should be called immediately after the MemoryImageSource is constructed and before an image is created with it to ensure that all ImageConsumers will receive the correct multi-frame data. If an ImageConsumer is added to this ImageProducer before this flag is set then that ImageConsumer will see only a snapshot of the pixel data that was available when it connected.
animated - true if the image is a
       multi-frame animationpublic void setFullBufferUpdates(boolean fullbuffers)
This method should be called immediately after the MemoryImageSource is constructed and before an image is created with it to ensure that all ImageConsumers will receive the correct pixel delivery hints.
fullbuffers - true if the complete pixel
             buffer should always
 be sentsetAnimated(boolean)public void newPixels()
public void newPixels(int x,
                      int y,
                      int w,
                      int h)
x - the x coordinate of the upper left corner of the rectangle
 of pixels to be senty - the y coordinate of the upper left corner of the rectangle
 of pixels to be sentw - the width of the rectangle of pixels to be senth - the height of the rectangle of pixels to be sentnewPixels(int, int, int, int, boolean), 
ImageConsumer, 
setAnimated(boolean), 
setFullBufferUpdates(boolean)public void newPixels(int x,
                      int y,
                      int w,
                      int h,
                      boolean framenotify)
x - the x coordinate of the upper left corner of the rectangle
 of pixels to be senty - the y coordinate of the upper left corner of the rectangle
 of pixels to be sentw - the width of the rectangle of pixels to be senth - the height of the rectangle of pixels to be sentframenotify - true if the consumers should be sent a
 SINGLEFRAMEDONE notificationImageConsumer, 
setAnimated(boolean), 
setFullBufferUpdates(boolean)public void newPixels(byte[] newpix,
                      ColorModel newmodel,
                      int offset,
                      int scansize)
newpix - the new pixel arraynewmodel - the specified ColorModeloffset - the offset into the arrayscansize - the distance from one row of pixels to the next in
 the arraynewPixels(int, int, int, int, boolean), 
setAnimated(boolean)public void newPixels(int[] newpix,
                      ColorModel newmodel,
                      int offset,
                      int scansize)
newpix - the new pixel arraynewmodel - the specified ColorModeloffset - the offset into the arrayscansize - the distance from one row of pixels to the next in
 the arraynewPixels(int, int, int, int, boolean), 
setAnimated(boolean) Submit a bug or feature 
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
 Copyright © 1993, 2025, Oracle and/or its affiliates.  All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.