    All Packages  Class Hierarchy  This Package  Previous  Next  Index

# Class java.awt.Image

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

public class Image
extends Object

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

##

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

##

Image()

##

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

##

UndefinedProperty

      public final static Object UndefinedProperty

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

SCALE_DEFAULT

      public final static int SCALE_DEFAULT

  Use the default image scaling algorithm.

  See Also:
    getScaledImage

SCALE_FAST

      public final static int SCALE_FAST

  Choose an image scaling algorithm that gives higher priority to scaling speed than smoothness of the scaled image.

  See Also:
    getScaledImage

SCALE_SMOOTH

      public final static int SCALE_SMOOTH

  Choose an image scaling algorithm that gives higher priority to image smoothness than scaling speed.

  See Also:
    getScaledImage

SCALE_REPLICATE

      public final static 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:
    getScaledImage, ReplicateScaleFilter

SCALE_AREA_AVERAGING

      public final static 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:
    getScaledImage, AreaAveragingScaleFilter

##

Image

      public Image()

##

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

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

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

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,
                                         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

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

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