JavaTM 2 Platform
Standard Ed. 5.0

类 java.awt.image.BufferedImage
的使用

使用 BufferedImage 的软件包
java.awt 包含用于创建用户界面和绘制图形图像的所有类。 
java.awt.image 提供创建和修改图像的各种类。 
javax.imageio Java Image I/O API 的主要包。 
javax.imageio.event Java Image I/O API 的一个包,用于在读取和写入图像期间处理事件的同步通知。 
 

java.awtBufferedImage 的使用
 

返回 BufferedImagejava.awt 中的方法
abstract  BufferedImage GraphicsConfiguration.createCompatibleImage(int width, int height)
          返回一个数据布局和颜色模型与此 GraphicsConfiguration 兼容的 BufferedImage
abstract  BufferedImage GraphicsConfiguration.createCompatibleImage(int width, int height, int transparency)
          返回一个支持指定透明度,并且数据布局和颜色模型与此 GraphicsConfiguration 兼容的 BufferedImage
 BufferedImage Robot.createScreenCapture(Rectangle screenRect)
          创建包含从屏幕中读取的像素的图像。
 BufferedImage TexturePaint.getImage()
          返回用于填充形状的 BufferedImage 纹理。
 

参数类型为 BufferedImagejava.awt 中的方法
abstract  Graphics2D GraphicsEnvironment.createGraphics(BufferedImage img)
          返回一个呈现指定 BufferedImageGraphics2D 对象。
abstract  void Graphics2D.drawImage(BufferedImage img, BufferedImageOp op, int x, int y)
          呈现使用 BufferedImageOp 过滤的 BufferedImage 应用的呈现属性包括 ClipTransformComposite 属性。
 

参数类型为 BufferedImagejava.awt 中的构造方法
TexturePaint(BufferedImage txtr, Rectangle2D anchor)
          构造 TexturePaint 对象。
 

java.awt.imageBufferedImage 的使用
 

返回 BufferedImagejava.awt.image 中的方法
 BufferedImage IndexColorModel.convertToIntDiscrete(Raster raster, boolean forceARGB)
          返回一个 TYPE_INT_ARGB 或 TYPE_INT_RGB 的新 BufferedImage,其 Raster 的像素数据是通过使用此 ColorModel 的颜色/alpha 分量数组扩展源 Raster 中的各索引来计算的。
 BufferedImage RescaleOp.createCompatibleDestImage(BufferedImage src, ColorModel destCM)
          创建一个具有正确大小和 band 数的经检查的目标图像。
 BufferedImage LookupOp.createCompatibleDestImage(BufferedImage src, ColorModel destCM)
          创建一幅具有正确大小和 band 数的、经过检查的目标图像。
 BufferedImage ConvolveOp.createCompatibleDestImage(BufferedImage src, ColorModel destCM)
          创建具有正确 band 大小和数量的归零目标图像。
 BufferedImage ColorConvertOp.createCompatibleDestImage(BufferedImage src, ColorModel destCM)
          创建给定源的具有正确大小和 band 数量的归零目标图像。
 BufferedImage BufferedImageOp.createCompatibleDestImage(BufferedImage src, ColorModel destCM)
          创建一个具有正确大小和 band 数的经过检查的目标图像。
 BufferedImage AffineTransformOp.createCompatibleDestImage(BufferedImage src, ColorModel destCM)
          创建一个具有正确大小和 band 数的经过检查的目标图像。
 BufferedImage RescaleOp.filter(BufferedImage src, BufferedImage dst)
          对源 BufferedImage 进行重缩放。
 BufferedImage LookupOp.filter(BufferedImage src, BufferedImage dst)
          对 BufferedImage 执行查找操作。
 BufferedImage ConvolveOp.filter(BufferedImage src, BufferedImage dst)
          对 BufferedImage 执行卷积运算。
 BufferedImage ColorConvertOp.filter(BufferedImage src, BufferedImage dest)
          对源 BufferedImage 进行颜色转换。
 BufferedImage BufferedImageOp.filter(BufferedImage src, BufferedImage dest)
          对 BufferedImage 执行单输入/单输出操作。
 BufferedImage AffineTransformOp.filter(BufferedImage src, BufferedImage dst)
          转换源 BufferedImage 并将结果存储在目标 BufferedImage 中。
abstract  BufferedImage VolatileImage.getSnapshot()
          返回此对象的静态快照图像。
 BufferedImage BufferedImage.getSubimage(int x, int y, int w, int h)
          返回由指定矩形区域定义的子图像。
 

