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与访问图像数据缓冲区。一个 BufferedImage是由一个 ColorModel和 Raster图像数据。在 Raster的 SampleModel数量和类型的乐队必须匹配的数量和类型的 ColorModel要求代表它的颜色和alpha分量。所有的 BufferedImage对象的左上角坐标（0， 0）。任何 Raster用来构建一个 BufferedImage必须有X = 0和迷你= 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字节的α。
`static int`	`TYPE_4BYTE_ABGR_PRE` 代表8位RGBA颜色成分的蓝色、绿色和红色的图像，存储在3字节和1字节的α。
`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分量图像（五位红、五位绿色，五位蓝色）没有α。
`static int`	`TYPE_USHORT_565_RGB` 代表5-6-5 RGB分量图像（五位红，六位绿色，五位蓝色）没有α。
`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(int width, int height, int imageType, IndexColorModel cm)` 构建了一个 `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`代表与 `ColorModel`对象支持一个单独的空间 `BufferedImage`对象的Alpha通道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()` 返回最小的x坐标本 `BufferedImage`。
`int`	`getMinY()` 返回该 `BufferedImage`最小y坐标。
`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的平铺网格相对于原点，偏移为例，对瓷砖的位置的x坐标（0， 0）。
`int`	`getTileGridYOffset()` 返回Y网格相对于原点，偏移为例，对瓷砖的位置的y坐标（0， 0）。
`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()` 返回是否已进行α。
`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)` 设置指定的RGB值在这 `BufferedImage`像素。
`void`	`setRGB(int startX, int startY, int w, int h, int[] rgbArray, int offset, int scansize)` 数组在默认的RGB颜色模型的整数像素（type_int_argb）和默认的sRGB色彩空间，为图像数据的一部分。
`String`	`toString()` 返回一个 `String`表示这 `BufferedImage`对象及其价值。

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

- Field Detail
  - 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无α。当数据与非不透明的阿尔法存储在这种类型的图像，颜色数据必须被调整到一个非规则形式和阿尔法丢弃，在 AlphaComposite文档描述。
    
    另请参见：
    
    Constant Field Values
  - TYPE_INT_ARGB
```
public static final int TYPE_INT_ARGB
```
    代表8位RGBA颜色组件包装成整数像素的图像。图像具有 DirectColorModelα。在图像中的颜色数据是不规则的α。当这类作为一个 BufferedImage构造函数的 imageType参数，创建的图像与图像在JDK1.1创建和更早的版本一致。
    
    另请参见：
    
    Constant Field Values
  - TYPE_INT_ARGB_PRE
```
public static final int TYPE_INT_ARGB_PRE
```
    代表8位RGBA颜色组件包装成整数像素的图像。图像具有 DirectColorModelα。在图像中的颜色数据是进行α。
    
    另请参见：
    
    Constant Field Values
  - TYPE_INT_BGR
```
public static final int TYPE_INT_BGR
```
    代表8位RGB分量图像，对应于Windows或Solaris式BGR颜色模型，用蓝色、绿色和红色包装成整数像素。没有阿尔法。图像具有 DirectColorModel。当数据与非不透明的阿尔法存储在这种类型的图像，颜色数据必须被调整到一个非规则形式和阿尔法丢弃，在 AlphaComposite文档描述。
    
    另请参见：
    
    Constant Field Values
  - TYPE_3BYTE_BGR
```
public static final int TYPE_3BYTE_BGR
```
    代表8位RGB分量图像，对应一个Windows风格BGR颜色模型）与蓝色、绿色、红色3个字节存储。没有阿尔法。图像具有 ComponentColorModel。当数据与非不透明的阿尔法存储在这种类型的图像，颜色数据必须被调整到一个非规则形式和阿尔法丢弃，在 AlphaComposite文档描述。
    
    另请参见：
    
    Constant Field Values
  - TYPE_4BYTE_ABGR
```
public static final int TYPE_4BYTE_ABGR
```
    代表8位RGBA颜色成分的蓝色、绿色和红色的图像，存储在3字节和1字节的α。图像具有 ComponentColorModelα。在图像中的颜色数据是不规则的α。字节数据是在一个单一的字节数组中的顺序A，B，G，R从低到更高的字节地址在每个像素。
    
    另请参见：
    
    Constant Field Values
  - TYPE_4BYTE_ABGR_PRE
```
public static final int TYPE_4BYTE_ABGR_PRE
```
    代表8位RGBA颜色成分的蓝色、绿色和红色的图像，存储在3字节和1字节的α。图像具有 ComponentColorModelα。在图像中的颜色数据是进行α。字节数据是在一个单一的字节数组中的顺序A，B，G，R从低到更高的字节地址在每个像素。
    
    另请参见：
    
    Constant Field Values
  - TYPE_USHORT_565_RGB
```
public static final int TYPE_USHORT_565_RGB
```
    代表5-6-5 RGB分量图像（五位红，六位绿色，五位蓝色）没有α。这个形象有一个 DirectColorModel。当数据与非不透明的阿尔法存储在这种类型的图像，颜色数据必须被调整到一个非规则形式和阿尔法丢弃，在 AlphaComposite文档描述。
    
    另请参见：
    
    Constant Field Values
  - TYPE_USHORT_555_RGB
```
public static final int TYPE_USHORT_555_RGB
```
    代表5-5-5 RGB分量图像（五位红、五位绿色，五位蓝色）没有α。这个形象有一个 DirectColorModel。当数据与非不透明的阿尔法存储在这种类型的图像，颜色数据必须被调整到一个非规则形式和阿尔法丢弃，在 AlphaComposite文档描述。
    
    另请参见：
    
    Constant Field Values
  - TYPE_BYTE_GRAY
```
public static final int TYPE_BYTE_GRAY
```
    表示一个无符号字节的灰度图像，无索引。这个形象有一个cs_gray ColorSpace ComponentColorModel。当数据与非不透明的阿尔法存储在这种类型的图像，颜色数据必须被调整到一个非规则形式和阿尔法丢弃，在 AlphaComposite文档描述。
    
    另请参见：
    
    Constant Field Values
  - TYPE_USHORT_GRAY
```
public static final int TYPE_USHORT_GRAY
```
    表示一个无符号的短灰度图像，非索引的。这个形象有一个cs_gray ColorSpace ComponentColorModel。当数据与非不透明的阿尔法存储在这种类型的图像，颜色数据必须被调整到一个非规则形式和阿尔法丢弃，在 AlphaComposite文档描述。
    
    另请参见：
    
    Constant Field Values
  - TYPE_BYTE_BINARY
```
public static final int TYPE_BYTE_BINARY
```
    表示一个不透明的字节填充的1，2，或4位图像。图像有一个 IndexColorModel无α。当这种类型作为参数的构造函数， imageType BufferedImage以 imageType论点但没有 ColorModel的说法，一位形象与默认的sRGB色彩 ColorSpace两 IndexColorModel创建：{ 0，0 }和 0， { 255，255 } 255，。
    2或4位每像素可以被构造通过BufferedImage构造函数需要一个ColorModel争论提供了一个ColorModel与适当的Map大小的图像。
    
    每像素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创建一个256色的6 / 6 / 6 216-255由灰度值在默认的sRGB色彩空间的色彩与剩下的颜色立方体的调色板。
    颜色当数据储存在这种类型的图像，在色度图的颜色最接近的是由IndexColorModel和由此产生的索引存储。近似和α或颜色成分的损失结果，根据颜色的IndexColorModel映象。
    
    另请参见：
    
    Constant Field Values
- Constructor Detail
  - BufferedImage
```
public BufferedImage(int width,
                     int height,
                     int imageType)
