API java : MemoryImageSource

java.awt.image
Class MemoryImageSource

java.lang.Object
  java.awt.image.MemoryImageSource

All Implemented Interfaces:: ImageProducer

public class MemoryImageSource
extends Object
implements ImageProducer
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

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.

Method Summary

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.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Summary
`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.

Method Summary
`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.

Methods inherited from class java.lang.Object
`clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait`

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

addConsumer

public void addConsumer(ImageConsumer ic)

Adds an ImageConsumer to the list of consumers interested in data for this image.

Specified by:: addConsumer in interface ImageProducer

Parameters:: ic - the specified ImageConsumer
Throws:: NullPointerException - if the specified ImageConsumer is null
See Also:: ImageConsumer

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.

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)

Package :

Ces informations proviennent du site de http://java.sun.com

Remarques

Contenu

Le contenu de cette page provient du site de Sun, et est généré depuis un cache sur l'infobrol après certains traitements automatisés. La présentation peut donc différer du document original, mais le contenu aussi. Vous pouvez utiliser ce bouton pour afficher la page originale du site de Sun :

Quels sont les motivations de cette démarche?

Maintenir les pages en cache sur différents sites peut offrir plus de disponibilité.

Chaque page est indexée dans la base de donnée, ce qui permet de retrouver facilement les informations, au moyen des sommaires, du moteur de recherche interne, etc.

Des facilités sont mises en place pour que les membres de l'infobrol puissent effectuer des traductions en français des différents documents. Ceci devrait permettre aux débutants en programmation Java de consulter les API en français s'ils maîtrisent moins bien la langue de Shakespeare. Dans le cas où une traduction a été soumise, elle est disponible au moyen d'un lien en bas de page. Si la traduction a été validée, la page s'affiche par défaut en français, et un lien en bas de page permet d'atteindre la version en anglais.

Le code sur l'infobrol est automatiquement coloré selon la syntaxe, et les différents mots clés sont transformés en liens pour accéder rapidement aux informations.

Vous avez la possibilité de partager vos expériences en proposant vos propres extraits de code en utilisant le bouton "ajouter un commentaire" en bas de page. Si vous visitez simplement l'infobrol, vous avez déjà accès à cette fonction, mais si vous étes membre du brol, vous pouvez en plus utiliser des boutons supplémentaires de mise en forme, dont la coloration automatique de vos extraits de codes.

<- MemoryHandler MemoryManagerMXBean ->

Réseaux sociaux

|Plus d'options...

Vous pouvez modifier vos préférences dans votre profil pour ne plus afficher les interactions avec les réseaux sociaux sur ces pages.

Nuage de mots clés

7 mots clés dont 0 définis manuellement (plus d'information...).

Avertissement

Cette page ne possède pas encore de mots clés manuels, ceci est donc un exemple automatique (les niveaux de pertinence sont fictifs, mais les liens sont valables). Pour tester le nuage avec une page qui contient des mots définis manuellement, vous pouvez cliquer ici.

Vous pouvez modifier vos préférences dans votre profil pour ne plus afficher le nuage de mots clés.

Structure du document

Réseaux sociaux
Nuage de mots clés
- Avertissement :

Astuce pour imprimer les couleurs des cellules de tableaux : http://www.gaudry.be/ast-rf-450.html

Aucun commentaire pour cette page

tection. Enregistrement IDDN n° 5329-2511
Document créé le 30/08/06 22:51, dernière modification le Vendredi 17 Juin 2011, 12:12
Source du document imprimé : http://www.gaudry.be/java-api-rf-java/awt/image/MemoryImageSource.html Document affiché 1 fois ce mois de Juin.
St.Gaudry©07.01.02