| java.lang.Object java.awt.image.MemoryImageSource
MemoryImageSource | public class MemoryImageSource implements ImageProducer(Code) | | 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 version: 1.40 05/05/07 author: Jim Graham author: Animation capabilities inspired by the author: MemoryAnimationSource class written by Garth Dickie |
Constructor Summary | |
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. | 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. | 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. | 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. | 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. | 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. |
Method Summary | |
public synchronized void | addConsumer(ImageConsumer ic) Adds an ImageConsumer to the list of consumers interested in
data for this image. | public synchronized boolean | isConsumer(ImageConsumer ic) Determines if an ImageConsumer is on the list of consumers currently
interested in data for this image. | 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. | public synchronized 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. | public synchronized 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. | public synchronized void | newPixels(byte[] newpix, ColorModel newmodel, int offset, int scansize) Changes to a new byte array to hold the pixels for this image. | public synchronized void | newPixels(int[] newpix, ColorModel newmodel, int offset, int scansize) Changes to a new int array to hold the pixels for this image. | public synchronized void | removeConsumer(ImageConsumer ic) Removes an ImageConsumer from the list of consumers interested in
data for this image. | public void | requestTopDownLeftRightResend(ImageConsumer ic) Requests that a given ImageConsumer have the image data delivered
one more time in top-down, left-right order. | public synchronized 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. | public synchronized 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. | 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. |
animating | boolean animating(Code) | | |
fullbuffers | boolean fullbuffers(Code) | | |
pixeloffset | int pixeloffset(Code) | | |
MemoryImageSource | public MemoryImageSource(int w, int h, ColorModel cm, byte[] pix, int off, int scan)(Code) | | 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 Parameters: h - the height of the rectangle of pixels Parameters: cm - the specified ColorModel Parameters: pix - an array of pixels Parameters: off - the offset into the array of where to store the first pixel Parameters: scan - the distance from one row of pixels to the next inthe array See Also: java.awt.Component.createImage |
MemoryImageSource | public MemoryImageSource(int w, int h, ColorModel cm, byte[] pix, int off, int scan, Hashtable, ?> props)(Code) | | 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 Parameters: h - the height of the rectangle of pixels Parameters: cm - the specified ColorModel Parameters: pix - an array of pixels Parameters: off - the offset into the array of where to store the first pixel Parameters: scan - the distance from one row of pixels to the next inthe array Parameters: props - a list of properties that the ImageProducer uses to process an image See Also: java.awt.Component.createImage |
MemoryImageSource | public MemoryImageSource(int w, int h, ColorModel cm, int[] pix, int off, int scan)(Code) | | 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 Parameters: h - the height of the rectangle of pixels Parameters: cm - the specified ColorModel Parameters: pix - an array of pixels Parameters: off - the offset into the array of where to store the first pixel Parameters: scan - the distance from one row of pixels to the next inthe array See Also: java.awt.Component.createImage |
MemoryImageSource | public MemoryImageSource(int w, int h, ColorModel cm, int[] pix, int off, int scan, Hashtable, ?> props)(Code) | | 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 Parameters: h - the height of the rectangle of pixels Parameters: cm - the specified ColorModel Parameters: pix - an array of pixels Parameters: off - the offset into the array of where to store the first pixel Parameters: scan - the distance from one row of pixels to the next inthe array Parameters: props - a list of properties that the ImageProducer uses to process an image See Also: java.awt.Component.createImage |
MemoryImageSource | public MemoryImageSource(int w, int h, int pix, int off, int scan)(Code) | | 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 Parameters: h - the height of the rectangle of pixels Parameters: pix - an array of pixels Parameters: off - the offset into the array of where to store the first pixel Parameters: scan - the distance from one row of pixels to the next inthe array See Also: java.awt.Component.createImage See Also: ColorModel.getRGBdefault |
MemoryImageSource | public MemoryImageSource(int w, int h, int pix, int off, int scan, Hashtable, ?> props)(Code) | | 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 Parameters: h - the height of the rectangle of pixels Parameters: pix - an array of pixels Parameters: off - the offset into the array of where to store the first pixel Parameters: scan - the distance from one row of pixels to the next inthe array Parameters: props - a list of properties that the ImageProducer uses to process an image See Also: java.awt.Component.createImage See Also: ColorModel.getRGBdefault |
addConsumer | public synchronized void addConsumer(ImageConsumer ic)(Code) | | Adds an ImageConsumer to the list of consumers interested in
data for this image.
Parameters: ic - the specified ImageConsumer throws: NullPointerException - if the specifiedImageConsumer is null See Also: ImageConsumer |
isConsumer | public synchronized boolean isConsumer(ImageConsumer ic)(Code) | | Determines if an ImageConsumer is on the list of consumers currently
interested in data for this image.
Parameters: ic - the specified ImageConsumer true if the ImageConsumer is on the list; false otherwise. See Also: ImageConsumer |
newPixels | public synchronized void newPixels(int x, int y, int w, int h)(Code) | | 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 rectangleof pixels to be sent Parameters: y - the y coordinate of the upper left corner of the rectangleof pixels to be sent Parameters: w - the width of the rectangle of pixels to be sent Parameters: h - the height of the rectangle of pixels to be sent See Also: MemoryImageSource.newPixels(int,int,int,int,boolean) See Also: ImageConsumer See Also: MemoryImageSource.setAnimated See Also: MemoryImageSource.setFullBufferUpdates |
newPixels | public synchronized void newPixels(int x, int y, int w, int h, boolean framenotify)(Code) | | 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 rectangleof pixels to be sent Parameters: y - the y coordinate of the upper left corner of the rectangleof pixels to be sent Parameters: w - the width of the rectangle of pixels to be sent Parameters: h - the height of the rectangle of pixels to be sent Parameters: framenotify - true if the consumers should be sent aImageConsumer.SINGLEFRAMEDONE SINGLEFRAMEDONE notification See Also: ImageConsumer See Also: MemoryImageSource.setAnimated See Also: MemoryImageSource.setFullBufferUpdates |
newPixels | public synchronized void newPixels(byte[] newpix, ColorModel newmodel, int offset, int scansize)(Code) | | 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 Parameters: newmodel - the specified ColorModel Parameters: offset - the offset into the array Parameters: scansize - the distance from one row of pixels to the next inthe array See Also: MemoryImageSource.newPixels(int,int,int,int,boolean) See Also: MemoryImageSource.setAnimated |
newPixels | public synchronized void newPixels(int[] newpix, ColorModel newmodel, int offset, int scansize)(Code) | | 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 Parameters: newmodel - the specified ColorModel Parameters: offset - the offset into the array Parameters: scansize - the distance from one row of pixels to the next inthe array See Also: MemoryImageSource.newPixels(int,int,int,int,boolean) See Also: MemoryImageSource.setAnimated |
removeConsumer | public synchronized void removeConsumer(ImageConsumer ic)(Code) | | Removes an ImageConsumer from the list of consumers interested in
data for this image.
Parameters: ic - the specified ImageConsumer See Also: ImageConsumer |
requestTopDownLeftRightResend | public void requestTopDownLeftRightResend(ImageConsumer ic)(Code) | | Requests that a given ImageConsumer have the image data delivered
one more time in top-down, left-right order.
Parameters: ic - the specified ImageConsumer See Also: ImageConsumer |
setAnimated | public synchronized void setAnimated(boolean animated)(Code) | | 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 synchronized void setFullBufferUpdates(boolean fullbuffers)(Code) | | 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 alwaysbe sent See Also: MemoryImageSource.setAnimated |
startProduction | public void startProduction(ImageConsumer ic)(Code) | | 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.
Parameters: ic - the specified ImageConsumer image data through the ImageConsumer interface. See Also: ImageConsumer |
|
|