/*

  * FastImage.java

  *

  * This file is part of JavaGear.

  *

  * JavaGear 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 of the License, or

  * (at your option) any later version.

  *

  * JavaGear 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 JavaGear; if not, write to the Free Software

  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA

  */

 package uk.co.javagear;

 import java.awt.Image;

 import java.awt.Toolkit;

 import java.awt.Graphics;

 import java.awt.image.DirectColorModel;

 import java.awt.image.ImageConsumer;

 import java.awt.image.ImageProducer;

 /**

  * FastImage implements <code>ImageProducer</code> and is used to reconstruct the image

  * whenever it is needed.

  *

  * @author Copyright (C) 2003 Chris White

  * @version 18th January 2003

  */

 public class FastImage implements ImageProducer {

     /**

      * Image width.

      */

     private int width;

     /**

      * Image height.

      */

     private int height;

     /**

      * Image data.

      */

     private Image image;

     /**

      * Image consumer.

      */

     private ImageConsumer consumer;

     /**

      * Direct color model (32 bits).

      */

     private DirectColorModel model;

     /**

      * Construct a <code>FastImage</code>.

      *

      * @param w Width of Image

      * @param h Height of Image

      */

     public FastImage(int w, int h) {

         width = w;

         height = h;

         model = new DirectColorModel(32, 0x00FF0000, 0x000FF00, 0x000000FF, 0);

         image = Toolkit.getDefaultToolkit().createImage(this);

     }

     /**

      * Update the FastImage with new pixel data.

      *

      * @param pixels pixel array.

      * @param offset offset into pixel array.

      */

     public void update(int[] pixels, int offset) {

         if (consumer != null) {

             // Copy Integer Pixel Data to ImageComsumer

             consumer.setPixels(0, 0, width, height, model, pixels, offset, width);

             // Notify Image Consumer When Single Frame is Done

             consumer.imageComplete(ImageConsumer.SINGLEFRAMEDONE);

         }

     }

     /**

      * Paint the <code>FastImage</code>.

      *

      * @param g graphics context

      * @param xOffset X Offset at which to paint image at

      * @param yOffset Y Offset at which to paint image at

      * @param xScale X Scale Factor

      * @param yScale Y Scale Factor

      */

     public void paint(Graphics g, int xOffset, int yOffset, int xScale, int yScale) {

         g.drawImage(image, xOffset, yOffset, xScale, yScale, null);

     }

     /**

      * Paint the <code>FastImage</code>.

      *

      * @param g Graphics context

      * @param x1 Destination top left corner

      * @param y1 Destination top left corner

      * @param x2 Destination bottom right corner

      * @param y2 Destination bottom right corner

      * @param x3 Source top left corner

      * @param y3 Source top left corner

      * @param x4 Source bottom right corner

      * @param y4 Source bottom right corner

      */

     public void paint(Graphics g

             , int x1, int y1

             , int x2, int y2

             , int x3, int y3

             , int x4, int y4) {

         g.drawImage(image, x1, y1, x2, y2, x3, y3, x4, y4, null);

     }

     /**

      * Registers an ImageConsumer with the ImageProducer for access to the image data

      *  during a later reconstruction of the Image.

      *

      * @param ic the specified ImageConsumer

      */

     public void addConsumer(ImageConsumer ic) {

         // Register Image Consumer

         consumer = ic;

         // Set Image Dimensions

         consumer.setDimensions(width, height);

         // Set Image Consumer Hints for speed

         consumer.setHints(ImageConsumer.TOPDOWNLEFTRIGHT | ImageConsumer.COMPLETESCANLINES

                 | ImageConsumer.SINGLEPASS | ImageConsumer.SINGLEFRAME);

         // Set Image Colour Model

         consumer.setColorModel(model);

     }

     /**

      * Check if consumer is already registered.

      *

      * @return always returns true

      * @param ic an instance of <code>ImageConsumer</code>.

      */

     public boolean isConsumer(ImageConsumer ic) {

         return true;

     }

     /**

      * Registers the specified ImageConsumer object as a consumer and starts an immediate

      * reconstruction of the image data which will then be delivered to this consumer and

      * any other consumer which might have already been registered with the producer.

      *

      * @param ic the specified ImageConsumer

      */

     public void startProduction(ImageConsumer ic) {

         addConsumer(ic);

     }

     /**

      * Does nothing.

      *

      * @param ic an instance of <code>ImageConsumer</code>.

      */

     public void removeConsumer(ImageConsumer ic) {

     }

     /**

      * Does nothing.

      *

      * @param ic an instance of <code>ImageConsumer</code>.

      */

     public void requestTopDownLeftRightResend(ImageConsumer ic) {

     }

 }