BufferedImage (Java Platform SE 8 )

java.lang.Object
- java.awt.Image
- - java.awt.image.BufferedImage

All Implemented Interfaces:

RenderedImage ， WritableRenderedImage ， Transparency
```
public class BufferedImage
extends Image
implements WritableRenderedImage, Transparency
```
所述BufferedImage亚类描述了一种Image与图像数据的访问的缓冲器。 A BufferedImage由图像数据的ColorModel和Raster组成。 SampleModel中SampleModel中的Raster的数量和类型必须与ColorModel所要求的数字和类型相匹配，以表示其颜色和Alpha组件。所有BufferedImage对象的左上角坐标为（0,0）。 Raster用于构建BufferedImage的任何BufferedImage必须具有minX = 0和minY = 0。
这个类依赖的数据获取和设置方法Raster ，并在颜色表征方法ColorModel 。

另请参见：

ColorModel ， Raster ， WritableRaster

Field Summary

Fields
Modifier and Type	Field and Description
`static int`	`TYPE_3BYTE_BGR` 表示具有8位RGB颜色分量的图像，对应于Windows风格的BGR颜色模型），蓝色，绿色和红色以3个字节存储。
`static int`	`TYPE_4BYTE_ABGR` 表示具有蓝色，绿色和红色的8位RGBA颜色分量的图像，存储在3个字节和1个字节的alpha中。
`static int`	`TYPE_4BYTE_ABGR_PRE` 表示具有蓝色，绿色和红色的8位RGBA颜色分量的图像，存储在3个字节和1个字节的alpha中。
`static int`	`TYPE_BYTE_BINARY` 表示不透明的字节打包的1,2或4位图像。
`static int`	`TYPE_BYTE_GRAY` 表示无符号字节灰度图像，无索引。
`static int`	`TYPE_BYTE_INDEXED` 表示索引的字节图像。
`static int`	`TYPE_CUSTOM` 图像类型无法识别，因此它必须是自定义图像。
`static int`	`TYPE_INT_ARGB` 表示具有8位RGBA颜色成分的整数像素的图像。
`static int`	`TYPE_INT_ARGB_PRE` 表示具有8位RGBA颜色成分的整数像素的图像。
`static int`	`TYPE_INT_BGR` 表示具有8位RGB颜色分量的图像，对应于Windows或Solaris样式的BGR颜色模型，蓝色，绿色和红色颜色打包成整数像素。
`static int`	`TYPE_INT_RGB` 表示具有8位RGB颜色分量的整数像素的图像。
`static int`	`TYPE_USHORT_555_RGB` 表示5-5-5 RGB颜色分量（5位红色，5位绿色，5位蓝色）的图像，无alpha。
`static int`	`TYPE_USHORT_565_RGB` 表示具有5-6-5 RGB颜色分量（5位红色，6位绿色，5位蓝色），无alpha的图像。
`static int`	`TYPE_USHORT_GRAY` 表示无符号短灰度图像，非索引）。

Fields inherited from class java.awt.Image
accelerationPriority, SCALE_AREA_AVERAGING, SCALE_DEFAULT, SCALE_FAST, SCALE_REPLICATE, SCALE_SMOOTH, UndefinedProperty

Fields inherited from interface java.awt.Transparency
BITMASK, OPAQUE, TRANSLUCENT

构造方法摘要

构造方法
Constructor and Description
`BufferedImage(ColorModel cm, WritableRaster raster, boolean isRasterPremultiplied, Hashtable<?,?> properties)` 构造一个新的 `BufferedImage`与指定的 `ColorModel`和 `Raster` 。
`BufferedImage(int width, int height, int imageType)` 构造一个 `BufferedImage`义的图像类型的一个BufferedImage。
`BufferedImage(int width, int height, int imageType, IndexColorModel cm)` 构造一个 `BufferedImage`义的图像类型的一个BufferedImage：TYPE_BYTE_BINARY或TYPE_BYTE_INDEXED。

方法摘要

