|
JavaTM 2 Platform Standard Ed. 5.0 |
|||||||||
上一个类 下一个类 | 框架 无框架 所有类 | |||||||||
摘要: 嵌套 | 字段 | 构造方法 | 方法 | 详细信息: 字段 | 构造方法 | 方法 |
java.lang.Objectjava.awt.Image
java.awt.image.BufferedImage
public class BufferedImage
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 |
字段详细信息 |
---|
public static final int TYPE_CUSTOM
public static final int TYPE_INT_RGB
DirectColorModel
。当具有透明 alpha 的数据存储在此类型的图像中时,必须调整颜色数据以适应非预乘形式和已丢弃的 alpha,如 AlphaComposite
文档中所描述。
public static final int TYPE_INT_ARGB
DirectColorModel
。不要认为此图像中的颜色数据已预乘以 alpha。当使用此类型作为 BufferedImage
构造方法的 imageType
参数时,所创建的图像与 JDK1.1 和更早期版本中创建的图像一致。
public static final int TYPE_INT_ARGB_PRE
DirectColorModel
。可以认为此图像中的颜色数据已预乘以 alpha。
public static final int TYPE_INT_BGR
DirectColorModel
。当具有透明 alpha 的数据存储在此类型的图像中时,必须调整颜色数据以适应非预乘形式和已丢弃的 alpha,如 AlphaComposite
文档中所描述。
public static final int TYPE_3BYTE_BGR
ComponentColorModel
。当具有透明 alpha 的数据存储在此类型的图像中时,必须调整颜色数据以适应非预乘形式和已丢弃的 alpha,如 AlphaComposite
文档中所描述。
public static final int TYPE_4BYTE_ABGR
ComponentColorModel
。不要认为此图像中的颜色数据已预乘以 alpha。按照每个像素中字节地址从低到高的顺序 A、B、G、R 将字节数据交插到单个字节数组中。
public static final int TYPE_4BYTE_ABGR_PRE
ComponentColorModel
。可以认为此图像中的颜色数据已预乘以 alpha。按照每个像素中字节地址从低到高的顺序 A、B、G、R 将字节数据交插到单个字节数组中。
public static final int TYPE_USHORT_565_RGB
DirectColorModel
。当具有透明 alpha 的数据存储在此类型的图像中时,必须调整颜色数据以适应非预乘形式和已丢弃的 alpha,如 AlphaComposite
文档中所描述。
public static final int TYPE_USHORT_555_RGB
DirectColorModel
。当具有透明 alpha 的数据存储在此类型的图像中时,必须调整颜色数据以适应非预乘形式和已丢弃的 alpha,如 AlphaComposite
文档中所描述。
public static final int TYPE_BYTE_GRAY
ColorSpace
的 ComponentColorModel
。当具有透明 alpha 的数据存储在此类型的图像中时,必须调整颜色数据以适应非预乘形式和已丢弃的 alpha,如 AlphaComposite
文档中所描述。
public static final int TYPE_USHORT_GRAY
ColorSpace
的 ComponentColorModel
。当具有透明 alpha 的数据存储在此类型的图像中时,必须调整颜色数据以适应非预乘形式和已丢弃的 alpha,如 AlphaComposite
文档中所描述。
public static final int TYPE_BYTE_BINARY
IndexColorModel
。当此类型用作 BufferedImage
构造方法(带 imageType
参数而不是 ColorModel
参数)的 imageType
参数时,创建一个 1 位图像,其 IndexColorModel
具有默认 sRGB ColorSpace
中的两种颜色:{0, 0, 0} 和 {255, 255, 255}。
每个像素 2 位或 4 位的图像可以通过 BufferedImage
构造方法构造,该构造方法带一个 ColorModel
参数,这通过提供一个具有合适映射大小的 ColorModel
实现。
每个像素 8 位的图像应该使用 TYPE_BYTE_INDEXED
还是 TYPE_BYTE_GRAY
图像类型取决于它们的 ColorModel
。
当颜色数据存储在此类型的图像中时,由 IndexColorModel
确定 colormap 中最接近的颜色,并存储得到的索引。根据 IndexColorModel
colormap 中的颜色,可以得到 alpha 分量或颜色分量的近似值及丢失的 alpha 或颜色分量。
public static final int TYPE_BYTE_INDEXED
BufferedImage
构造方法(带 imageType
参数而不带 ColorModel
参数 )的 imageType
参数时,创建一个 IndexColorModel
,它具有 256 色 6/6/6 三色调色板,其余从 216 到 255 的颜色由默认 sRGB ColorSpace 的灰度级值填充。
当颜色数据存储在此类型的图像中时,由 IndexColorModel
确定 colormap 中最接近的颜色,并存储得到的索引。根据 IndexColorModel
colormap 中的颜色,可以得到 alpha 分量或颜色分量的近似值及丢失的 alpha 或颜色分量。
构造方法详细信息 |
---|
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
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 位。否则,将抛出 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
public BufferedImage(ColorModel cm, WritableRaster raster, boolean isRasterPremultiplied, Hashtable<?,?> properties)
ColorModel
和 Raster
的新 BufferedImage
。如果 Raster
的 SampleModel
中的 band 的数量和类型与 ColorModel
(表示其颜色和 alpha 分量)所要求的数量和类型不匹配,则抛出 RasterFormatException
。此方法可以将 Raster
颜色数据乘以或除以 alpha,从而与 ColorModel
中的 alphaPremultiplied
状态相匹配。可以通过传入 String
/Object
对的 Hashtable
来建立此 BufferedImage
的属性。
cm
- 新图像的 ColorModel
raster
- 图像数据的 Raster
isRasterPremultiplied
- 如果为 true
,则 raster 中的数据已预乘以 alpha。properties
- String
/Object
对的 Hashtable
。
RasterFormatException
- 如果 Raster
的 SampleModel
中的 band 的数量和类型与 ColorModel
(表示其颜色和 alpha 分量)所要求的数量和类型不匹配。
IllegalArgumentException
- 如果 raster
与 cm
不一致ColorModel
,
Raster
,
WritableRaster
方法详细信息 |
---|
public int getType()
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
public ColorModel getColorModel()
ColorModel
。
RenderedImage
中的 getColorModel
BufferedImage
的 ColorModel
。public WritableRaster getRaster()
WritableRaster
。
BufferedImage
的 WriteableRaster
。public WritableRaster getAlphaRaster()
WritableRaster
,它使用支持单独空间 alpha 通道的 ColorModel
对象(比如 ComponentColorModel
和 DirectColorModel
)表示 BufferedImage
对象的 alpha 通道。如果此图像中没有与 ColorModel
关联的 alpha 通道,则返回 null
。此方法假定除了 IndexColorModel
之外的所有 ColorModel
对象都具有一个单独的 alpha 通道(如果 ColorModel
支持 alpha),该通道存储为图像数据的最后一个 band。如果该图像使用一个在 lookup table 中具有 alpha 的 IndexColorModel
,则此方法返回 null
,因为不存在空间上离散的 alpha 通道。此方法创建一个新的 WritableRaster
,但是共享原数据数组。
WritableRaster
,如果此 BufferedImage
不具有与其 ColorModel
关联的 alpha 通道,则返回 null
。public int getRGB(int x, int y)
ColorModel
不匹配,则发生颜色转换。在使用此方法所返回的数据中,每个颜色分量只有 8 位精度。
如果坐标不在边界内部,则可能抛出 ArrayOutOfBoundsException
。但是,不保证进行显式的边界检查。
x, y
- 像素的坐标,从该坐标得到默认 RGB 颜色模型和 sRGB 颜色空间中的像素
setRGB(int, int, int)
,
setRGB(int, int, int, int, int[], int, int)
public int[] getRGB(int startX, int startY, int w, int h, int[] rgbArray, int offset, int scansize)
ColorModel
不匹配,则发生颜色转换。在使用此方法所返回的数据中,每个颜色分量只有 8 位精度。通过图像中指定的坐标 (x, y),ARGB 像素可以按如下方式访问:
pixel = rgbArray[offset + (y-startY)*scansize + (x-startX)];
如果该区域不在边界内部,则可能抛出 ArrayOutOfBoundsException
。但是,不保证进行显式的边界检查。
startX, startY
- 起始坐标w
- 区域的宽度h
- 区域的高度rgbArray
- 如果不为 null
,则在此写入 rgb 像素offset
- 相对于 rgbArray
的偏移量scansize
- rgbArray
的 scanline 间距
setRGB(int, int, int)
,
setRGB(int, int, int, int, int[], int, int)
public void setRGB(int x, int y, int rgb)
BufferedImage
中的像素设置为指定的 RGB 值。假定该像素处于默认 RGB 颜色模型、TYPE_INT_ARGB 和默认 sRGB 颜色空间。对于具有 IndexColorModel
的图像,则选择最接近的颜色的索引。
如果坐标不在边界内部,则可能抛出 ArrayOutOfBoundsException
。但是,不保证进行显式的边界检查。
x, y
- 要设置的像素坐标rgb
- RGB 值getRGB(int, int)
,
getRGB(int, int, int, int, int[], int, int)
public void setRGB(int startX, int startY, int w, int h, int[] rgbArray, int offset, int scansize)
ColorModel
不匹配,则发生颜色转换。在使用此方法所返回的数据中,每个颜色分量只有 8 位精度。通过此图像中指定的坐标 (x, y),ARGB 像素可以按如下方式访问:
pixel = rgbArray[offset + (y-startY)*scansize + (x-startX)];警告:无抖动发生。
如果该区域不在边界内部,则可能抛出 ArrayOutOfBoundsException
。但是,不保证进行显式的边界检查。
startX, startY
- 起始坐标w
- 区域的宽度h
- 区域的高度rgbArray
- rgb 像素offset
- 相对于 rgbArray
的偏移量scansize
- rgbArray
的 scanline 间距getRGB(int, int)
,
getRGB(int, int, int, int, int[], int, int)
public int getWidth()
BufferedImage
的宽度。
RenderedImage
中的 getWidth
BufferedImage
的宽度public int getHeight()
BufferedImage
的高度。
RenderedImage
中的 getHeight
BufferedImage
的高度public int getWidth(ImageObserver observer)
BufferedImage
的宽度。
Image
中的 getWidth
observer
- 忽略
BufferedImage
的宽度Image.getHeight(java.awt.image.ImageObserver)
,
ImageObserver
public int getHeight(ImageObserver observer)
BufferedImage
的高度。
Image
中的 getHeight
observer
- 忽略
BufferedImage
的高度Image.getWidth(java.awt.image.ImageObserver)
,
ImageObserver
public ImageProducer getSource()
Image
中的 getSource
ImageProducer
。ImageProducer
public Object getProperty(String name, ImageObserver observer)
UndefinedProperty
字段。如果此图像的属性目前未知,则此方法返回 null
,然后通知 ImageObserver
对象。属性名 "comment" 应该用于存储可选注释,它可以作为对图像的描述(来源或作者)呈现给用户。
Image
中的 getProperty
name
- 属性名observer
- 接收关于图像信息通知的 ImageObserver
Object
,它是由指定 name
所引用的属性,如果此图像的属性尚未知,则返回 null
。
NullPointerException
- 如果属性名为 null。
另请参见:
ImageObserver
,
Image.UndefinedProperty
getProperty
public Object getProperty(String name)
- 按名称返回图像的属性。
- 指定者:
- 接口
RenderedImage
中的 getProperty
- 参数:
name
- 属性名
- 返回:
Object
,它是由指定 name
所引用的属性。
- 抛出:
NullPointerException
- 如果属性名为 null。
另请参见:
Image.UndefinedProperty
flush
public void flush()
- 刷新所有正用于缓存优化信息的资源。基础像素数据不受影响。
- 指定者:
- 类
Image
中的 flush
getGraphics
public Graphics getGraphics()
- 此方法返回
Graphics2D
,但此处是出于向后兼容性的考虑。createGraphics
更为方便,因为它被声明为返回 Graphics2D
。
- 指定者:
- 类
Image
中的 getGraphics
- 返回:
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, y
- 指定矩形区域的左上角坐标w
- 指定矩形区域的宽度h
- 指定矩形区域的高度
- 返回:
BufferedImage
,它是此 BufferedImage
的子图像。
- 抛出:
RasterFormatException
- 如果指定区域不包含在此 BufferedImage
中。
isAlphaPremultiplied
public boolean isAlphaPremultiplied()
- 返回是否已预乘以 alpha。如果不存在 alpha,则返回
false
。
- 返回:
- 如果已经预乘以 alpha,则返回
true
;否则,返回 false
。
coerceData
public void coerceData(boolean isAlphaPremultiplied)
- 强制该数据与
isAlphaPremultiplied
变量中指定的状态相匹配。可以将颜色 raster 数据乘以或除以 alpha,如果该数据处于正确状态,则不执行任何操作。
- 参数:
isAlphaPremultiplied
- 如果已经预乘以 alpha,则为 true
;否则为 false
。
toString
public String toString()
- 返回此
BufferedImage
对象及其值的 String
表示形式。
- 覆盖:
- 类
Object
中的 toString
- 返回:
- 此
BufferedImage
的 String
表示形式。
getSources
public Vector<RenderedImage> getSources()
- 返回
RenderedImage
对象的 Vector
,该对象是此 BufferedImage
的图像数据的直接来源,而不是这些直接来源的来源。如果 BufferedImage
没有关于其直接来源的信息,则此方法返回 null
。如果 BufferedImage
没有直接来源,则它返回一个空 Vector
。
- 指定者:
- 接口
RenderedImage
中的 getSources
- 返回:
- 一个
Vector
,它包含此 BufferedImage
对象的图像日期的直接来源,如果此 BufferedImage
没有关于其直接来源的信息,则返回 null
,如果此 BufferedImage
没有直接来源,则返回一个空 Vector
。
getPropertyNames
public String[] getPropertyNames()
- 返回由
getProperty(String)
识别的名称数组;如果没有识别出属性名,则返回 null
。
- 指定者:
- 接口
RenderedImage
中的 getPropertyNames
- 返回:
- 一个
String
数组,它包含 getProperty(String)
识别的所有属性名;如果没有识别出属性名,则返回 null
。
getMinX
public int getMinX()
- 返回此
BufferedImage
的最小 x 坐标。最小 x 坐标始终为零。
- 指定者:
- 接口
RenderedImage
中的 getMinX
- 返回:
- 此
BufferedImage
的最小 x 坐标。
getMinY
public int getMinY()
- 返回此
BufferedImage
的最小 y 坐标。最小 y 坐标始终为零。
- 指定者:
- 接口
RenderedImage
中的 getMinY
- 返回:
- 此
BufferedImage
的最小 y 坐标。
getSampleModel
public SampleModel getSampleModel()
- 返回与此
BufferedImage
相关的 SampleModel
。
- 指定者:
- 接口
RenderedImage
中的 getSampleModel
- 返回:
- 此
BufferedImage
的 SampleModel
。
getNumXTiles
public int getNumXTiles()
- 返回 x 方向的 tile 数。它始终为 1。
- 指定者:
- 接口
RenderedImage
中的 getNumXTiles
- 返回:
- x 方向的 tile 数。
getNumYTiles
public int getNumYTiles()
- 返回 y 方向的 tile 数。它始终为 1。
- 指定者:
- 接口
RenderedImage
中的 getNumYTiles
- 返回:
- y 方向的 tile 数。
getMinTileX
public int getMinTileX()
- 返回 x 方向的最小 tile 索引。它始终为零。
- 指定者:
- 接口
RenderedImage
中的 getMinTileX
- 返回:
- x 方向的最小 tile 索引。
getMinTileY
public int getMinTileY()
- 返回 y 方向的最小 tile 索引。它始终为零。
- 指定者:
- 接口
RenderedImage
中的 getMinTileY
- 返回:
- y 方向的最小 tile 索引。
getTileWidth
public int getTileWidth()
- 返回 tile 宽度(以像素为单位)。
- 指定者:
- 接口
RenderedImage
中的 getTileWidth
- 返回:
- tile 宽度(以像素为单位)。
getTileHeight
public int getTileHeight()
- 返回 tile 高度(以像素为单位)。
- 指定者:
- 接口
RenderedImage
中的 getTileHeight
- 返回:
- tile 高度(以像素为单位)。
getTileGridXOffset
public int getTileGridXOffset()
- 返回 tile 网格相对于原点(例如,tile (0, 0) 位置的 x 坐标)的 x 偏移量。它始终为零。
- 指定者:
- 接口
RenderedImage
中的 getTileGridXOffset
- 返回:
- tile 网格的 x 偏移量。
getTileGridYOffset
public int getTileGridYOffset()
- 返回 tile 网格相对于原点(例如,tile (0, 0) 位置的 y 坐标)的 y 偏移量。它始终为零。
- 指定者:
- 接口
RenderedImage
中的 getTileGridYOffset
- 返回:
- tile 网格的 y 偏移量。
getTile
public Raster getTile(int tileX,
int tileY)
- 返回 tile (
tileX
, tileY
)。注意,tileX
和 tileY
是 tile 数组中的索引,而不是像素位置。返回的 Raster
是活动的,意思是如果图像改变,则 Raster
会更新。
- 指定者:
- 接口
RenderedImage
中的 getTile
- 参数:
tileX
- tile 数组中所请求的 tile 的 x 索引tileY
- tile 数组中所请求的 tile 的 y 索引
- 返回:
Raster
,它是由参数 tileX
和 tileY
定义的 tile。
- 抛出:
ArrayIndexOutOfBoundsException
- 如果 tileX
和 tileY
都不等于 0
getData
public Raster getData()
- 作为一个大 tile 返回图像。返回的
Raster
是图像数据的副本,图像改变时它不会更新。
- 指定者:
- 接口
RenderedImage
中的 getData
- 返回:
Raster
,图像数据的副本。- 另请参见:
setData(Raster)
getData
public Raster getData(Rectangle rect)
- 计算并返回
BufferedImage
的一个任意区域。返回的 Raster
是图像数据的副本,图像改变时它不会更新。
- 指定者:
- 接口
RenderedImage
中的 getData
- 参数:
rect
- 要返回的 BufferedImage
区域。
- 返回:
Raster
,它是 BufferedImage
的指定区域的图像数据的副本- 另请参见:
setData(Raster)
copyData
public WritableRaster copyData(WritableRaster outRaster)
- 计算
BufferedImage
的一个任意的矩形区域,并将其复制到指定的 WritableRaster
。要计算的区域由指定 WritableRaster
的边界确定。指定的 WritableRaster
必须具有与此图像兼容的 SampleModel
。如果 outRaster
为 null
,则创建一个合适的 WritableRaster
。
- 指定者:
- 接口
RenderedImage
中的 copyData
- 参数:
outRaster
- 保存图像返回部分的 WritableRaster
, 或者为 null
- 返回:
- 对所提供的或创建的
WritableRaster
的引用。
setData
public void setData(Raster r)
- 将图像的矩形区域设置为指定
Raster
r
的内容,假定该区域与 BufferedImage
处于相同的坐标空间。操作被限制在 BufferedImage
的边界内。
- 指定者:
- 接口
WritableRenderedImage
中的 setData
- 参数:
r
- 指定的 Raster
- 另请参见:
getData()
,
getData(Rectangle)
addTileObserver
public void addTileObserver(TileObserver to)
- 添加一个 tile observer。如果该 observer 已经存在,则它接收多个通知。
- 指定者:
- 接口
WritableRenderedImage
中的 addTileObserver
- 参数:
to
- 指定的 TileObserver
removeTileObserver
public void removeTileObserver(TileObserver to)
- 移除一个 tile observer。如果 observer 没有注册,则不发生任何操作。如果 observer 为多个通知注册,则现在其注册的通知数将减少一个。
- 指定者:
- 接口
WritableRenderedImage
中的 removeTileObserver
- 参数:
to
- 指定的 TileObserver
。
isTileWritable
public boolean isTileWritable(int tileX,
int tileY)
- 返回当前是否正在为写入签出 tile。
- 指定者:
- 接口
WritableRenderedImage
中的 isTileWritable
- 参数:
tileX
- tile 的 x 索引。tileY
- tile 的 y 索引。
- 返回:
- 如果为写入签出了由指定索引所指定的 tile,则返回
true
;否则,返回 false
。
- 抛出:
ArrayIndexOutOfBoundsException
- 如果 tileX
和 tileY
都不等于 0
getWritableTileIndices
public Point[] getWritableTileIndices()
- 返回
Point
对象的数组,它指示为写入签出了哪些 tile。如果没有签出任何 tile,则返回 null
。
- 指定者:
- 接口
WritableRenderedImage
中的 getWritableTileIndices
- 返回:
- 一个
Point
数组,它指示为写入而签出的 tile;如果没有为写入而签出的 tile,则返回 null
。
hasTileWriters
public boolean hasTileWriters()
- 返回是否有为写入而签出的 tile。语义上等效于
(getWritableTileIndices() != null).
- 指定者:
- 接口
WritableRenderedImage
中的 hasTileWriters
- 返回:
- 如果为写入签出了任何 tile,则返回
true
;否则,返回 false
。
getWritableTile
public WritableRaster getWritableTile(int tileX,
int tileY)
- 为写入签出一个 tile。当一个 tile 从没有 writer 变为有一个 writer 时,通知所有已注册的
TileObservers
。
- 指定者:
- 接口
WritableRenderedImage
中的 getWritableTile
- 参数:
tileX
- tile 的 x 索引tileY
- tile 的 y 索引
- 返回:
- 一个
WritableRaster
,它是为写入而签出的、由指定索引指示的 tile。
releaseWritableTile
public void releaseWritableTile(int tileX,
int tileY)
- 放弃写入一个 tile 的权限。如果调用方继续写入 tile,则结果是不确定的。此方法的调用应该与
getWritableTile(int, int)
的调用成对出现。任何其他用法都会导致不明确的结果。当 tile 从有一个 writer 变为没有 writer 时,通过所有已注册的 TileObservers
。
- 指定者:
- 接口
WritableRenderedImage
中的 releaseWritableTile
- 参数:
tileX
- tile 的 x 索引tileY
- tile 的 y 索引
getTransparency
public int getTransparency()
- 返回透明度。返回 OPAQUE、BITMASK 或 TRANSLUCENT 中的一种。
- 指定者:
- 接口
Transparency
中的 getTransparency
- 返回:
- 此
BufferedImage
的透明度。 - 从以下版本开始:
- 1.5
- 另请参见:
Transparency.OPAQUE
,
Transparency.BITMASK
,
Transparency.TRANSLUCENT
getCapabilities
public ImageCapabilities getCapabilities(GraphicsConfiguration gc)
- 重写 Image.getCapabilities(gc) 以获得其 surfaceManager 的能力。这意味着加速的 BufferedImage 对象可能返回一个指示此加速的 caps 对象。
- 覆盖:
- 类
Image
中的 getCapabilities
- 参数:
gc
- GraphicsConfiguration
对象。此参数值为 null 将导致获取默认 GraphicsConfiguration
的图像功能。
- 返回:
- 包含指定 GraphicsConfiguration 上此
Image
的功能的 ImageCapabilities
对象。 - 另请参见:
VolatileImage.getCapabilities()
概述
软件包
类
使用
树
已过时
索引
帮助
JavaTM 2 Platform
Standard Ed. 5.0
上一个类
下一个类
框架
无框架
所有类
摘要: 嵌套 | 字段 | 构造方法 | 方法
详细信息: 字段 | 构造方法 | 方法
提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java 2 SDK SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。 版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策。