java.awt.image

Class MemoryImageSource

Inhaltsverzeichnis
  • All Implemented Interfaces:
    ImageProducer

    public class MemoryImageSource
extends Object
implements ImageProducer
    This class is an implementation of the ImageProducer interface which uses an array to produce pixel values for an Image. Here is an example which calculates a 100x100 image representing a fade from black to blue along the X axis and a fade from black to red along the Y axis: 
    
      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));
    The MemoryImageSource is also capable of managing a memory image which varies over time to allow animation or custom rendering. Here is an example showing how to set up the animation source and signal changes in the data (adapted from the MemoryAnimationSourceDemo by Garth Dickie): 
    
      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);
          }
      }
    See Also:
    ImageProducer

    • Constructor Summary

      Constructors 
      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.

      Erste Seite von API Java Inhaltsverzeichnis Haut

    • Method Summary

      Methods 
      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.

      Erste Seite von API Java Inhaltsverzeichnis Haut

    • Constructor Detail

      • MemoryImageSource

        public 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.
        Parameters:
        w - the width of the rectangle of pixels
        h - the height of the rectangle of pixels
        cm - the specified ColorModel
        pix - an array of pixels
        off - the offset into the array of where to store the first pixel
        scan - the distance from one row of pixels to the next in the array
        See Also:
        Component.createImage(java.awt.image.ImageProducer)

      • MemoryImageSource

        public 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.
        Parameters:
        w - the width of the rectangle of pixels
        h - the height of the rectangle of pixels
        cm - the specified ColorModel
        pix - an array of pixels
        off - the offset into the array of where to store the first pixel
        scan - the distance from one row of pixels to the next in the array
        props - a list of properties that the ImageProducer uses to process an image
        See Also:
        Component.createImage(java.awt.image.ImageProducer)

      • MemoryImageSource

        public 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.
        Parameters:
        w - the width of the rectangle of pixels
        h - the height of the rectangle of pixels
        cm - the specified ColorModel
        pix - an array of pixels
        off - the offset into the array of where to store the first pixel
        scan - the distance from one row of pixels to the next in the array
        See Also:
        Component.createImage(java.awt.image.ImageProducer)

      • MemoryImageSource

        public 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.
        Parameters:
        w - the width of the rectangle of pixels
        h - the height of the rectangle of pixels
        cm - the specified ColorModel
        pix - an array of pixels
        off - the offset into the array of where to store the first pixel
        scan - the distance from one row of pixels to the next in the array
        props - a list of properties that the ImageProducer uses to process an image
        See Also:
        Component.createImage(java.awt.image.ImageProducer)

      • MemoryImageSource

        public 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.
        Parameters:
        w - the width of the rectangle of pixels
        h - the height of the rectangle of pixels
        pix - an array of pixels
        off - the offset into the array of where to store the first pixel
        scan - the distance from one row of pixels to the next in the array
        See Also:
        Component.createImage(java.awt.image.ImageProducer), ColorModel.getRGBdefault()

      • MemoryImageSource

        public 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.
        Parameters:
        w - the width of the rectangle of pixels
        h - the height of the rectangle of pixels
        pix - an array of pixels
        off - the offset into the array of where to store the first pixel
        scan - the distance from one row of pixels to the next in the array
        props - a list of properties that the ImageProducer uses to process an image
        See Also:
        Component.createImage(java.awt.image.ImageProducer), ColorModel.getRGBdefault()

    • Method Detail

      • isConsumer

        public boolean isConsumer(ImageConsumer ic)
        Determines if an ImageConsumer is on the list of consumers currently interested in data for this image.
        Specified by:
        isConsumer in interface ImageProducer
        Parameters:
        ic - the specified ImageConsumer
        Returns:
        true if the ImageConsumer is on the list; false otherwise.
        See Also:
        ImageConsumer

      • removeConsumer

        public void removeConsumer(ImageConsumer ic)
        Removes an ImageConsumer from the list of consumers interested in data for this image.
        Specified by:
        removeConsumer in interface ImageProducer
        Parameters:
        ic - the specified ImageConsumer
        See Also:
        ImageConsumer

      • startProduction

        public 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.
        Specified by:
        startProduction in interface ImageProducer
        Parameters:
        ic - the specified ImageConsumer image data through the ImageConsumer interface.
        See Also:
        ImageConsumer

      • requestTopDownLeftRightResend

        public void requestTopDownLeftRightResend(ImageConsumer ic)
        Requests that a given ImageConsumer have the image data delivered one more time in top-down, left-right order.
        Specified by:
        requestTopDownLeftRightResend in interface ImageProducer
        Parameters:
        ic - the specified ImageConsumer
        See Also:
        ImageConsumer

      • setAnimated

        public void setAnimated(boolean animated)
        Changes this memory image into a multi-frame animation or a single-frame static image depending on the animated parameter.

        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.

        Parameters:
        animated - true if the image is a multi-frame animation

      • setFullBufferUpdates

        public 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. This flag is ignored if the animation flag is not turned on through the setAnimated() method.

        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.

        Parameters:
        fullbuffers - true if the complete pixel buffer should always be sent
        See Also:
        setAnimated(boolean)

      • newPixels

        public 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. This method only has effect if the animation flag has been turned on through the setAnimated() method.
        See Also:
        newPixels(int, int, int, int, boolean), ImageConsumer, setAnimated(boolean)

      • newPixels

        public 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. This method only has effect if the animation flag has been turned on through the setAnimated() method. If the full buffer update flag was turned on with the setFullBufferUpdates() method then the rectangle parameters will be ignored and the entire buffer will always be sent.
        Parameters:
        x - the x coordinate of the upper left corner of the rectangle of pixels to be sent
        y - the y coordinate of the upper left corner of the rectangle of pixels to be sent
        w - the width of the rectangle of pixels to be sent
        h - the height of the rectangle of pixels to be sent
        See Also:
        newPixels(int, int, int, int, boolean), ImageConsumer, setAnimated(boolean), setFullBufferUpdates(boolean)

      • newPixels

        public 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. If the framenotify parameter is true then the consumers are also notified that an animation frame is complete. This method only has effect if the animation flag has been turned on through the setAnimated() method. If the full buffer update flag was turned on with the setFullBufferUpdates() method then the rectangle parameters will be ignored and the entire buffer will always be sent.
        Parameters:
        x - the x coordinate of the upper left corner of the rectangle of pixels to be sent
        y - the y coordinate of the upper left corner of the rectangle of pixels to be sent
        w - the width of the rectangle of pixels to be sent
        h - the height of the rectangle of pixels to be sent
        framenotify - true if the consumers should be sent a SINGLEFRAMEDONE notification
        See Also:
        ImageConsumer, setAnimated(boolean), setFullBufferUpdates(boolean)

      • newPixels

        public void newPixels(byte[] newpix,
             ColorModel newmodel,
             int offset,
             int scansize)
        Changes to a new byte array to hold the pixels for this image. If the animation flag has been turned on through the setAnimated() method, then the new pixels will be immediately delivered to any ImageConsumers that are currently interested in the data for this image.
        Parameters:
        newpix - the new pixel array
        newmodel - the specified ColorModel
        offset - the offset into the array
        scansize - the distance from one row of pixels to the next in the array
        See Also:
        newPixels(int, int, int, int, boolean), setAnimated(boolean)

      • newPixels

        public void newPixels(int[] newpix,
             ColorModel newmodel,
             int offset,
             int scansize)
        Changes to a new int array to hold the pixels for this image. If the animation flag has been turned on through the setAnimated() method, then the new pixels will be immediately delivered to any ImageConsumers that are currently interested in the data for this image.
        Parameters:
        newpix - the new pixel array
        newmodel - the specified ColorModel
        offset - the offset into the array
        scansize - the distance from one row of pixels to the next in the array
        See Also:
        newPixels(int, int, int, int, boolean), setAnimated(boolean)