所有方法接口方法具体的方法
Modifier and Type	Method and Description
`void`	`addTileObserver(TileObserver to)` 添加瓦片观察器。
`void`	`coerceData(boolean isAlphaPremultiplied)` 强制数据与 `isAlphaPremultiplied`变量中指定的状态相匹配。
`WritableRaster`	`copyData(WritableRaster outRaster)` 计算的任意矩形区域 `BufferedImage` ，并将其复制到指定的 `WritableRaster` 。
`Graphics2D`	`createGraphics()` 创建一个 `Graphics2D` ，可以用来绘制这个 `BufferedImage` 。
`WritableRaster`	`getAlphaRaster()` 返回 `WritableRaster`表示用于alpha通道 `BufferedImage`对象与 `ColorModel`在于支持单独空间alpha通道的对象，如 `ComponentColorModel`和 `DirectColorModel` 。
`ColorModel`	`getColorModel()` 返回 `ColorModel` 。
`Raster`	`getData()` 将图像返回为一个大图块。
`Raster`	`getData(Rectangle rect)` 计算并返回的任意区域 `BufferedImage` 。
`Graphics`	`getGraphics()` 此方法返回一个`Graphics2D` ，但这里是向后兼容性。
`int`	`getHeight()` 返回 `BufferedImage`的高度。
`int`	`getHeight(ImageObserver observer)` 返回 `BufferedImage`的高度。
`int`	`getMinTileX()` 返回x方向上的最小拼贴索引。
`int`	`getMinTileY()` 返回y方向上的最小瓦片索引。
`int`	`getMinX()` 返回此 `BufferedImage`的最小x `BufferedImage` 。
`int`	`getMinY()` 返回此 `BufferedImage`的最小y `BufferedImage` 。
`int`	`getNumXTiles()` 返回x方向上的图块数。
`int`	`getNumYTiles()` 返回y方向上的图块数。
`Object`	`getProperty(String name)` 按名称返回图像的属性。
`Object`	`getProperty(String name, ImageObserver observer)` 按名称返回图像的属性。
`String[]`	`getPropertyNames()` 返回 `getProperty(String)`或 `null`的名称数组，如果未识别属性名称。
`WritableRaster`	`getRaster()` 返回`WritableRaster` 。
`int`	`getRGB(int x, int y)` 返回默认RGB颜色模型（TYPE_INT_ARGB）和默认sRGB颜色空间中的整数像素。
`int[]`	`getRGB(int startX, int startY, int w, int h, int[] rgbArray, int offset, int scansize)` 从图像数据的一部分返回默认RGB颜色模型（TYPE_INT_ARGB）和默认sRGB颜色空间中的整数像素数组。
`SampleModel`	`getSampleModel()` 返回 `SampleModel`与此相关 `BufferedImage` 。
`ImageProducer`	`getSource()` 返回产生图像像素的对象。
`Vector<RenderedImage>`	`getSources()` 返回`Vector`的`RenderedImage`对象是直接来源，而不是这些直接来源的来源，该图像数据`BufferedImage` 。
`BufferedImage`	`getSubimage(int x, int y, int w, int h)` 返回由指定的矩形区域定义的子图像。
`Raster`	`getTile(int tileX, int tileY)` 返回瓦（ `tileX` ， `tileY` ）。
`int`	`getTileGridXOffset()` 返回瓦片网格相对于原点的x偏移量，例如，tile（0，0）的位置的x坐标。
`int`	`getTileGridYOffset()` 返回瓦片网格相对于原点的y偏移量，例如，tile（0,0）的位置的y坐标。
`int`	`getTileHeight()` 返回瓷砖高度（以像素为单位）。
`int`	`getTileWidth()` 返回瓷砖宽度（以像素为单位）
`int`	`getTransparency()` 返回透明度。
`int`	`getType()` 返回图像类型。
`int`	`getWidth()` 返回 `BufferedImage`的宽度。
`int`	`getWidth(ImageObserver observer)` 返回 `BufferedImage`的宽度。
`WritableRaster`	`getWritableTile(int tileX, int tileY)` 检查一个瓦片写作。
`Point[]`	`getWritableTileIndices()` 返回一组`Point`个对象，指示哪些图块被签出用于写入。
`boolean`	`hasTileWriters()` 返回是否检出任何图块以进行写入。
`boolean`	`isAlphaPremultiplied()` 返回alpha是否被预乘。
`boolean`	`isTileWritable(int tileX, int tileY)` 返回是否当前签出拼贴以进行书写。
`void`	`releaseWritableTile(int tileX, int tileY)` 放弃写入瓦片的权限。
`void`	`removeTileObserver(TileObserver to)` 移除瓦片观察者。
`void`	`setData(Raster r)` 设置图像的矩形区域来指定的内容 `Raster` `r` ，其被假设为在相同的坐标空间的 `BufferedImage` 。
`void`	`setRGB(int x, int y, int rgb)` 将此 `BufferedImage`中的像素设置为指定的RGB值。
`void`	`setRGB(int startX, int startY, int w, int h, int[] rgbArray, int offset, int scansize)` 将默认RGB颜色模型（TYPE_INT_ARGB）和默认sRGB颜色空间中的整数像素数组设置为图像数据的一部分。
`String`	`toString()` 返回此 `BufferedImage`对象及其值的 `String`表示。

Methods inherited from class java.awt.Image
flush, getAccelerationPriority, getCapabilities, getScaledInstance, setAccelerationPriority

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- 字段详细信息
  - TYPE_CUSTOM
```
public static final int TYPE_CUSTOM
```
    图像类型无法识别，因此它必须是自定义图像。此类型仅用作getType（）方法的返回值。
    
    另请参见：
    
    Constant Field Values
  - TYPE_INT_RGB
```
public static final int TYPE_INT_RGB
```
    表示具有8位RGB颜色分量的整数像素的图像。该图像有一个DirectColorModel没有alpha。当与非不透明alpha数据存储在此类型的图像中，颜色数据必须被调整到非预乘形式和α丢弃，因为该描述AlphaComposite文档。
    
    另请参见：
    
    Constant Field Values
  - TYPE_INT_ARGB
```
public static final int TYPE_INT_ARGB
```
    表示具有8位RGBA颜色成分的整数像素的图像。该图像有一个DirectColorModel与alpha。该图像中的颜色数据被认为不被alpha预付。当此类型用作imageType参数为BufferedImage的构造，所创建的图像与JDK1.1创建的图像和更早的版本是一致的。
    
    另请参见：
    
    Constant Field Values
  - TYPE_INT_ARGB_PRE
