java.awt
Class Image

java.lang.Object
  |
  +--java.awt.Image

public abstract class Image

extends Object

The image class is an abstract class. The image must be obtained in a platform specific way.

Field Summary

static Object

UndefinedProperty The UndefinedProperty object should be returned whenever a property which was not defined for a particular image is fetched.

Constructor Summary

Image()

Method Summary

abstract void	flush() Flushes all resources being used by this Image object.
abstract Graphics	getGraphics() Gets a graphics object to draw into this image.
abstract int	getHeight(java.awt.image.ImageObserver observer) Gets the actual height of the image.
abstract Object	getProperty(String name, java.awt.image.ImageObserver observer) Gets a property of the image by name.
abstract java.awt.image.ImageProducer	getSource() Gets the object that produces the pixels for the image.
abstract int	getWidth(java.awt.image.ImageObserver observer) Gets the actual width of the image.

Methods inherited from class java.lang.Object

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

Field Detail

UndefinedProperty

public static final Object UndefinedProperty

The UndefinedProperty object should be returned whenever a property which was not defined for a particular image is fetched.

Constructor Detail

Image

public Image()

Method Detail

getWidth

public abstract int getWidth(java.awt.image.ImageObserver observer)

Gets the actual width of the image. If the width is not known yet then the ImageObserver will be notified later and -1 will be returned.

See Also:

getHeight(java.awt.image.ImageObserver), ImageObserver

getHeight

public abstract int getHeight(java.awt.image.ImageObserver observer)

Gets the actual height of the image. If the height is not known yet then the ImageObserver will be notified later and -1 will be returned.

See Also:

getWidth(java.awt.image.ImageObserver), ImageObserver

getSource

public abstract java.awt.image.ImageProducer getSource()

Gets the object that produces the pixels for the image. This is used by the Image filtering classes and by the image conversion and scaling code.

See Also:

ImageProducer

getGraphics

public abstract Graphics getGraphics()

Gets a graphics object to draw into this image. This will only work for off-screen images.

See Also:

Graphics

getProperty

public abstract Object getProperty(String name,
                                   java.awt.image.ImageObserver observer)

Gets a property of the image by name. Individual property names are defined by the various image formats. If a property is not defined for a particular image, this method will return the UndefinedProperty object. If the properties for this image are not yet known, then this method will return null and the ImageObserver object will be notified later. The property name "comment" should be used to store an optional comment which can be presented to the user as a description of the image, its source, or its author.

See Also:

ImageObserver, UndefinedProperty

flush

public abstract void flush()

Flushes all resources being used by this Image object. This includes any pixel data that is being cached for rendering to the screen as well as any system resources that are being used to store data or pixels for the image. The image is reset to a state similar to when it was first created so that if it is again rendered, the image data will have to be recreated or fetched again from its source.