| /* MemoryImageSource.java -- Java class for providing image data | |
| Copyright (C) 1999, 2004, 2006, Free Software Foundation, Inc. | |
| This file is part of GNU Classpath. | |
| GNU Classpath is free software; you can redistribute it and/or modify | |
| it under the terms of the GNU General Public License as published by | |
| the Free Software Foundation; either version 2, or (at your option) | |
| any later version. | |
| GNU Classpath is distributed in the hope that it will be useful, but | |
| WITHOUT ANY WARRANTY; without even the implied warranty of | |
| MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU | |
| General Public License for more details. | |
| You should have received a copy of the GNU General Public License | |
| along with GNU Classpath; see the file COPYING. If not, write to the | |
| Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA | |
| 02110-1301 USA. | |
| Linking this library statically or dynamically with other modules is | |
| making a combined work based on this library. Thus, the terms and | |
| conditions of the GNU General Public License cover the whole | |
| combination. | |
| As a special exception, the copyright holders of this library give you | |
| permission to link this library with independent modules to produce an | |
| executable, regardless of the license terms of these independent | |
| modules, and to copy and distribute the resulting executable under | |
| terms of your choice, provided that you also meet, for each linked | |
| independent module, the terms and conditions of the license of that | |
| module. An independent module is a module which is not derived from | |
| or based on this library. If you modify this library, you may extend | |
| this exception to your version of the library, but you are not | |
| obligated to do so. If you do not wish to do so, delete this | |
| exception statement from your version. */ | |
| package java.awt.image; | |
| import java.util.Hashtable; | |
| import java.util.Vector; | |
| /** | |
| * An image producer that delivers image data from an array. | |
| */ | |
| public class MemoryImageSource implements ImageProducer | |
| { | |
| private boolean animated = false; | |
| private boolean fullbuffers = false; | |
| private int[] pixeli; | |
| private int width; | |
| private int height; | |
| private int offset; | |
| private int scansize; | |
| private byte[] pixelb; | |
| private ColorModel cm; | |
| private Hashtable props = new Hashtable(); | |
| private Vector consumers = new Vector(); | |
| /** | |
| * Construct an image producer that reads image data from a byte | |
| * array. | |
| * | |
| * @param w width of image | |
| * @param h height of image | |
| * @param cm the color model used to represent pixel values | |
| * @param pix a byte array of pixel values | |
| * @param off the offset into the array at which the first pixel is stored | |
| * @param scan the number of array elements that represents a single pixel row | |
| */ | |
| public MemoryImageSource(int w, int h, ColorModel cm, byte[] pix, int off, | |
| int scan) | |
| { | |
| this(w, h, cm, pix, off, scan, null); | |
| } | |
| /** | |
| * Constructs an ImageProducer from memory. | |
| * | |
| * @param w the image width. | |
| * @param h the image height. | |
| * @param cm the color model. | |
| * @param pix the image data. | |
| * @param off the offset to the first pixel in the array. | |
| * @param scan the number of array elements from a pixel on one row to the | |
| * corresponding pixel on the next row. | |
| * @param props image properties (<code>null</code> permitted). | |
| */ | |
| public MemoryImageSource(int w, int h, ColorModel cm, byte[] pix, int off, | |
| int scan, Hashtable<?,?> props) | |
| { | |
| width = w; | |
| height = h; | |
| this.cm = cm; | |
| offset = off; | |
| scansize = scan; | |
| this.props = props; | |
| int max = ((scansize > width) ? scansize : width); | |
| pixelb = pix; | |
| } | |
| /** | |
| * Construct an image producer that reads image data from an | |
| * integer array. | |
| * | |
| * @param w width of image | |
| * @param h height of image | |
| * @param cm the color model used to represent pixel values | |
| * @param pix an integer array of pixel values | |
| * @param off the offset into the array at which the first pixel is stored | |
| * @param scan the number of array elements that represents a single pixel row | |
| */ | |
| public MemoryImageSource(int w, int h, ColorModel cm, int[] pix, int off, | |
| int scan) | |
| { | |
| this(w, h, cm, pix, off, scan, null); | |
| } | |
| /** | |
| * Constructs an ImageProducer from memory | |
| * | |
| * @param w the image width. | |
| * @param h the image height. | |
| * @param cm the color model. | |
| * @param pix the image data. | |
| * @param off the offset to the first pixel in the array. | |
| * @param scan the number of array elements from a pixel on one row to the | |
| * corresponding pixel on the next row. | |
| * @param props image properties (<code>null</code> permitted). | |
| */ | |
| public MemoryImageSource(int w, int h, ColorModel cm, int[] pix, int off, | |
| int scan, Hashtable<?,?> props) | |
| { | |
| width = w; | |
| height = h; | |
| this.cm = cm; | |
| offset = off; | |
| scansize = scan; | |
| this.props = props; | |
| int max = ((scansize > width) ? scansize : width); | |
| pixeli = pix; | |
| } | |
| /** | |
| * Constructs an ImageProducer from memory using the default RGB ColorModel. | |
| * | |
| * @param w the image width. | |
| * @param h the image height. | |
| * @param pix the image data. | |
| * @param off the offset to the first pixel in the array. | |
| * @param scan the number of array elements from a pixel on one row to the | |
| * corresponding pixel on the next row. | |
| * @param props image properties (<code>null</code> permitted). | |
| */ | |
| public MemoryImageSource(int w, int h, int[] pix, int off, int scan, | |
| Hashtable<?,?> props) | |
| { | |
| this(w, h, ColorModel.getRGBdefault(), pix, off, scan, props); | |
| } | |
| /** | |
| * Constructs an ImageProducer from memory using the default RGB ColorModel. | |
| * | |
| * @param w the image width. | |
| * @param h the image height. | |
| * @param pix the image data. | |
| * @param off the offset to the first pixel in the array. | |
| * @param scan the number of array elements from a pixel on one row to the | |
| * corresponding pixel on the next row. | |
| */ | |
| public MemoryImageSource(int w, int h, int[] pix, int off, int scan) | |
| { | |
| this(w, h, ColorModel.getRGBdefault(), pix, off, scan, null); | |
| } | |
| /** | |
| * Used to register an <code>ImageConsumer</code> with this | |
| * <code>ImageProducer</code>. | |
| * | |
| * @param ic the image consumer. | |
| */ | |
| public synchronized void addConsumer(ImageConsumer ic) | |
| { | |
| if (consumers.contains(ic)) | |
| return; | |
| consumers.addElement(ic); | |
| } | |
| /** | |
| * Used to determine if the given <code>ImageConsumer</code> is | |
| * already registered with this <code>ImageProducer</code>. | |
| * | |
| * @param ic the image consumer. | |
| */ | |
| public synchronized boolean isConsumer(ImageConsumer ic) | |
| { | |
| if (consumers.contains(ic)) | |
| return true; | |
| return false; | |
| } | |
| /** | |
| * Used to remove an <code>ImageConsumer</code> from the list of | |
| * registered consumers for this <code>ImageProducer</code>. | |
| * | |
| * @param ic the image consumer. | |
| */ | |
| public synchronized void removeConsumer(ImageConsumer ic) | |
| { | |
| consumers.removeElement(ic); | |
| } | |
| /** | |
| * Used to register an <code>ImageConsumer</code> with this | |
| * <code>ImageProducer</code> and then immediately start | |
| * reconstruction of the image data to be delivered to all | |
| * registered consumers. | |
| */ | |
| public void startProduction(ImageConsumer ic) | |
| { | |
| if (! (consumers.contains(ic))) | |
| consumers.addElement(ic); | |
| Vector list = (Vector) consumers.clone(); | |
| for (int i = 0; i < list.size(); i++) | |
| { | |
| ic = (ImageConsumer) list.elementAt(i); | |
| sendPicture(ic); | |
| if (animated) | |
| ic.imageComplete(ImageConsumer.SINGLEFRAMEDONE); | |
| else | |
| ic.imageComplete(ImageConsumer.STATICIMAGEDONE); | |
| } | |
| } | |
| /** | |
| * Used to register an <code>ImageConsumer</code> with this | |
| * <code>ImageProducer</code> and then request that this producer | |
| * resend the image data in the order top-down, left-right. | |
| * | |
| * @param ic the image consumer. | |
| */ | |
| public void requestTopDownLeftRightResend(ImageConsumer ic) | |
| { | |
| startProduction(ic); | |
| } | |
| /** | |
| * Changes a flag to indicate whether this MemoryImageSource supports | |
| * animations. | |
| * | |
| * @param animated A flag indicating whether this class supports animations | |
| */ | |
| public synchronized void setAnimated(boolean animated) | |
| { | |
| this.animated = animated; | |
| } | |
| /** | |
| * A flag to indicate whether or not to send full buffer updates when | |
| * sending animation. If this flag is set then full buffers are sent | |
| * in the newPixels methods instead of just regions. | |
| * | |
| * @param fullbuffers a flag indicating whether to send the full buffers | |
| */ | |
| public synchronized void setFullBufferUpdates(boolean fullbuffers) | |
| { | |
| this.fullbuffers = fullbuffers; | |
| } | |
| /** | |
| * Send an animation frame to the image consumers. | |
| */ | |
| public void newPixels() | |
| { | |
| if (animated == true) | |
| { | |
| ImageConsumer ic; | |
| Vector list = (Vector) consumers.clone(); | |
| for (int i = 0; i < list.size(); i++) | |
| { | |
| ic = (ImageConsumer) list.elementAt(i); | |
| sendPicture(ic); | |
| ic.imageComplete(ImageConsumer.SINGLEFRAME); | |
| } | |
| } | |
| } | |
| private void sendPicture(ImageConsumer ic) | |
| { | |
| ic.setHints(ImageConsumer.TOPDOWNLEFTRIGHT); | |
| if (props != null) | |
| ic.setProperties(props); | |
| ic.setDimensions(width, height); | |
| ic.setColorModel(cm); | |
| if (pixeli != null) | |
| ic.setPixels(0, 0, width, height, cm, pixeli, offset, scansize); | |
| else | |
| ic.setPixels(0, 0, width, height, cm, pixelb, offset, scansize); | |
| } | |
| /** | |
| * Send an animation frame to the image consumers containing the specified | |
| * pixels unless setFullBufferUpdates is set. | |
| * | |
| * @param x the x-coordinate. | |
| * @param y the y-coordinate. | |
| * @param w the width. | |
| * @param h the height. | |
| */ | |
| public synchronized void newPixels(int x, int y, int w, int h) | |
| { | |
| if (animated == true) | |
| { | |
| if (fullbuffers) | |
| newPixels(); | |
| else | |
| { | |
| ImageConsumer ic; | |
| Vector list = (Vector) consumers.clone(); | |
| for (int i = 0; i < list.size(); i++) | |
| { | |
| ic = (ImageConsumer) list.elementAt(i); | |
| ic.setHints(ImageConsumer.TOPDOWNLEFTRIGHT); | |
| if (props != null) | |
| ic.setProperties(props); | |
| if (pixeli != null) | |
| { | |
| int[] pixelbuf = new int[w * h]; | |
| for (int row = y; row < y + h; row++) | |
| System.arraycopy(pixeli, row * scansize + x + offset, | |
| pixelbuf, 0, w * h); | |
| ic.setPixels(x, y, w, h, cm, pixelbuf, 0, w); | |
| } | |
| else | |
| { | |
| byte[] pixelbuf = new byte[w * h]; | |
| for (int row = y; row < y + h; row++) | |
| System.arraycopy(pixelb, row * scansize + x + offset, | |
| pixelbuf, 0, w * h); | |
| ic.setPixels(x, y, w, h, cm, pixelbuf, 0, w); | |
| } | |
| ic.imageComplete(ImageConsumer.SINGLEFRAME); | |
| } | |
| } | |
| } | |
| } | |
| /** | |
| * Send an animation frame to the image consumers containing the specified | |
| * pixels unless setFullBufferUpdates is set. | |
| * | |
| * If framenotify is set then a notification is sent when the frame | |
| * is sent otherwise no status is sent. | |
| * | |
| * @param x the x-coordinate. | |
| * @param y the y-coordinate. | |
| * @param w the width. | |
| * @param h the height. | |
| * @param framenotify send notification? | |
| */ | |
| public synchronized void newPixels(int x, int y, int w, int h, | |
| boolean framenotify) | |
| { | |
| if (animated == true) | |
| { | |
| if (fullbuffers) | |
| newPixels(); | |
| else | |
| { | |
| ImageConsumer ic; | |
| Vector list = (Vector) consumers.clone(); | |
| for (int i = 0; i < list.size(); i++) | |
| { | |
| ic = (ImageConsumer) list.elementAt(i); | |
| ic.setHints(ImageConsumer.TOPDOWNLEFTRIGHT); | |
| if (props != null) | |
| ic.setProperties(props); | |
| if (pixeli != null) | |
| { | |
| int[] pixelbuf = new int[w * h]; | |
| for (int row = y; row < y + h; row++) | |
| System.arraycopy(pixeli, row * scansize + x + offset, | |
| pixelbuf, 0, w * h); | |
| ic.setPixels(x, y, w, h, cm, pixelbuf, 0, w); | |
| } | |
| else | |
| { | |
| byte[] pixelbuf = new byte[w * h]; | |
| for (int row = y; row < y + h; row++) | |
| System.arraycopy(pixelb, row * scansize + x + offset, | |
| pixelbuf, 0, w * h); | |
| ic.setPixels(x, y, w, h, cm, pixelbuf, 0, w); | |
| } | |
| if (framenotify == true) | |
| ic.imageComplete(ImageConsumer.SINGLEFRAME); | |
| } | |
| } | |
| } | |
| } | |
| public synchronized void newPixels(byte[] newpix, ColorModel newmodel, | |
| int offset, int scansize) | |
| { | |
| pixeli = null; | |
| pixelb = newpix; | |
| cm = newmodel; | |
| this.offset = offset; | |
| this.scansize = scansize; | |
| if (animated == true) | |
| newPixels(); | |
| } | |
| public synchronized void newPixels(int[] newpix, ColorModel newmodel, | |
| int offset, int scansize) | |
| { | |
| pixelb = null; | |
| pixeli = newpix; | |
| cm = newmodel; | |
| this.offset = offset; | |
| this.scansize = scansize; | |
| if (animated == true) | |
| newPixels(); | |
| } | |
| } |