```
public static final int TYPE_INT_ARGB_PRE
```
    表示具有8位RGBA颜色成分的整数像素的图像。该图像有一个DirectColorModel与alpha。该图像中的颜色数据被认为是用alpha预乘。
    
    另请参见：
    
    Constant Field Values
  - TYPE_INT_BGR
```
public static final int TYPE_INT_BGR
```
    表示具有8位RGB颜色分量的图像，对应于Windows或Solaris样式的BGR颜色模型，蓝色，绿色和红色颜色打包成整数像素。没有阿尔法图像有一个DirectColorModel 。当与非不透明alpha数据存储在此类型的图像中，颜色数据必须被调整到非预乘形式和α丢弃，因为该描述AlphaComposite文档。
    
    另请参见：
    
    Constant Field Values
  - TYPE_3BYTE_BGR
```
public static final int TYPE_3BYTE_BGR
```
    表示具有8位RGB颜色分量的图像，对应于Windows风格的BGR颜色模型），蓝色，绿色和红色以3个字节存储。没有阿尔法图像有一个ComponentColorModel 。当与非不透明alpha数据存储在此类型的图像中，颜色数据必须被调整到非预乘形式和α丢弃，因为该描述AlphaComposite文档。
    
    另请参见：
    
    Constant Field Values
  - TYPE_4BYTE_ABGR
```
public static final int TYPE_4BYTE_ABGR
```
    表示具有蓝色，绿色和红色的8位RGBA颜色分量的图像，存储在3个字节和1个字节的alpha中。图像有一个ComponentColorModel与alpha。该图像中的颜色数据被认为不被alpha预付。字节数据按照A，B，G，R中的单字节数组交错，从每个像素内的低字节到高字节地址。
    
    另请参见：
    
    Constant Field Values
  - TYPE_4BYTE_ABGR_PRE
```
public static final int TYPE_4BYTE_ABGR_PRE
```
    表示具有蓝色，绿色和红色的8位RGBA颜色分量的图像，存储在3个字节和1个字节的alpha中。该图像有一个ComponentColorModel与alpha。该图像中的颜色数据被认为是用alpha预乘。字节数据按照A，B，G，R中的单字节数组交错，从每个像素内的低字节到高字节地址。
    
    另请参见：
    
    Constant Field Values
  - TYPE_USHORT_565_RGB
```
public static final int TYPE_USHORT_565_RGB
```
    表示具有5-6-5 RGB颜色分量（5位红色，6位绿色，5位蓝色），无alpha的图像。这张图片有一个DirectColorModel 。当与非不透明alpha数据存储在此类型的图像中，颜色数据必须被调整到非预乘形式和α丢弃，因为该描述AlphaComposite文档。
    
    另请参见：
    
    Constant Field Values
  - TYPE_USHORT_555_RGB
```
public static final int TYPE_USHORT_555_RGB
```
    表示5-5-5 RGB颜色分量（5位红色，5位绿色，5位蓝色）的图像，无alpha。这张图片有一个DirectColorModel 。当与非不透明alpha数据存储在此类型的图像中，颜色数据必须被调整到非预乘形式和α丢弃，因为该描述AlphaComposite文档。
    
    另请参见：
    
    Constant Field Values
  - TYPE_BYTE_GRAY
```
public static final int TYPE_BYTE_GRAY
```
    表示无符号字节灰度图像，无索引。这张图片有一个ComponentColorModel与CS_GRAY ColorSpace 。当与非不透明alpha数据存储在此类型的图像中，颜色数据必须被调整到非预乘形式和α丢弃，因为该描述AlphaComposite文档。
    
    另请参见：
    
    Constant Field Values
  - TYPE_USHORT_GRAY
```
public static final int TYPE_USHORT_GRAY
```
    表示无符号短灰度图像，非索引）。此图片有一个ComponentColorModel与CS_GRAY ColorSpace 。当与非不透明alpha数据存储在此类型的图像中，颜色数据必须被调整到非预乘形式和α丢弃，因为该描述AlphaComposite文档。
    
    另请参见：
    
    Constant Field Values
  - TYPE_BYTE_BINARY
```
public static final int TYPE_BYTE_BINARY
```
    表示不透明的字节打包的1,2或4位图像。该图像有一个IndexColorModel没有alpha。当这种类型的被用作imageType参数传递给BufferedImage构造函数的imageType参数，但没有ColorModel参数，一个1比特的图像，创建与IndexColorModel在默认用两种颜色的sRGB ColorSpace ：{0，0，0}，并{255，255，255}。
    每个像素2或4位的图像可以经由被构建BufferedImage构造函数一个ColorModel参数通过供应ColorModel与适当的地图的大小。
    
    每像素8位的图像应使用图像类型TYPE_BYTE_INDEXED或TYPE_BYTE_GRAY具体取决于它们的ColorModel 。
    
    当颜色数据存储在这种类型的图像中时，色彩映射中最接近的颜色由IndexColorModel ，并且生成的索引被存储。逼近与α或颜色分量的损失可导致，根据在颜色IndexColorModel颜色表。
    
    另请参见：
    
    Constant Field Values
  - TYPE_BYTE_INDEXED
