JavaTM 2 Platform
Std. Ed. v1.3.1

java.awt.image
Interface RenderedImage

All Known Subinterfaces:
WritableRenderedImage

public interface RenderedImage

RenderedImage is a common interface for objects which contain or can produce image data in the form of Rasters. The image data may be stored/produced as a single tile or a regular array of tiles.


Method Summary
 WritableRaster copyData(WritableRaster raster)
          Computes an arbitrary rectangular region of the RenderedImage and copies it into a caller-supplied WritableRaster.
 ColorModel getColorModel()
          Returns the ColorModel associated with this image.
 Raster getData()
          Returns the image as one large tile (for tile based images this will require fetching the whole image and copying the image data over).
 Raster getData(Rectangle rect)
          Computes and returns an arbitrary region of the RenderedImage.
 int getHeight()
          Returns the height of the RenderedImage.
 int getMinTileX()
          Returns the minimum tile index in the X direction.
 int getMinTileY()
          Returns the minimum tile index in the Y direction.
 int getMinX()
          Returns the minimum X coordinate (inclusive) of the RenderedImage.
 int getMinY()
          Returns the minimum Y coordinate (inclusive) of the RenderedImage.
 int getNumXTiles()
          Returns the number of tiles in the X direction.
 int getNumYTiles()
          Returns the number of tiles in the Y direction.
 Object getProperty(String name)
          Gets a property from the property set of this image.
 String[] getPropertyNames()
          Returns an array of names recognized by getProperty(String) or null, if no property names are recognized.
 SampleModel getSampleModel()
          Returns the SampleModel associated with this image.
 Vector getSources()
          Returns a vector of RenderedImages that are the immediate sources of image data for this RenderedImage.
 Raster getTile(int tileX, int tileY)
          Returns tile (tileX, tileY).
 int getTileGridXOffset()
          Returns the X offset of the tile grid relative to the origin, i.e., the X coordinate of the upper-left pixel of tile (0, 0).
 int getTileGridYOffset()
          Returns the Y offset of the tile grid relative to the origin, i.e., the Y coordinate of the upper-left pixel of tile (0, 0).
 int getTileHeight()
          Returns the tile height in pixels.
 int getTileWidth()
          Returns the tile width in pixels.
 int getWidth()
          Returns the width of the RenderedImage.
 

Method Detail

getSources

public Vector getSources()
Returns a vector of RenderedImages that are the immediate sources of image data for this RenderedImage. This method returns null if the RenderedImage object has no information about its immediate sources. It returns an empty Vector if the RenderedImage object has no immediate sources.

getProperty

public Object getProperty(String name)
Gets a property from the property set of this image. The set of properties and whether it is immutable is determined by the implementing class. This method returns java.awt.Image.UndefinedProperty if the specified property is not defined for this RenderedImage.
See Also:
Image.UndefinedProperty

getPropertyNames

public String[] getPropertyNames()
Returns an array of names recognized by getProperty(String) or null, if no property names are recognized.
Returns:
a String array containing all of the property names that getProperty(String) recognizes; or null if no property names are recognized.

getColorModel

public ColorModel getColorModel()
Returns the ColorModel associated with this image. All Rasters returned from this image will have this as their ColorModel. This can return null.

getSampleModel

public SampleModel getSampleModel()
Returns the SampleModel associated with this image. All Rasters returned from this image will have this as their SampleModel.

getWidth

public int getWidth()
Returns the width of the RenderedImage.

getHeight

public int getHeight()
Returns the height of the RenderedImage.

getMinX

public int getMinX()
Returns the minimum X coordinate (inclusive) of the RenderedImage.

getMinY

public int getMinY()
Returns the minimum Y coordinate (inclusive) of the RenderedImage.

getNumXTiles

public int getNumXTiles()
Returns the number of tiles in the X direction.

getNumYTiles

public int getNumYTiles()
Returns the number of tiles in the Y direction.

getMinTileX

public int getMinTileX()
Returns the minimum tile index in the X direction.

getMinTileY

public int getMinTileY()
Returns the minimum tile index in the Y direction.

getTileWidth

public int getTileWidth()
Returns the tile width in pixels. All tiles must have the same width.

getTileHeight

public int getTileHeight()
Returns the tile height in pixels. All tiles must have the same height.

getTileGridXOffset

public int getTileGridXOffset()
Returns the X offset of the tile grid relative to the origin, i.e., the X coordinate of the upper-left pixel of tile (0, 0). (Note that tile (0, 0) may not actually exist.)

getTileGridYOffset

public int getTileGridYOffset()
Returns the Y offset of the tile grid relative to the origin, i.e., the Y coordinate of the upper-left pixel of tile (0, 0). (Note that tile (0, 0) may not actually exist.)

getTile

public Raster getTile(int tileX,
                      int tileY)
Returns tile (tileX, tileY). Note that tileX and tileY are indices into the tile array, not pixel locations. The Raster that is returned is live and will be updated if the image is changed.
Parameters:
tileX - the X index of the requested tile in the tile array.
tileY - the Y index of the requested tile in the tile array.

getData

public Raster getData()
Returns the image as one large tile (for tile based images this will require fetching the whole image and copying the image data over). The Raster returned is a copy of the image data and will not be updated if the image is changed.

getData

public Raster getData(Rectangle rect)
Computes and returns an arbitrary region of the RenderedImage. The Raster returned is a copy of the image data and will not be updated if the image is changed.
Parameters:
rect - the region of the RenderedImage to be returned.

copyData

public WritableRaster copyData(WritableRaster raster)
Computes an arbitrary rectangular region of the RenderedImage and copies it into a caller-supplied WritableRaster. The region to be computed is determined from the bounds of the supplied WritableRaster. The supplied WritableRaster must have a SampleModel that is compatible with this image. If raster is null, an appropriate WritableRaster is created.
Parameters:
raster - a WritableRaster to hold the returned portion of the image, or null.
Returns:
a reference to the supplied or created WritableRaster.

JavaTM 2 Platform
Std. Ed. v1.3.1

Submit a bug or feature
For further API reference and developer documentation, see Java 2 SDK SE Developer Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.

Java, Java 2D, and JDBC are trademarks or registered trademarks of Oracle and/or its affiliates, in the US and other countries.
Copyright © 1995, 2010 Oracle and/or its affiliates. All rights reserved.