```
    构建了一个 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的一个预定义的图像类型：type_byte_binary或type_byte_indexed。
    如果图像类型type_byte_binary，颜色模型中的项的数量来确定图像是否应该有1，2，或4位/像素。如果颜色模型有1个或2个条目，图像将有1位每像素。如果它有3个或4个条目，图像有2位每像素。如果它有在5和16之间的条目，图像将有4位每像素。否则，将抛出一个时。
    
    参数
    
    width -创建图像宽度
    
    height -创建图像高度
    
    imageType -创建的图像类型
    
    cm -创建的图像 IndexColorModel
    
    异常
    
    IllegalArgumentException如果图像类型是不type_byte_binary或type_byte_indexed或者图像类型是type_byte_binary和彩色Map已超过16个。
    
    另请参见：
    
    TYPE_BYTE_BINARY， TYPE_BYTE_INDEXED
  - BufferedImage
```
public BufferedImage(ColorModel cm,
                     WritableRaster raster,
                     boolean isRasterPremultiplied,
                     Hashtable<?,?> properties)
```
    构建与指定的 ColorModel和 Raster新 BufferedImage。如果在 Raster的 SampleModel数量和类型的乐队不匹配的 ColorModel要求代表它的颜色和alpha组件的数量和类型，一个 RasterFormatException抛出。这种方法可以乘或除的颜色 Raster数据由α在 ColorModel的 alphaPremultiplied状态匹配。这 BufferedImage特性可以通过在一个 Hashtable的 String / Object对建立。
    
    参数
    
    cm -新形象 ColorModel
    
    raster -图像数据 Raster
    
    isRasterPremultiplied -如果 true，在栅格数据已经进行α。
    
    properties - Hashtable的 String / Object对。
    
    异常
    
    RasterFormatException -如果在 Raster的 SampleModel数量和类型的乐队不匹配的数量和类型的 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
    
    结果
    
    这 BufferedImage的 ColorModel。
  - getRaster
```
public WritableRaster getRaster()
```
    返回 WritableRaster。
    
    结果
    
    这 BufferedImage的 WriteableRaster。
  - getAlphaRaster
```
public WritableRaster getAlphaRaster()
```
    返回一个 WritableRaster代表与 ColorModel对象支持一个单独的空间 BufferedImage对象的Alpha通道Alpha通道，如 ComponentColorModel和 DirectColorModel。返回 null如果没有alpha通道在图像与 ColorModel相关。这种方法假设所有其他比 IndexColorModel对象 ColorModel，如果 ColorModel支持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。有在返回的数据每个颜色分量，使用这种方法时，只有8位精度。
    一个ArrayOutOfBoundsException可能如果坐标不界抛出。然而，明确的界限检查是没有保证。
    
    参数
    
    x - x坐标的像素在默认的RGB颜色模型和sRGB色彩空间的像素
    
    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。有在返回的数据每个颜色分量，使用这种方法时，只有8位精度。用指定的坐标（X，Y ）在图像中，像素的ARGB可以这样访问：
```
像素= rgbarray [偏移+（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)
```
    设置指定的RGB值在这 BufferedImage像素。像素是在默认的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。有在返回的数据每个颜色分量，使用这种方法时，只有8位精度。用指定的坐标（X，Y ）在这个图像中，像素的ARGB可以这样访问：
```
像素= rgbarray [偏移+（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对象通知。属性名称“注释”应用于存储可提交给用户的可选注释，作为对图像、其源或其作者的描述的描述。
    
    Specified by:
    
    getProperty 方法重写，继承类 Image
    
    参数
    
    name -属性名称
    
    observer，接收关于图像信息通知 ImageObserver
    
    结果
    
    这是一个 Object属性所指定的 name或 null如果这个图像的性质尚不清楚。
    
    异常
    
    NullPointerException -如果属性名是空的。
    
    另请参见：
    
    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()
```
    返回是否已进行α。它返回 false如果没有α。
    
    结果
    
    true如果阿尔法已经进行 false否则。
  - coerceData
```
public void coerceData(boolean isAlphaPremultiplied)
```
    军队的数据匹配在 isAlphaPremultiplied变量指定的国家。它可以乘或除以彩色栅格数据的阿尔法，或什么都不做，如果数据是在正确的状态。
    
    参数
    
    isAlphaPremultiplied - true如果阿尔法已经进行 false否则。
  - toString
```
public String toString()
```
    返回一个 String表示这 BufferedImage对象及其价值。
    
    重写：
    
    toString 方法重写，继承类 Object
    
    结果
    
    一个 String代表这个 BufferedImage。
  - getSources
```
public Vector<RenderedImage> getSources()
```
    返回的对象， Vector RenderedImage的直接来源，没有这些直接来源的来源，对这 BufferedImage图像数据。此方法返回 null如果 BufferedImage没有关于其直接来源的信息。它返回一个空 Vector如果 BufferedImage没有直接的来源。
    
    Specified by:
    
    getSources 接口 RenderedImage
    
    结果
    
    一个 Vector包含此 BufferedImage对象的图像数据直接来源，或 null如果这 BufferedImage没有关于其直接来源的信息，或一个空的 Vector如果这 BufferedImage没有直接的来源。
  - getPropertyNames
```
public String[] getPropertyNames()
```
    返回的名字 getProperty(String)或 null公认的数组，如果没有财产的名字是公认的。
    
    Specified by:
    
    getPropertyNames 接口 RenderedImage
    
    结果
    
    一个包含所有的属性名称， getProperty(String)承认 String阵列；或 null如果没有属性名称是公认的。
  - getMinX
```
public int getMinX()
```
    返回最小的x坐标本 BufferedImage。这总是为零。
    
    Specified by:
    
    getMinX 接口 RenderedImage
    
    结果
    
    最小的x坐标本 BufferedImage。
  - getMinY
```
public int getMinY()
```
    返回该 BufferedImage最小y坐标。这始终是零。
    
    Specified by:
    
    getMinY 接口 RenderedImage
    
    结果
    
    这 BufferedImage最小y坐标。
  - getSampleModel
```
public SampleModel getSampleModel()
```
    返回与此相关的 SampleModel BufferedImage。
    
    Specified by:
    
    getSampleModel 接口 RenderedImage
    
    结果
    
    这 BufferedImage的 SampleModel。
  - 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的平铺网格相对于原点，偏移为例，对瓷砖的位置的x坐标（0， 0）。这总是为零。
    
    Specified by:
    
    getTileGridXOffset 接口 RenderedImage
    
    结果
    
    瓷砖网格的X偏移。
  - getTileGridYOffset
```
public int getTileGridYOffset()
```
    返回Y网格相对于原点，偏移为例，对瓷砖的位置的y坐标（0， 0）。这总是为零。
    
    Specified by:
    
    getTileGridYOffset 接口 RenderedImage
    
    结果
    
    瓷砖网格的Y偏移。
  - getTile
```
public Raster getTile(int tileX,
                      int tileY)
```
    返回瓦（ tileX， tileY）。注意， tileX和 tileY指数为瓷砖阵列像素位置，不。的 Raster，还是活的，这意味着它被更新，如果改变图像。
    
    Specified by:
    
    getTile 接口 RenderedImage
    
    参数
    
    tileX -要求的瓷砖在瓷砖阵列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指定区域的图像数据
    
    另请参见：
    
    setData(Raster)
  - copyData
```
public WritableRaster copyData(WritableRaster outRaster)
```
    计算的 BufferedImage任意矩形区域并将其复制到指定的 WritableRaster。该区域将计算机从指定的 WritableRaster边界确定。指定的 WritableRaster必须 SampleModel，这个图像兼容。如果 outRaster是 null，适当的 WritableRaster创建。
    
    Specified by:
    
    copyData 接口 RenderedImage
    
    参数
    
    outRaster - 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如果由指定索引指定的瓷砖被检查出来的 false否则写作。
    
    异常
    
    ArrayIndexOutOfBoundsException -如果 tileX和 tileY不等于0
  - getWritableTileIndices
```
public Point[] getWritableTileIndices()
```
    返回 Point对象指示瓦检查写数组。返回 null如果没有检查出来。
    
    Specified by:
    
    getWritableTileIndices 接口 WritableRenderedImage
    
    结果
    
    一个 Point阵列表明进行了写作的瓷砖，或 null如果没有砖进行了写作。
  - hasTileWriters
```
public boolean hasTileWriters()
```
    返回是否有任何瓷砖进行了书面检查。语义上等同于
```
（getwritabletileindices()！=零）。
```
    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()
```
    返回透明度。返回的位掩码，不透明或半透明。
    
    Specified by:
    
    getTransparency 接口 Transparency
    
    结果
    
    这 BufferedImage透明度。
    
    从以下版本开始：
    
    一点五
    
    另请参见：
    
    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

Field Detail

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

Constructor Detail

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