```
public static final int TYPE_BYTE_INDEXED
```
    表示索引的字节图像。当这种类型的被用作imageType参数传递给BufferedImage构造函数的imageType参数，但没有ColorModel参数，一个IndexColorModel与和颜色从216-255其余部分的256色6/6/6颜色立方体调色板创建在默认sRGB ColorSpace中由灰度值填充。
    当颜色数据存储在这种类型的图像中时，色彩映射中最接近的颜色由IndexColorModel ，并且生成的索引被存储。逼近与α或颜色分量的损失可导致，根据在颜色IndexColorModel颜色表。
    
    另请参见：
    
    Constant Field Values
- 构造方法详细信息
  - BufferedImage
```
public BufferedImage(int width,
                     int height,
                     int imageType)
```
    构造一个BufferedImage义的图像类型的一个BufferedImage。该图像的ColorSpace是默认的sRGB空间。
    
    参数
    
    width - 创建的图像的宽度
    
    height - 创建的图像的高度
    
    imageType - 创建的图像的类型
    
    另请参见：
    
    ColorSpace ， TYPE_INT_RGB ， TYPE_INT_ARGB ， TYPE_INT_ARGB_PRE ， TYPE_INT_BGR ， TYPE_3BYTE_BGR ， TYPE_4BYTE_ABGR ， TYPE_4BYTE_ABGR_PRE ， TYPE_BYTE_GRAY ， TYPE_USHORT_GRAY ， TYPE_BYTE_BINARY ， TYPE_BYTE_INDEXED ， TYPE_USHORT_565_RGB ， TYPE_USHORT_555_RGB
  - BufferedImage
```
public BufferedImage(int width,
                     int height,
                     int imageType,
                     IndexColorModel cm)
```
    构造一个BufferedImage义的图像类型的一个BufferedImage：TYPE_BYTE_BINARY或TYPE_BYTE_INDEXED。
    如果图像类型为TYPE_BYTE_BINARY，则颜色模型中的条目数用于确定图像是否应具有每像素1位，2位或4位。如果颜色模型有1或2个条目，则图像将具有每像素1位。如果它有3或4个条目，则每像素具有2位的图像。如果它有5到16个条目，图像将具有每像素4位。否则，将抛出IllegalArgumentException。
    
    参数
    
    width - 创建的图像的宽度
    
    height - 创建的图像的高度
    
    imageType - 创建的图像的类型
    
    cm - IndexColorModel创建的图像
    
    异常
    
    IllegalArgumentException - 如果imageType不是TYPE_BYTE_BINARY或TYPE_BYTE_INDEXED，或者如果imageType是TYPE_BYTE_BINARY，并且颜色映射有超过16个条目。
    
    另请参见：
    
    TYPE_BYTE_BINARY ， TYPE_BYTE_INDEXED
  - BufferedImage
```
public BufferedImage(ColorModel cm,
                     WritableRaster raster,
                     boolean isRasterPremultiplied,
                     Hashtable<?,?> properties)
```
    构造一个新的BufferedImage与指定的ColorModel和Raster 。如果SampleModel中的Raster的数量和类型与ColorModel所要求的数字和类型不匹配来表示其颜色和Alpha组件，则会抛出一个RasterFormatException 。该方法可以将颜色Raster数据乘以或除以alpha，以匹配alphaPremultiplied中的ColorModel状态。此属性BufferedImage可以通过传递建立Hashtable的String / Object对。
    
    参数
    
    cm - ColorModel的新图像
    
    raster - Raster的图像数据
    
    isRasterPremultiplied - 如果 true ，栅格中的数据已经被alpha预取。
    
    properties - Hashtable的 String / Object对。
    
    异常
    
    RasterFormatException - 如果 SampleModel中的 Raster数和类型与 ColorModel所要求的数字和类型 ColorModel ，表示其颜色和alpha分量。
    
    IllegalArgumentException -如果 raster格格不入 cm
    
    另请参见：
    
    ColorModel ， Raster ， WritableRaster
- 方法详细信息
  - getType
```
public int getType()
```
    返回图像类型。如果它不是已知类型之一，则返回TYPE_CUSTOM。
    
    结果
    
    该图像类型为 BufferedImage 。
    
    另请参见：
    
    TYPE_INT_RGB ， TYPE_INT_ARGB ， TYPE_INT_ARGB_PRE ， TYPE_INT_BGR ， TYPE_3BYTE_BGR ， TYPE_4BYTE_ABGR ， TYPE_4BYTE_ABGR_PRE ， TYPE_BYTE_GRAY ， TYPE_BYTE_BINARY ， TYPE_BYTE_INDEXED ， TYPE_USHORT_GRAY ， TYPE_USHORT_565_RGB ， TYPE_USHORT_555_RGB ， TYPE_CUSTOM
  - getColorModel
```
public ColorModel getColorModel()
```
    返回 ColorModel 。
    
    Specified by:
    
    getColorModel在界面 RenderedImage
    
    结果
    
    这个 ColorModel的 BufferedImage 。
  - getRaster
```
public WritableRaster getRaster()
```
    返回WritableRaster 。
    
    结果
    
    这个 WriteableRaster的 BufferedImage 。
  - getAlphaRaster
