Spec-Zone .ru
спецификации, руководства, описания, API
|
|
Spec-Zone .ru
спецификации, руководства, описания, API
|
|
JavaTM 2 Platform Standard Edition |
|||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||
java.lang.Object | +--java.awt.image.MemoryImageSource
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);
}
}
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)
Determine if an ImageConsumer is on the list of consumers currently interested in data for this image. |
void |
newPixels()
Send 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)
Change to a new byte array to hold the pixels for this image. |
void |
newPixels(int[] newpix,
ColorModel newmodel,
int offset,
int scansize)
Change to a new int array to hold the pixels for this image. |
void |
newPixels(int x,
int y,
int w,
int h)
Send 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)
Send 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)
Remove 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)
Change this memory image into a multi-frame animation or a single-frame static image depending on the animated parameter. |
void |
setFullBufferUpdates(boolean fullbuffers)
Specify 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 start 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 |
public MemoryImageSource(int w,
int h,
ColorModel cm,
byte[] pix,
int off,
int scan)
Component.createImage(java.awt.image.ImageProducer)
public MemoryImageSource(int w,
int h,
ColorModel cm,
byte[] pix,
int off,
int scan,
Hashtable props)
Component.createImage(java.awt.image.ImageProducer)
public MemoryImageSource(int w,
int h,
ColorModel cm,
int[] pix,
int off,
int scan)
Component.createImage(java.awt.image.ImageProducer)
public MemoryImageSource(int w,
int h,
ColorModel cm,
int[] pix,
int off,
int scan,
Hashtable props)
Component.createImage(java.awt.image.ImageProducer)
public MemoryImageSource(int w,
int h,
int[] pix,
int off,
int scan)
Component.createImage(java.awt.image.ImageProducer),
ColorModel.getRGBdefault()
public MemoryImageSource(int w,
int h,
int[] pix,
int off,
int scan,
Hashtable props)
Component.createImage(java.awt.image.ImageProducer),
ColorModel.getRGBdefault()| Method Detail |
public void addConsumer(ImageConsumer ic)
ImageConsumerpublic boolean isConsumer(ImageConsumer ic)
ImageConsumerpublic void removeConsumer(ImageConsumer ic)
ImageConsumerpublic void startProduction(ImageConsumer ic)
ImageConsumerpublic void requestTopDownLeftRightResend(ImageConsumer ic)
ImageConsumerpublic void setAnimated(boolean animated)
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.
animated - true if the image is a multi-frame animationpublic void setFullBufferUpdates(boolean fullbuffers)
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.
fullbuffers - true if the complete pixel buffer should always
be sentsetAnimated(boolean)public void newPixels()
ImageConsumer,
setAnimated(boolean)
public void newPixels(int x,
int y,
int w,
int h)
x - the x coordinate of the upper left corner of the rectangle
of pixels to be senty - the y coordinate of the upper left corner of the rectangle
of pixels to be sentw - the width of the rectangle of pixels to be senth - the height of the rectangle of pixels to be sentImageConsumer,
setAnimated(boolean),
setFullBufferUpdates(boolean)
public void newPixels(int x,
int y,
int w,
int h,
boolean framenotify)
x - the x coordinate of the upper left corner of the rectangle
of pixels to be senty - the y coordinate of the upper left corner of the rectangle
of pixels to be sentw - the width of the rectangle of pixels to be senth - the height of the rectangle of pixels to be sentframenotify - true if the consumers should be sent a
SINGLEFRAMEDONE notificationImageConsumer,
setAnimated(boolean),
setFullBufferUpdates(boolean)
public void newPixels(byte[] newpix,
ColorModel newmodel,
int offset,
int scansize)
setAnimated(boolean)
public void newPixels(int[] newpix,
ColorModel newmodel,
int offset,
int scansize)
setAnimated(boolean)
|
JavaTM 2 Platform Standard Edition |
|||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||