Java Doc for MemoryImageSource.java in  » 6.0-JDK-Core » AWT » java » awt » image » Java Source Code / Java DocumentationJava Source Code and Java Documentation

Home
Java Source Code / Java Documentation
1.6.0 JDK Core
2.6.0 JDK Modules
3.6.0 JDK Modules com.sun
4.6.0 JDK Modules com.sun.java
5.6.0 JDK Modules sun
6.6.0 JDK Platform
7.Ajax
8.Apache Harmony Java SE
9.Aspect oriented
10.Authentication Authorization
11.Blogger System
12.Build
13.Byte Code
14.Cache
15.Chart
16.Chat
17.Code Analyzer
18.Collaboration
19.Content Management System
20.Database Client
21.Database DBMS
22.Database JDBC Connection Pool
23.Database ORM
24.Development
25.EJB Server
26.ERP CRM Financial
27.ESB
28.Forum
29.Game
30.GIS
31.Graphic 3D
32.Graphic Library
33.Groupware
34.HTML Parser
35.IDE
36.IDE Eclipse
37.IDE Netbeans
38.Installer
39.Internationalization Localization
40.Inversion of Control
41.Issue Tracking
42.J2EE
43.J2ME
44.JBoss
45.JMS
46.JMX
47.Library
48.Mail Clients
49.Music
50.Net
51.Parser
52.PDF
53.Portal
54.Profiler
55.Project Management
56.Report
57.RSS RDF
58.Rule Engine
59.Science
60.Scripting
61.Search Engine
62.Security
63.Sevlet Container
64.Source Control
65.Swing Library
66.Template Engine
67.Test Coverage
68.Testing
69.UML
70.Web Crawler
71.Web Framework
72.Web Mail
73.Web Server
74.Web Services
75.Web Services apache cxf 2.2.6
76.Web Services AXIS2
77.Wiki Engine
78.Workflow Engines
79.XML
80.XML UI
Java Source Code / Java Documentation » 6.0 JDK Core » AWT » java.awt.image 
Source Cross Reference  Class Diagram Java Document (Java Doc) 


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


Field Summary
 booleananimating
    
 booleanfullbuffers
    
 intheight
    
 ColorModelmodel
    
 intpixeloffset
    
 Objectpixels
    
 intpixelscan
    
 Hashtableproperties
    
 VectortheConsumers
    
 intwidth
    

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  voidaddConsumer(ImageConsumer ic)
     Adds an ImageConsumer to the list of consumers interested in data for this image.
public synchronized  booleanisConsumer(ImageConsumer ic)
     Determines if an ImageConsumer is on the list of consumers currently interested in data for this image.
public  voidnewPixels()
     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  voidnewPixels(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  voidnewPixels(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  voidnewPixels(byte[] newpix, ColorModel newmodel, int offset, int scansize)
     Changes to a new byte array to hold the pixels for this image.
public synchronized  voidnewPixels(int[] newpix, ColorModel newmodel, int offset, int scansize)
     Changes to a new int array to hold the pixels for this image.
public synchronized  voidremoveConsumer(ImageConsumer ic)
     Removes an ImageConsumer from the list of consumers interested in data for this image.
public  voidrequestTopDownLeftRightResend(ImageConsumer ic)
     Requests that a given ImageConsumer have the image data delivered one more time in top-down, left-right order.
public synchronized  voidsetAnimated(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  voidsetFullBufferUpdates(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  voidstartProduction(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.

Field Detail
animating
boolean animating(Code)



fullbuffers
boolean fullbuffers(Code)



height
int height(Code)



model
ColorModel model(Code)



pixeloffset
int pixeloffset(Code)



pixels
Object pixels(Code)



pixelscan
int pixelscan(Code)



properties
Hashtable properties(Code)



theConsumers
Vector theConsumers(Code)



width
int width(Code)




Constructor Detail
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 ImageProduceruses 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 ImageProduceruses 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 ImageProduceruses to process an image
See Also:   java.awt.Component.createImage
See Also:   ColorModel.getRGBdefault




Method Detail
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 ImageConsumeris on the list; false otherwise.
See Also:   ImageConsumer



newPixels
public void newPixels()(Code)
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:   MemoryImageSource.newPixels(int,int,int,int,boolean)
See Also:   ImageConsumer
See Also:   MemoryImageSource.setAnimated



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 ImageConsumerimage data through the ImageConsumer interface.
See Also:   ImageConsumer



Methods inherited from java.lang.Object
native protected Object clone() throws CloneNotSupportedException(Code)(Java Doc)
public boolean equals(Object obj)(Code)(Java Doc)
protected void finalize() throws Throwable(Code)(Java Doc)
final native public Class getClass()(Code)(Java Doc)
native public int hashCode()(Code)(Java Doc)
final native public void notify()(Code)(Java Doc)
final native public void notifyAll()(Code)(Java Doc)
public String toString()(Code)(Java Doc)
final native public void wait(long timeout) throws InterruptedException(Code)(Java Doc)
final public void wait(long timeout, int nanos) throws InterruptedException(Code)(Java Doc)
final public void wait() throws InterruptedException(Code)(Java Doc)

www.java2java.com | Contact Us
Copyright 2009 - 12 Demo Source and Support. All rights reserved.
All other trademarks are property of their respective owners.