```
public WritableRaster getAlphaRaster()
```
    返回WritableRaster代表BufferedImage对象的alpha通道，其中ColorModel对象支持单独的空间alpha通道，如ComponentColorModel和DirectColorModel 。返回null如果存在与关联的alpha通道ColorModel这个图像英寸此方法假设所有ColorModel对象比其他IndexColorModel ，如果ColorModel支持alpha，存在被存储为图像数据的最后一个频带的单独alpha通道。如果图像使用查找表中有alpha的IndexColorModel ，则此方法返回null因为没有空间离散的alpha通道。此方法创建一个新的WritableRaster ，但共享数据数组。
    
    结果
    
    一个 WritableRaster或 null如果这个 BufferedImage没有alpha通道与其 ColorModel 。
  - getRGB
```
public int getRGB(int x,
                  int y)
```
    返回默认RGB颜色模型（TYPE_INT_ARGB）和默认sRGB颜色空间中的整数像素。如果此默认模型与图像ColorModel不匹配， ColorModel进行颜色ColorModel 。使用此方法时，返回数据中每个颜色分量的精度只有8位。
    一个ArrayOutOfBoundsException如果坐标不在边界可能抛出。但是，显式边界检查不能保证。
    
    参数
    
    x - 从默认RGB颜色模型和sRGB颜色空间中获取像素的像素的X坐标
    
    y - 在默认RGB颜色模型和sRGB颜色空间中获取像素的像素的Y坐标
    
    结果
    
    默认RGB颜色模型和默认sRGB颜色空间中的整数像素。
    
    另请参见：
    
    setRGB(int, int, int) ， setRGB(int, int, int, int, int[], int, int)
  - getRGB
```
public int[] getRGB(int startX,
                    int startY,
                    int w,
                    int h,
                    int[] rgbArray,
                    int offset,
                    int scansize)
```
    从图像数据的一部分返回默认RGB颜色模型（TYPE_INT_ARGB）和默认sRGB颜色空间中的整数像素数组。如果默认型号不匹配图像ColorModel进行颜色ColorModel 。使用此方法时，返回数据中每个颜色分量的精度只有8位。使用图像中的指定坐标（x，y），可以以这种方式访问ARGB像素：
```
  pixel   = rgbArray[offset + (y-startY)*scansize + (x-startX)]; 
```
    如果区域不在边界内，则可以抛出ArrayOutOfBoundsException 。但是，显式边界检查不能保证。
    参数
    
    startX - 起始X坐标
    
    startY - 起始Y坐标
    
    w - 区域的宽度
    
    h - 区域的高度
    
    rgbArray - 如果不是 null ，rgb像素写在这里
    
    offset - 偏移到 rgbArray
    
    scansize - 扫描线步幅为 rgbArray
    
    结果
    
    RGB像素阵列。
    
    另请参见：
    
    setRGB(int, int, int) ， setRGB(int, int, int, int, int[], int, int)
  - setRGB
```
public void setRGB(int x,
                   int y,
                   int rgb)
```
    将此BufferedImage中的像素设置为指定的RGB值。假设像素处于默认RGB颜色模型TYPE_INT_ARGB和默认sRGB颜色空间。对于具有IndexColorModel图像，选择具有最近颜色的索引。
    一个ArrayOutOfBoundsException如果坐标不在边界可能抛出。但是，显式边界检查不能保证。
    
    参数
    
    x - 要设置的像素的X坐标
    
    y - 要设置的像素的Y坐标
    
    rgb - RGB值
    
    另请参见：
    
    getRGB(int, int) ， getRGB(int, int, int, int, int[], int, int)
  - setRGB
```
public void setRGB(int startX,
                   int startY,
                   int w,
                   int h,
                   int[] rgbArray,
                   int offset,
                   int scansize)
```
    将默认RGB颜色模型（TYPE_INT_ARGB）和默认sRGB颜色空间中的整数像素数组设置为图像数据的一部分。如果默认模型与图像ColorModel不匹配， ColorModel进行颜色ColorModel 。使用此方法时，返回数据中每个颜色分量的精度只有8位。使用此图像中的指定坐标（x，y），可以以这种方式访问ARGB像素：
```
  pixel   = rgbArray[offset + (y-startY)*scansize + (x-startX)]; 
```
    警告：不发生抖动。
    如果区域不在边界范围内，则可能抛出ArrayOutOfBoundsException 。但是，显式边界检查不能保证。
    参数
    
    startX - 起始X坐标
    
    startY - 起始Y坐标
    
    w - 区域的宽度
    
    h - 区域的高度
    
    rgbArray - rgb像素
    
    offset - 偏移到 rgbArray
    
    scansize - 扫描线步幅为 rgbArray
    
    另请参见：
    
    getRGB(int, int) ， getRGB(int, int, int, int, int[], int, int)
  - getWidth
```
public int getWidth()
```
    返回 BufferedImage的宽度。
    
    Specified by:
    
    getWidth在界面 RenderedImage
    
    结果
    
    这个宽度 BufferedImage
  - getHeight
```
public int getHeight()
```
    返回 BufferedImage的高度。
    
    Specified by:
    
    getHeight在界面 RenderedImage
    
    结果
    
    这个 BufferedImage的高度
  - getWidth