参数类型为 BufferedImagejava.awt.image 中的方法
 BufferedImage RescaleOp.createCompatibleDestImage(BufferedImage src, ColorModel destCM)
          创建一个具有正确大小和 band 数的经检查的目标图像。
 BufferedImage LookupOp.createCompatibleDestImage(BufferedImage src, ColorModel destCM)
          创建一幅具有正确大小和 band 数的、经过检查的目标图像。
 BufferedImage ConvolveOp.createCompatibleDestImage(BufferedImage src, ColorModel destCM)
          创建具有正确 band 大小和数量的归零目标图像。
 BufferedImage ColorConvertOp.createCompatibleDestImage(BufferedImage src, ColorModel destCM)
          创建给定源的具有正确大小和 band 数量的归零目标图像。
 BufferedImage BufferedImageOp.createCompatibleDestImage(BufferedImage src, ColorModel destCM)
          创建一个具有正确大小和 band 数的经过检查的目标图像。
 BufferedImage AffineTransformOp.createCompatibleDestImage(BufferedImage src, ColorModel destCM)
          创建一个具有正确大小和 band 数的经过检查的目标图像。
 BufferedImage RescaleOp.filter(BufferedImage src, BufferedImage dst)
          对源 BufferedImage 进行重缩放。
 BufferedImage LookupOp.filter(BufferedImage src, BufferedImage dst)
          对 BufferedImage 执行查找操作。
 BufferedImage ConvolveOp.filter(BufferedImage src, BufferedImage dst)
          对 BufferedImage 执行卷积运算。
 BufferedImage ColorConvertOp.filter(BufferedImage src, BufferedImage dest)
          对源 BufferedImage 进行颜色转换。
 BufferedImage BufferedImageOp.filter(BufferedImage src, BufferedImage dest)
          对 BufferedImage 执行单输入/单输出操作。
 BufferedImage AffineTransformOp.filter(BufferedImage src, BufferedImage dst)
          转换源 BufferedImage 并将结果存储在目标 BufferedImage 中。
 Rectangle2D RescaleOp.getBounds2D(BufferedImage src)
          返回重缩放后的目标图像的边界框。
 Rectangle2D LookupOp.getBounds2D(BufferedImage src)
          返回过滤后的目标图像的边界框。
 Rectangle2D ConvolveOp.getBounds2D(BufferedImage src)
          返回已过滤目标图像的边界框。
 Rectangle2D ColorConvertOp.getBounds2D(BufferedImage src)
          返回给定源的目标边界框。
 Rectangle2D BufferedImageOp.getBounds2D(BufferedImage src)
          返回已过滤目标图像的边界框。
 Rectangle2D AffineTransformOp.getBounds2D(BufferedImage src)
          返回转换后的目标图像的边界框。
 

javax.imageioBufferedImage 的使用
 

声明为 BufferedImagejavax.imageio 中的字段
protected  BufferedImage ImageReadParam.destination
          当前目标 BufferedImage;如果没有设置目标图像,则为 null
 

类型参数类型为 BufferedImagejavax.imageio 中的字段
protected  List<? extends BufferedImage> IIOImage.thumbnails
          BufferedImage 缩略图的 List,或为 null
 

返回 BufferedImagejavax.imageio 中的方法
 BufferedImage ImageTypeSpecifier.createBufferedImage(int width, int height)
          根据此对象中包含的规范创建一个具有给定宽度和高度的 BufferedImage
 BufferedImage ImageReadParam.getDestination()
          返回当前由 setDestination 方法设置的 BufferedImage,如果没有设置,则返回 null
protected static BufferedImage ImageReader.getDestination(ImageReadParam param, Iterator<ImageTypeSpecifier> imageTypes, int width, int height)
          返回应该在其中写入解码的像素数据的 BufferedImage
 BufferedImage IIOImage.getThumbnail(int index)
          返回与主图像关联的缩略图。
static BufferedImage ImageIO.read(File input)
          返回一个 BufferedImage,作为使用从当前已注册 ImageReader 中自动选择的 ImageReader 解码所提供 File 的结果。
static BufferedImage ImageIO.read(ImageInputStream stream)
          返回一个 BufferedImage,作为使用从当前已注册 ImageReader 中自动选择的 ImageReader 解码所提供 ImageInputStream 的结果。
static BufferedImage ImageIO.read(InputStream input)
          返回一个 BufferedImage,作为使用从当前已注册 ImageReader 中自动选择的 ImageReader 解码所提供 InputStream 的结果。
 BufferedImage ImageReader.read(int imageIndex)
          使用默认 ImageReadParam 读取通过索引 imageIndex 指定的图像,并将其作为一个完整的 BufferedImage 返回。
abstract  BufferedImage ImageReader.read(int imageIndex, ImageReadParam param)
          使用所提供的 ImageReadParam 读取通过索引 imageIndex 指定的对象,并将它作为一个完整的 BufferedImage 返回。
static BufferedImage ImageIO.read(URL input)
          返回一个 BufferedImage,作为使用从当前已注册 ImageReader 中自动选择的 ImageReader 解码所提供 URL 的结果。
 BufferedImage ImageReader.readThumbnail(int imageIndex, int thumbnailIndex)
          以 BufferedImage 形式返回通过索引 thumbnailIndex 指定的缩略图预览图像,其与通过索引 ImageIndex 指定的图像关联。
 BufferedImage ImageReader.readTile(int imageIndex, int tileX, int tileY)
          读取由 tileXtileY 参数指示的 tile,并以 BufferedImage 形式返回。
 

返回变量类型为 BufferedImage 的类型的 javax.imageio 中的方法
 List<? extends BufferedImage> IIOImage.getThumbnails()
          返回缩略图 BufferedImage 的当前 List,如果没有设置任何缩略图,则返回 null
 

