Java java.awt.image 类 BufferedImage（JDK5）

162 阅读 0 评论 0 点赞

所有类

概述

软件包

类

使用

树

已过时

索引

帮助

摘要：嵌套 | 字段 | 构造方法 | 方法

详细信息：字段 | 构造方法 | 方法

java.awt.image
类 BufferedImage

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

所有已实现的接口：: RenderedImage, WritableRenderedImage, Transparency

public class BufferedImage
extends Image

implements WritableRenderedImage, Transparency
extends Image
implements WritableRenderedImage, Transparency

BufferedImage 子类描述具有可访问图像数据缓冲区的 Image。BufferedImage 由图像数据的 ColorModel 和 Raster 组成。Raster 的 SampleModel 中 band 的数量和类型必须与 ColorModel 所要求的数量和类型相匹配，以表示其颜色和 alpha 分量。所有 BufferedImage 对象的左上角坐标都为 (0, 0)。因此，用来构造 BufferedImage 的任何 Raster 都必须满足：minX=0 且 minY=0。

此类依靠 Raster 的数据获取和设置方法，以及 ColorModel 的颜色特征化方法。

另请参见：: ColorModel, Raster, WritableRaster

字段摘要
`static int`	`TYPE_3BYTE_BGR` 表示一个具有 8 位 RGB 颜色分量的图像，对应于 Windows 风格的 BGR 颜色模型，具有用 3 字节存储的 Blue、Green 和 Red 三种颜色。
`static int`	`TYPE_4BYTE_ABGR` 表示一个具有 8 位 RGBA 颜色分量的图像，具有用 3 字节存储的 Blue、Green 和 Red 颜色以及 1 字节的 alpha。
`static int`	`TYPE_4BYTE_ABGR_PRE` 表示一个具有 8 位 RGBA 颜色分量的图像，具有用 3 字节存储的 Blue、Green 和 Red 颜色以及 1 字节的 alpha。
`static int`	`TYPE_BYTE_BINARY` 表示一个不透明的以字节打包的 1、2 或 4 位图像。
`static int`	`TYPE_BYTE_GRAY` 表示无符号 byte 灰度级图像（无索引）。
`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 颜色模型，具有打包为整数像素的 Blue、Green 和 Red 三种颜色。
`static int`	`TYPE_INT_RGB` 表示一个图像，该图像具有打包成整数像素的 8 位 RGB 颜色分量。
`static int`	`TYPE_USHORT_555_RGB` 表示一个具有 5-5-5 RGB 颜色分量（5 位 red、5 位 green、5 位 blue）的图像，不带 alpha。
`static int`	`TYPE_USHORT_565_RGB` 表示一个具有 5-6-5 RGB 颜色分量（5 位 red、6 位 green、5 位 blue）的图像，不带 alpha。
`static int`	`TYPE_USHORT_GRAY` 表示一个无符号 short 灰度级图像（无索引）。

从类 java.awt.Image 继承的字段
`accelerationPriority, SCALE_AREA_AVERAGING, SCALE_DEFAULT, SCALE_FAST, SCALE_REPLICATE, SCALE_SMOOTH, UndefinedProperty`

从接口 java.awt.Transparency 继承的字段
`BITMASK, OPAQUE, TRANSLUCENT`

构造方法摘要
`BufferedImage(ColorModel cm, WritableRaster raster, boolean isRasterPremultiplied, Hashtable<?,?> properties)` 构造一个具有指定 `ColorModel` 和 `Raster` 的新 `BufferedImage`。
`BufferedImage(int width, int height, int imageType)` 构造一个类型为预定义图像类型之一的 `BufferedImage`。
`BufferedImage(int width, int height, int imageType, IndexColorModel cm)` 构造一个类型为预定义图像类型之一的 `BufferedImage`：TYPE_BYTE_BINARY 或 TYPE_BYTE_INDEXED。

方法摘要
`void`	`addTileObserver(TileObserver to)` 添加一个 tile observer。
`void`	`coerceData(boolean isAlphaPremultiplied)` 强制该数据与 `isAlphaPremultiplied` 变量中指定的状态相匹配。
`WritableRaster`	`copyData(WritableRaster outRaster)` 计算 `BufferedImage` 的一个任意的矩形区域，并将其复制到指定的 `WritableRaster`。
`Graphics2D`	`createGraphics()` 创建一个 `Graphics2D`，可以将它绘制到此 `BufferedImage` 中。
`void`	`flush()` 刷新所有正用于缓存优化信息的资源。
`WritableRaster`	`getAlphaRaster()` 返回一个 `WritableRaster`，它使用支持单独空间 alpha 通道的 `ColorModel` 对象（比如 `ComponentColorModel` 和 `DirectColorModel`）表示 `BufferedImage` 对象的 alpha 通道。
`ImageCapabilities`	`getCapabilities(GraphicsConfiguration gc)` 重写 Image.getCapabilities(gc) 以获得其 surfaceManager 的能力。
`ColorModel`	`getColorModel()` 返回 `ColorModel`。
`Raster`	`getData()` 作为一个大 tile 返回图像。
`Raster`	`getData(Rectangle rect)` 计算并返回 `BufferedImage` 的一个任意区域。
`Graphics`	`getGraphics()` 此方法返回 `Graphics2D`，但此处是出于向后兼容性的考虑。
`int`	`getHeight()` 返回 `BufferedImage` 的高度。
`int`	`getHeight(ImageObserver observer)` 返回 `BufferedImage` 的高度。
`int`	`getMinTileX()` 返回 x 方向的最小 tile 索引。
`int`	`getMinTileY()` 返回 y 方向的最小 tile 索引。
`int`	`getMinX()` 返回此 `BufferedImage` 的最小 x 坐标。
`int`	`getMinY()` 返回此 `BufferedImage` 的最小 y 坐标。
`int`	`getNumXTiles()` 返回 x 方向的 tile 数。
`int`	`getNumYTiles()` 返回 y 方向的 tile 数。
`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()` 返回与此 `BufferedImage` 相关的 `SampleModel`。
`ImageProducer`	`getSource()` 返回产生该图像像素的对象。
`Vector<RenderedImage>`	`getSources()` 返回 `RenderedImage` 对象的 `Vector`，该对象是此 `BufferedImage` 的图像数据的直接来源，而不是这些直接来源的来源。
`BufferedImage`	`getSubimage(int x, int y, int w, int h)` 返回由指定矩形区域定义的子图像。
`Raster`	`getTile(int tileX, int tileY)` 返回 tile (`tileX`, `tileY`)。
`int`	`getTileGridXOffset()` 返回 tile 网格相对于原点（例如，tile (0, 0) 位置的 x 坐标）的 x 偏移量。
`int`	`getTileGridYOffset()` 返回 tile 网格相对于原点（例如，tile (0, 0) 位置的 y 坐标）的 y 偏移量。
`int`	`getTileHeight()` 返回 tile 高度（以像素为单位）。
`int`	`getTileWidth()` 返回 tile 宽度（以像素为单位）。
`int`	`getTransparency()` 返回透明度。
`int`	`getType()` 返回图像类型。
`int`	`getWidth()` 返回 `BufferedImage` 的宽度。
`int`	`getWidth(ImageObserver observer)` 返回 `BufferedImage` 的宽度。
`WritableRaster`	`getWritableTile(int tileX, int tileY)` 为写入签出一个 tile。
`Point[]`	`getWritableTileIndices()` 返回 `Point` 对象的数组，它指示为写入签出了哪些 tile。
`boolean`	`hasTileWriters()` 返回是否有为写入而签出的 tile。
`boolean`	`isAlphaPremultiplied()` 返回是否已预乘以 alpha。
`boolean`	`isTileWritable(int tileX, int tileY)` 返回当前是否正在为写入签出 tile。
`void`	`releaseWritableTile(int tileX, int tileY)` 放弃写入一个 tile 的权限。
`void`	`removeTileObserver(TileObserver to)` 移除一个 tile observer。
`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` 表示形式。

从类 java.awt.Image 继承的方法
`getAccelerationPriority, getScaledInstance, setAccelerationPriority`

从类 java.lang.Object 继承的方法
`clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait`

字段详细信息

TYPE_CUSTOM

public static final int TYPE_CUSTOM

没有识别出图像类型，因此它必定是一个自定义图像。此类型仅用作 getType() 方法的返回值。

另请参见：: 常量字段值

TYPE_INT_RGB

public static final int TYPE_INT_RGB

表示一个图像，该图像具有打包成整数像素的 8 位 RGB 颜色分量。该图像具有不带 alpha 的 DirectColorModel。当具有透明 alpha 的数据存储在此类型的图像中时，必须调整颜色数据以适应非预乘形式和已丢弃的 alpha，如 AlphaComposite 文档中所描述。

另请参见：: 常量字段值

TYPE_INT_ARGB

public static final int TYPE_INT_ARGB

表示一个图像，该图像具有打包成整数像素的 8 位 RGBA 颜色分量。该图像具有带 alpha 的 DirectColorModel。不要认为此图像中的颜色数据已预乘以 alpha。当使用此类型作为 BufferedImage 构造方法的 imageType 参数时，所创建的图像与 JDK1.1 和更早期版本中创建的图像一致。

另请参见：: 常量字段值

TYPE_INT_ARGB_PRE

public static final int TYPE_INT_ARGB_PRE

表示一个图像，该图像具有打包成整数像素的 8 位 RGBA 颜色分量。该图像具有带 alpha 的 DirectColorModel。可以认为此图像中的颜色数据已预乘以 alpha。

另请参见：: 常量字段值

TYPE_INT_BGR

public static final int TYPE_INT_BGR

表示一个具有 8 位 RGB 颜色分量的图像，对应于 Windows 或 Solaris 风格的 BGR 颜色模型，具有打包为整数像素的 Blue、Green 和 Red 三种颜色。不存在 alpha。该图像具有一个 DirectColorModel。当具有透明 alpha 的数据存储在此类型的图像中时，必须调整颜色数据以适应非预乘形式和已丢弃的 alpha，如 AlphaComposite 文档中所描述。

另请参见：: 常量字段值

TYPE_3BYTE_BGR

public static final int TYPE_3BYTE_BGR

表示一个具有 8 位 RGB 颜色分量的图像，对应于 Windows 风格的 BGR 颜色模型，具有用 3 字节存储的 Blue、Green 和 Red 三种颜色。不存在 alpha。该图像具有一个 ComponentColorModel。当具有透明 alpha 的数据存储在此类型的图像中时，必须调整颜色数据以适应非预乘形式和已丢弃的 alpha，如 AlphaComposite 文档中所描述。

另请参见：: 常量字段值

TYPE_4BYTE_ABGR

public static final int TYPE_4BYTE_ABGR

表示一个具有 8 位 RGBA 颜色分量的图像，具有用 3 字节存储的 Blue、Green 和 Red 颜色以及 1 字节的 alpha。该图像具有带 alpha 的 ComponentColorModel。不要认为此图像中的颜色数据已预乘以 alpha。按照每个像素中字节地址从低到高的顺序 A、B、G、R 将字节数据交插到单个字节数组中。

另请参见：: 常量字段值