```
public int getWidth(ImageObserver observer)
```
    返回宽度 BufferedImage 。
    
    Specified by:
    
    getWidth在类别 Image
    
    参数
    
    observer - 忽略
    
    结果
    
    这个宽度 BufferedImage
    
    另请参见：
    
    Image.getHeight(java.awt.image.ImageObserver) ， ImageObserver
  - getHeight
```
public int getHeight(ImageObserver observer)
```
    返回 BufferedImage的高度。
    
    Specified by:
    
    getHeight在类别 Image
    
    参数
    
    observer - 忽略
    
    结果
    
    这个 BufferedImage的高度
    
    另请参见：
    
    Image.getWidth(java.awt.image.ImageObserver) ， ImageObserver
  - getSource
```
public ImageProducer getSource()
```
    返回产生图像像素的对象。
    
    Specified by:
    
    getSource在 Image
    
    结果
    
    用于生成此图像的像素的ImageProducer 。
    
    另请参见：
    
    ImageProducer
  - getProperty
```
public Object getProperty(String name,
                          ImageObserver observer)
```
    按名称返回图像的属性。单个属性名称由各种图像格式定义。如果未为特定图像定义属性，则此方法返回UndefinedProperty字段。如果此图像的属性尚未知道，则此方法返回null ，稍后通知ImageObserver对象。应该使用属性名称“comment”来存储一个可选的注释，该注释可以作为图像，其来源或作者的描述呈现给用户。
    
    Specified by:
    
    getProperty在类别 Image
    
    参数
    
    name - 物业名称
    
    observer -在 ImageObserver接收关于图像信息通知
    
    结果
    
    一个Object是指定的name或null参考的属性，如果此图像的属性尚未知道。
    
    异常
    
    NullPointerException - 如果属性名为null。
    
    另请参见：
    
    ImageObserver ， Image.UndefinedProperty
  - getProperty
```
public Object getProperty(String name)
```
    按名称返回图像的属性。
    
    Specified by:
    
    getProperty在界面 RenderedImage
    
    参数
    
    name - 属性名称
    
    结果
    
    一个 Object是指定的指定的属性 name 。
    
    异常
    
    NullPointerException - 如果属性名称为空。
    
    另请参见：
    
    Image.UndefinedProperty
  - getGraphics
```
public Graphics getGraphics()
```
    此方法返回一个Graphics2D ，但这里是向后兼容性。 createGraphics更方便，因为它被声明返回一个Graphics2D 。
    
    Specified by:
    
    getGraphics在 Image
    
    结果
    
    一个 Graphics2D ，可以用来绘制这个图像。
    
    另请参见：
    
    Graphics ， Component.createImage(int, int)
  - createGraphics
```
public Graphics2D createGraphics()
```
    创建一个 Graphics2D ，可以用来绘制这个 BufferedImage 。
    
    结果
    
    一个 Graphics2D ，用于绘制这个图像。
  - getSubimage
```
public BufferedImage getSubimage(int x,
                                 int y,
                                 int w,
                                 int h)
```
    返回由指定的矩形区域定义的子图像。返回的BufferedImage共享与原始图像相同的数据数组。
    
    参数
    
    x - 指定矩形区域左上角的X坐标
    
    y - 指定矩形区域左上角的Y坐标
    
    w - 指定矩形区域的宽度
    
    h - 指定矩形区域的高度
    
    结果
    
    一个 BufferedImage是这个 BufferedImage的子图像。
    
    异常
    
    RasterFormatException - 如果指定的区域不包含在此 BufferedImage 。
  - isAlphaPremultiplied
```
public boolean isAlphaPremultiplied()
```
    返回alpha是否被预乘。如果没有alpha，它返回false 。
    
    结果
    
    true如果alpha已被预乘; false否则。
  - coerceData
```
public void coerceData(boolean isAlphaPremultiplied)
```
    强制数据与isAlphaPremultiplied变量中指定的状态相匹配。它可以将颜色光栅数据乘以或除以α，如果数据处于正确状态，则不执行任何操作。
    
    参数
    
    isAlphaPremultiplied - true如果alpha已被预乘， false否则。
  - toString
```
public String toString()
```
    返回此 BufferedImage对象及其值的 String表示。
    
    重写：
    
    toString在类别 Object
    
    结果
    
    一个 String代表这个 BufferedImage 。
  - getSources
```
public Vector<RenderedImage> getSources()
```
    返回Vector的RenderedImage对象是直接来源，而不是这些直接来源的来源，该图像数据BufferedImage 。如果BufferedImage没有关于其直接来源的信息，此方法返回null 。如果BufferedImage没有直接的来源，它返回一个空的Vector 。
    
    Specified by:
    
    getSources在界面 RenderedImage
    
    结果
    
    一个 Vector包含该 BufferedImage对象的图像日期的即时消息来源，或 null如果此 BufferedImage没有关于其直接来源的信息，或者如果此 BufferedImage没有立即来源， BufferedImage空 Vector 。
  - getPropertyNames
```
public String[] getPropertyNames()
```
    返回 getProperty(String)或 null的名称数组，如果不识别属性名称。
    
    Specified by:
    
    getPropertyNames在界面 RenderedImage
    
    结果
    
    一个String阵列包含所有的属性名称的getProperty(String)识别; 或null如果没有属性名称被识别。
  - getMinX
