All Packages  Class Hierarchy  This Package  Previous  Next  Index

Class java.awt.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.


Variable Index

 o SCALE_AREA_AVERAGING
Use the Area Averaging image scaling algorithm.
 o SCALE_DEFAULT
Use the default image scaling algorithm.
 o SCALE_FAST
Choose an image scaling algorithm that gives higher priority to scaling speed than smoothness of the scaled image.
 o SCALE_REPLICATE
Use the ReplicateScaleFilter image scaling algorithm.
 o SCALE_SMOOTH
Choose an image scaling algorithm that gives higher priority to image smoothness than scaling speed.
 o UndefinedProperty
The UndefinedProperty object should be returned whenever a property which was not defined for a particular image is fetched.

Constructor Index

 o Image()

Method Index

 o flush()
Flushes all resources being used by this Image object.
 o getGraphics()
Gets a graphics object to draw into this image.
 o getHeight(ImageObserver)
Gets the actual height of the image.
 o getProperty(String, ImageObserver)
Gets a property of the image by name.
 o getScaledInstance(int, int, int)
Returns a scaled version of this image.
 o getSource()
Gets the object that produces the pixels for the image.
 o getWidth(ImageObserver)
Gets the actual width of the image.

Variables

 o 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.

 o SCALE_DEFAULT
 public static final int SCALE_DEFAULT
Use the default image scaling algorithm.

 o SCALE_FAST
 public static final int SCALE_FAST
Choose an image scaling algorithm that gives higher priority to scaling speed than smoothness of the scaled image.

 o SCALE_SMOOTH
 public static final int SCALE_SMOOTH
Choose an image scaling algorithm that gives higher priority to image smoothness than scaling speed.

 o SCALE_REPLICATE
 public static final int SCALE_REPLICATE
Use the ReplicateScaleFilter image scaling algorithm. The image object is free to substitute a different filter that performs the same algorithm yet integrates more efficiently into the image infrastructure supplied by the toolkit.

See Also:
ReplicateScaleFilter
 o SCALE_AREA_AVERAGING
 public static final int SCALE_AREA_AVERAGING
Use the Area Averaging image scaling algorithm. The image object is free to substitute a different filter that performs the same algorithm yet integrates more efficiently into the image infrastructure supplied by the toolkit.

See Also:
AreaAveragingScaleFilter

Constructors

 o Image
 public Image()

Methods

 o getWidth
 public abstract int getWidth(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, ImageObserver
 o getHeight
 public abstract int getHeight(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, ImageObserver
 o getSource
 public abstract 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
 o 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
 o getProperty
 public abstract Object getProperty(String name,
                                    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
 o getScaledInstance
 public Image getScaledInstance(int width,
                                int height,
                                int hints)
Returns a scaled version of this image. A new Image object is returned which will render the image at the specified width and height by default. The new Image object may be loaded asynchronously even if the original source image has already been loaded completely. If either the width or height is a negative number then a value is substituted to maintain the aspect ratio of the original image dimensions.

Parameters:
width - the width to stretch the image to
height - the height to stretch the image to
hints - flags to indicate the type of algorithm to use for image resampling
 o 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.


All Packages  Class Hierarchy  This Package  Previous  Next  Index

Submit a bug or feature