参数类型为 BufferedImagejavax.imageio 中的方法
protected static void ImageReader.computeRegions(ImageReadParam param, int srcWidth, int srcHeight, BufferedImage image, Rectangle srcRegion, Rectangle destRegion)
          计算感兴趣的源区域和目标区域,将源图像的宽度和高度、可选目标图像和可选 ImageReadParam 都考虑在内。
protected  void ImageReader.processImageUpdate(BufferedImage theImage, int minX, int minY, int width, int height, int periodX, int periodY, int[] bands)
          通过调用所有已注册 IIOReadUpdateListenerimageUpdate 方法向其广播样本集合的更新。
protected  void ImageReader.processPassComplete(BufferedImage theImage)
          通过调用所有已注册 IIOReadUpdateListenerpassComplete 方法向其广播逐步传递的结束。
protected  void ImageReader.processPassStarted(BufferedImage theImage, int pass, int minPass, int maxPass, int minX, int minY, int periodX, int periodY, int[] bands)
          通过调用所有已注册 IIOReadUpdateListenerpassStarted 方法向其广播逐步传递的开始。
protected  void ImageReader.processThumbnailPassComplete(BufferedImage theThumbnail)
          通过调用所有已注册 IIOReadUpdateListenerthumbnailPassComplete 方法向其广播缩略图逐步传递的结束。
protected  void ImageReader.processThumbnailPassStarted(BufferedImage theThumbnail, int pass, int minPass, int maxPass, int minX, int minY, int periodX, int periodY, int[] bands)
          通过调用所有已注册 IIOReadUpdateListenerthumbnailPassStarted 方法向其广播缩略图逐步传递的开始。
protected  void ImageReader.processThumbnailUpdate(BufferedImage theThumbnail, int minX, int minY, int width, int height, int periodX, int periodY, int[] bands)
          通过调用所有已注册 IIOReadUpdateListenerthumbnailUpdate 方法向其广播缩略图图像中样本集合的更新。
 void ImageReadParam.setDestination(BufferedImage destination)
          提供一个 BufferedImage,将其用作解码像素数据的目标。
 

类型变量类型为 BufferedImagejavax.imageio 中的方法参数
 void ImageWriter.prepareInsertEmpty(int imageIndex, ImageTypeSpecifier imageType, int width, int height, IIOMetadata imageMetadata, List<? extends BufferedImage> thumbnails, ImageWriteParam param)
          从将带有不确定像素值的新图像插入现有图像流中开始。
 void ImageWriter.prepareWriteEmpty(IIOMetadata streamMetadata, ImageTypeSpecifier imageType, int width, int height, IIOMetadata imageMetadata, List<? extends BufferedImage> thumbnails, ImageWriteParam param)
          从写入完整图像流开始,该图像流由带有要输出的不确定像素值、有关元数据和缩略图的单个图像组成。
 void IIOImage.setThumbnails(List<? extends BufferedImage> thumbnails)
          将缩略图列表设置为 BufferedImage 的一个新 Listnull
 

类型变量类型为 BufferedImagejavax.imageio 中的构造方法参数
IIOImage(Raster raster, List<? extends BufferedImage> thumbnails, IIOMetadata metadata)
          构造一个 IIOImage,它包含 Raster 以及与之关联的缩略图和元数据。
IIOImage(RenderedImage image, List<? extends BufferedImage> thumbnails, IIOMetadata metadata)
          构造一个 IIOImage,它包含 RenderedImage 以及与之关联的缩略图和元数据。
 

javax.imageio.eventBufferedImage 的使用
 

参数类型为 BufferedImagejavax.imageio.event 中的方法
 void IIOReadUpdateListener.imageUpdate(ImageReader source, BufferedImage theImage, int minX, int minY, int width, int height, int periodX, int periodY, int[] bands)
          报告已更新图像的给定区域。
 void IIOReadUpdateListener.passComplete(ImageReader source, BufferedImage theImage)
          报告当前读操作已经完成一个逐步传递。
 void IIOReadUpdateListener.passStarted(ImageReader source, BufferedImage theImage, int pass, int minPass, int maxPass, int minX, int minY, int periodX, int periodY, int[] bands)
          报告当前的读操作将开始逐步传递 (progressive pass)。
 void IIOReadUpdateListener.thumbnailPassComplete(ImageReader source, BufferedImage theThumbnail)
          报告当前缩略图读操作已经完成一个逐步传递。
 void IIOReadUpdateListener.thumbnailPassStarted(ImageReader source, BufferedImage theThumbnail, int pass, int minPass, int maxPass, int minX, int minY, int periodX, int periodY, int[] bands)
          报告当前的缩略图读操作将开始逐步传递。
 void IIOReadUpdateListener.thumbnailUpdate(ImageReader source, BufferedImage theThumbnail, int minX, int minY, int width, int height, int periodX, int periodY, int[] bands)
          报告已更新缩略图图像的给定区域。
 


JavaTM 2 Platform
Standard Ed. 5.0

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java 2 SDK SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策