```
public int getMinX()
```
    返回此BufferedImage的最小x BufferedImage 。这总是为零。
    
    Specified by:
    
    getMinX在界面 RenderedImage
    
    结果
    
    这个 BufferedImage的最小x BufferedImage 。
  - getMinY
```
public int getMinY()
```
    返回此BufferedImage的最小y BufferedImage 。这总是为零。
    
    Specified by:
    
    getMinY在界面 RenderedImage
    
    结果
    
    这个 BufferedImage的最小y BufferedImage 。
  - getSampleModel
```
public SampleModel getSampleModel()
```
    返回 SampleModel与此相关 BufferedImage 。
    
    Specified by:
    
    getSampleModel在界面 RenderedImage
    
    结果
    
    这个 SampleModel的 BufferedImage 。
  - getNumXTiles
```
public int getNumXTiles()
```
    返回x方向上的图块数。这总是一个。
    
    Specified by:
    
    getNumXTiles在界面 RenderedImage
    
    结果
    
    在x方向上的瓦片数量。
  - getNumYTiles
```
public int getNumYTiles()
```
    返回y方向上的图块数。这总是一个。
    
    Specified by:
    
    getNumYTiles在界面 RenderedImage
    
    结果
    
    在y方向上的瓦片数量。
  - getMinTileX
```
public int getMinTileX()
```
    返回x方向上的最小拼贴索引。这总是为零。
    
    Specified by:
    
    getMinTileX在接口 RenderedImage
    
    结果
    
    x方向上的最小瓦片索引。
  - getMinTileY
```
public int getMinTileY()
```
    返回y方向上的最小瓦片索引。这总是为零。
    
    Specified by:
    
    getMinTileY在界面 RenderedImage
    
    结果
    
    y方向的最小瓦片指数。
  - getTileWidth
```
public int getTileWidth()
```
    返回瓷砖宽度（以像素为单位）
    
    Specified by:
    
    getTileWidth在界面 RenderedImage
    
    结果
    
    瓦片宽度（以像素为单位）。
  - getTileHeight
```
public int getTileHeight()
```
    返回瓷砖高度（以像素为单位）。
    
    Specified by:
    
    getTileHeight在界面 RenderedImage
    
    结果
    
    瓷砖高度以像素为单位。
  - getTileGridXOffset
```
public int getTileGridXOffset()
```
    返回瓦片网格相对于原点的x偏移量，例如，tile（0，0）的位置的x坐标。这总是为零。
    
    Specified by:
    
    getTileGridXOffset在界面 RenderedImage
    
    结果
    
    瓦片网格的x偏移量。
  - getTileGridYOffset
```
public int getTileGridYOffset()
```
    返回瓦片网格相对于原点的y偏移量，例如，tile（0,0）的位置的y坐标。这总是为零。
    
    Specified by:
    
    getTileGridYOffset在界面 RenderedImage
    
    结果
    
    瓦片网格的y偏移量。
  - getTile
```
public Raster getTile(int tileX,
                      int tileY)
```
    返回瓦（ tileX ， tileY ）。请注意， tileX和tileY是tile数组中的索引，而不是像素位置。返回的Raster是实时的，这意味着如果图像被更改，它将被更新。
    
    Specified by:
    
    getTile在界面 RenderedImage
    
    参数
    
    tileX - tile数组中所请求的tile的x索引
    
    tileY - 图块数组中所请求的图块的y索引
    
    结果
    
    一个 Raster是由参数 tileX和 tileY定义的瓦片。
    
    异常
    
    ArrayIndexOutOfBoundsException - 如果 tileX和 tileY都不等于0
  - getData
```
public Raster getData()
```
    将图像返回为一个大图块。 Raster返回的图像数据的副本如果图像被更改，则不会被更新。
    
    Specified by:
    
    getData在界面 RenderedImage
    
    结果
    
    一个 Raster是图像数据的副本。
    
    另请参见：
    
    setData(Raster)
  - getData
```
public Raster getData(Rectangle rect)
```
    计算并返回的任意区域BufferedImage 。返回的Raster是图像数据的副本，如果图像更改，则不会更新。
    
    Specified by:
    
    getData在界面 RenderedImage
    
    参数
    
    rect - 要退回的地区的 BufferedImage 。
    
    结果
    
    一个 Raster是BufferedImage指定区域的图像数据的 BufferedImage
    
    另请参见：
    
    setData(Raster)
  - copyData
```
public WritableRaster copyData(WritableRaster outRaster)
```
    计算的任意矩形区域BufferedImage ，并将其复制到指定的WritableRaster 。要计算的区域从指定的边界确定WritableRaster 。指定的WritableRaster必须有一个SampleModel是与此图像兼容。如果outRaster是null ，则创建适当的WritableRaster 。
    
    Specified by:
    
    copyData在界面 RenderedImage
    
    参数
    
    outRaster - a WritableRaster保留图像的返回部分，或 null
    
    结果
    
    参考提供或创建的 WritableRaster 。
  - setData
```
public void setData(Raster r)
```
    设置图像的矩形区域来指定的内容Raster r ，其被假设为在相同的坐标空间的BufferedImage 。操作被限制到的范围BufferedImage 。
    
    Specified by:
    
    setData在界面 WritableRenderedImage
    
    参数
    
    r - 指定的 Raster
    
    另请参见：
    
    getData() ， getData(Rectangle)
  - addTileObserver