Deutsche Übersetzung

Sie haben gebeten, diese Seite auf Deutsch zu besuchen. Momentan ist nur die Oberfläche übersetzt, aber noch nicht der gesamte Inhalt.

Wenn Sie mir bei Übersetzungen helfen wollen, ist Ihr Beitrag willkommen. Alles, was Sie tun müssen, ist, sich auf der Website zu registrieren und mir eine Nachricht zu schicken, in der Sie gebeten werden, Sie der Gruppe der Übersetzer hinzuzufügen, die Ihnen die Möglichkeit gibt, die gewünschten Seiten zu übersetzen. Ein Link am Ende jeder übersetzten Seite zeigt an, dass Sie der Übersetzer sind und einen Link zu Ihrem Profil haben.

Vielen Dank im Voraus.

Dokument erstellt 11/06/2005, zuletzt geändert 04/03/2020
Quelle des gedruckten Dokuments:https://www.gaudry.be/de/java-api-rf-java/awt/image/MemoryImageSource.html

Die Infobro ist eine persönliche Seite, deren Inhalt in meiner alleinigen Verantwortung liegt. Der Text ist unter der CreativeCommons-Lizenz (BY-NC-SA) verfügbar. Weitere Informationen auf die Nutzungsbedingungen und dem Autor.

Referenzen

  1. Zeigen Sie - html-Dokument Sprache des Dokuments:fr Manuel PHP : https://docs.oracle.com

Diese Verweise und Links verweisen auf Dokumente, die während des Schreibens dieser Seite konsultiert wurden, oder die zusätzliche Informationen liefern können, aber die Autoren dieser Quellen können nicht für den Inhalt dieser Seite verantwortlich gemacht werden.
Der Autor Diese Website ist allein dafür verantwortlich, wie die verschiedenen Konzepte und Freiheiten, die mit den Nachschlagewerken gemacht werden, hier dargestellt werden. Denken Sie daran, dass Sie mehrere Quellinformationen austauschen müssen, um das Risiko von Fehlern zu reduzieren.

Inhaltsverzeichnis Haut