Module java.desktop
Package java.awt.image

Interface RenderedImage

已知的所有子接口:
WritableRenderedImage
已知的所有实现类:
BufferedImage
public interface RenderedImage
RenderedImage是一个常见的接口，用于包含或生成以栅格形式的图像数据的对象。图像数据可以存储/生成为单个瓦片或瓦片的常规数组。

  • Method Summary

    Modifier and Type
    Method
    Description
    WritableRaster
    copyData(WritableRaster raster)
    计算RenderedImage的任意矩形区域，并将其复制到调用者提供的WritableRaster中。
    ColorModel
    getColorModel()
    返回与此图像关联的ColorModel。
    Raster
    getData()
    将图像作为一个大瓦片返回（对于基于瓦片的图像，这将需要获取整个图像并复制图像数据）。
    Raster
    getData(Rectangle rect)
    计算并返回RenderedImage的任意区域。
    int
    getHeight()
    返回RenderedImage的高度。
    int
    getMinTileX()
    返回X方向上的最小瓦片索引。
    int
    getMinTileY()
    返回Y方向上的最小瓦片索引。
    int
    getMinX()
    返回RenderedImage的最小X坐标（包括）。
    int
    getMinY()
    返回RenderedImage的最小Y坐标（包括）。
    int
    getNumXTiles()
    返回X方向上的瓦片数。
    int
    getNumYTiles()
    返回Y方向上的瓦片数。
    Object
    getProperty(String name)
    从此图像的属性集中获取属性。
    String[]
    getPropertyNames()
    返回由getProperty(String)识别的名称数组，如果不识别任何属性名称，则返回null。
    SampleModel
    getSampleModel()
    返回与此图像关联的SampleModel。
    Vector<RenderedImage>
    getSources()
    返回作为此RenderedImage的图像数据的直接源的RenderedImage的向量。
    Raster
    getTile(int tileX, int tileY)
    返回瓦片（tileX，tileY）。
    int
    getTileGridXOffset()
    返回相对于原点的瓦片网格的X偏移量，即瓦片（0，0）的左上像素的X坐标。
    int
    getTileGridYOffset()
    返回相对于原点的瓦片网格的Y偏移量，即瓦片（0，0）的左上像素的Y坐标。
    int
    getTileHeight()
    返回瓦片的像素高度。
    int
    getTileWidth()
    返回瓦片的像素宽度。
    int
    getWidth()
    返回RenderedImage的宽度。

  • Method Details

    • getSources

      Vector<RenderedImage> getSources()
      返回作为此RenderedImage的图像数据的直接源的RenderedImage的向量。如果RenderedImage对象没有关于其直接源的信息，则此方法返回null。如果RenderedImage对象没有直接源，则返回一个空的Vector。
      返回:
      一个包含RenderedImage对象的Vector。

    • getProperty

      Object getProperty(String name)
      从此图像的属性集中获取属性。属性集及其是否不可变由实现类确定。如果指定的属性未定义为此RenderedImage，则此方法返回java.awt.Image.UndefinedProperty。
      参数:
      name - 属性的名称
      返回:
      指定名称的属性。
      参见:

    • getPropertyNames

      String[] getPropertyNames()
      返回由getProperty(String)识别的名称数组，如果不识别任何属性名称，则返回null。
      返回:
      包含getProperty(String)识别的所有属性名称的String数组；如果不识别任何属性名称，则返回null。

    • getColorModel

      ColorModel getColorModel()
      返回与此图像关联的ColorModel。从此图像返回的所有栅格都将具有此ColorModel。可能返回null。
      返回:
      此图像的ColorModel。

    • getSampleModel

      SampleModel getSampleModel()
      返回与此图像关联的SampleModel。从此图像返回的所有栅格都将具有此SampleModel。
      返回:
      此图像的SampleModel。

    • getWidth

      int getWidth()
      返回RenderedImage的宽度。
      返回:
      此RenderedImage的宽度。

    • getHeight

      int getHeight()
      返回RenderedImage的高度。
      返回:
      此RenderedImage的高度。

    • getMinX

      int getMinX()
      返回RenderedImage的最小X坐标（包括）。
      返回:
      此RenderedImage的X坐标。

    • getMinY

      int getMinY()
      返回RenderedImage的最小Y坐标（包括）。
      返回:
      此RenderedImage的Y坐标。

    • getNumXTiles

      int getNumXTiles()
      返回X方向上的瓦片数。
      返回:
      X方向上的瓦片数。

    • getNumYTiles

      int getNumYTiles()
      返回Y方向上的瓦片数。
      返回:
      Y方向上的瓦片数。

    • getMinTileX

      int getMinTileX()
      返回X方向上的最小瓦片索引。
      返回:
      X方向上的最小瓦片索引。

    • getMinTileY

      int getMinTileY()
      返回Y方向上的最小瓦片索引。
      返回:
      Y方向上的最小瓦片索引。

    • getTileWidth

      int getTileWidth()
      返回瓦片的像素宽度。所有瓦片必须具有相同的宽度。
      返回:
      瓦片的像素宽度。

    • getTileHeight

      int getTileHeight()
      返回瓦片的像素高度。所有瓦片必须具有相同的高度。
      返回:
      瓦片的像素高度。

    • getTileGridXOffset

      int getTileGridXOffset()
      返回瓦片网格相对于原点的X偏移量，即瓦片（0，0）的左上像素的X坐标。（请注意，瓦片（0，0）实际上可能不存在。）
      返回:
      瓦片网格相对于原点的X偏移量。

    • getTileGridYOffset

      int getTileGridYOffset()
      返回瓦片网格相对于原点的Y偏移量，即瓦片（0，0）的左上像素的Y坐标。（请注意，瓦片（0，0）实际上可能不存在。）
      返回:
      瓦片网格相对于原点的Y偏移量。

    • getTile

      Raster getTile(int tileX, int tileY)
      返回瓦片（tileX，tileY）。请注意，tileX和tileY是瓦片数组中的索引，而不是像素位置。返回的Raster是实时的，如果图像发生更改，将进行更新。
      参数:
      tileX - 瓦片数组中请求的瓦片的X索引
      tileY - 瓦片数组中请求的瓦片的Y索引
      返回:
      给定指定索引的瓦片。

    • getData

      Raster getData()
      返回图像作为一个大瓦片（对于基于瓦片的图像，这将需要获取整个图像并复制图像数据）。返回的Raster是图像数据的副本，如果图像发生更改，将不会更新。
      返回:
      图像作为一个大瓦片。

    • getData

      Raster getData(Rectangle rect)
      计算并返回RenderedImage的任意区域。返回的Raster是图像数据的副本，如果图像发生更改，将不会更新。
      参数:
      rect - 要返回的RenderedImage区域。
      返回:
      由指定Rectangle指示的RenderedImage区域。

    • copyData

      WritableRaster copyData(WritableRaster raster)
      计算RenderedImage的任意矩形区域，并将其复制到调用者提供的WritableRaster中。要计算的区域是从提供的WritableRaster的边界确定的。提供的WritableRaster必须具有与此图像兼容的SampleModel。如果raster为null，则将创建一个适当的WritableRaster。
      参数:
      raster - 用于保存图像返回部分的WritableRaster，或为null。
      返回:
      提供或创建的WritableRaster的引用。