```
public void addTileObserver(TileObserver to)
```
    添加瓦片观察器。如果观察者已经存在，它会收到多个通知。
    
    Specified by:
    
    addTileObserver在界面 WritableRenderedImage
    
    参数
    
    to - 指定的TileObserver
  - removeTileObserver
```
public void removeTileObserver(TileObserver to)
```
    移除瓦片观察者。如果观察员没有注册，没有任何反应。如果观察员注册了多个通知，则现在注册了一个较少的通知。
    
    Specified by:
    
    removeTileObserver在界面 WritableRenderedImage
    
    参数
    
    to - 指定的 TileObserver 。
  - isTileWritable
```
public boolean isTileWritable(int tileX,
                              int tileY)
```
    返回是否当前签出拼贴以进行书写。
    
    Specified by:
    
    isTileWritable在界面 WritableRenderedImage
    
    参数
    
    tileX - 图块的x索引。
    
    tileY - 瓷砖的y指数。
    
    结果
    
    true如果指定的索引指定的tile被签出用于写入; false否则。
    
    异常
    
    ArrayIndexOutOfBoundsException - 如果 tileX和 tileY都不等于0
  - getWritableTileIndices
```
public Point[] getWritableTileIndices()
```
    返回一组Point个对象，指示哪些图块被签出用于写入。退货null如果没有签出。
    
    Specified by:
    
    getWritableTileIndices在界面 WritableRenderedImage
    
    结果
    
    一个 Point数组，表示被签出用于书写的拼贴，或 null如果没有拼贴被签出用于书写）。
  - hasTileWriters
```
public boolean hasTileWriters()
```
    返回是否检出任何图块以进行写入。语义上相当于
```
  (getWritableTileIndices() != null). 
```
    Specified by:
    
    hasTileWriters在界面 WritableRenderedImage
    
    结果
    
    true如果任何瓦片被签出写作; false否则。
  - getWritableTile
```
public WritableRaster getWritableTile(int tileX,
                                      int tileY)
```
    检查一个瓦片写作。当瓦片从没有作家到有一位作家时，通知所有注册的TileObservers 。
    
    Specified by:
    
    getWritableTile在界面 WritableRenderedImage
    
    参数
    
    tileX - 图块的x索引
    
    tileY - 瓷砖的y指数
    
    结果
    
    一个 WritableRaster是由指定的索引指示的瓦片，用于书面签出。
  - releaseWritableTile
```
public void releaseWritableTile(int tileX,
                                int tileY)
```
    放弃写入瓦片的权限。如果呼叫者继续写入瓦片，结果是未定义的。对此方法的调用仅应与调用getWritableTile(int, int)的匹配对出现。任何其他导致未定义的结果。当瓦片从一位作家到没有作家时，所有注册的TileObservers都被通知。
    
    Specified by:
    
    releaseWritableTile在界面 WritableRenderedImage
    
    参数
    
    tileX - 图块的x索引
    
    tileY - 瓷砖的y指数
  - getTransparency
```
public int getTransparency()
```
    返回透明度。返回OPAQUE，BITMASK或TRANSLUCENT。
    
    Specified by:
    
    getTransparency在界面 Transparency
    
    结果
    
    透明度为 BufferedImage 。
    
    从以下版本开始：
    
    1.5
    
    另请参见：
    
    Transparency.OPAQUE, Transparency.BITMASK, Transparency.TRANSLUCENT

Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2014, Oracle and/or its affiliates. All rights reserved.

Class BufferedImage

Field Summary

Fields inherited from class java.awt.Image

Fields inherited from interface java.awt.Transparency

构造方法摘要

方法摘要

Methods inherited from class java.awt.Image

Methods inherited from class java.lang.Object

字段详细信息

TYPE_CUSTOM

TYPE_INT_RGB

TYPE_INT_ARGB

TYPE_INT_ARGB_PRE

TYPE_INT_BGR

TYPE_3BYTE_BGR

TYPE_4BYTE_ABGR

TYPE_4BYTE_ABGR_PRE

TYPE_USHORT_565_RGB

TYPE_USHORT_555_RGB

TYPE_BYTE_GRAY

TYPE_USHORT_GRAY

TYPE_BYTE_BINARY

TYPE_BYTE_INDEXED

构造方法详细信息

BufferedImage

BufferedImage

BufferedImage

方法详细信息

getType

getColorModel

getRaster

getAlphaRaster

getRGB

getRGB

setRGB

setRGB

getWidth

getHeight

getWidth

getHeight

getSource

getProperty

getProperty

getGraphics

createGraphics

getSubimage

isAlphaPremultiplied

coerceData

toString

getSources

getPropertyNames

getMinX

getMinY

getSampleModel

getNumXTiles

getNumYTiles

getMinTileX

getMinTileY

getTileWidth

getTileHeight

getTileGridXOffset

getTileGridYOffset

getTile

getData

getData

copyData

setData

addTileObserver

removeTileObserver

isTileWritable

getWritableTileIndices

hasTileWriters

getWritableTile

releaseWritableTile

getTransparency