JavaTM 2 Platform
Standard Ed. 5.0

java.awt
类 Image

java.lang.Object
  继承者 java.awt.Image
直接已知子类:
BufferedImage, VolatileImage

public abstract class Image
extends Object

抽象类 Image 是表示图形图像的所有类的超类。必须以特定于平台的方式获取图像。

从以下版本开始:
JDK1.0

字段摘要
protected  float accelerationPriority
          加速此图像的优先级。
static int SCALE_AREA_AVERAGING
          使用 Area Averaging 图像缩放算法。
static int SCALE_DEFAULT
          使用默认的图像缩放算法。
static int SCALE_FAST
          选择一种图像缩放算法,在这种缩放算法中,缩放速度比缩放平滑度具有更高的优先级。
static int SCALE_REPLICATE
          使用 ReplicateScaleFilter 类中包含的图像缩放算法。
static int SCALE_SMOOTH
          选择图像平滑度比缩放速度具有更高优先级的图像缩放算法。
static Object UndefinedProperty
          每当获得某个不是为特定图象定义的属性时,应返回 UndefinedProperty 对象。
 
构造方法摘要
Image()
           
 
方法摘要
abstract  void flush()
          刷新此 Image 对象正在使用的所有资源。
 float getAccelerationPriority()
          返回加速优先级提示的当前值。
 ImageCapabilities getCapabilities(GraphicsConfiguration gc)
          返回 ImageCapabilities 对象,查询该对象即可了解指定 GraphicsConfiguration 上此 Image 的功能。
abstract  Graphics getGraphics()
          创建供绘制闭屏图像使用的图形上下文。
abstract  int getHeight(ImageObserver observer)
          确定图像的高度。
abstract  Object getProperty(String name, ImageObserver observer)
          通过名称获取此图像的属性。
 Image getScaledInstance(int width, int height, int hints)
          创建此图像的缩放版本。
abstract  ImageProducer getSource()
          获取生成图像像素的对象。
abstract  int getWidth(ImageObserver observer)
          确定图像的宽度。
 void setAccelerationPriority(float priority)
          就加速的重要性设置此图像的提示。
 
从类 java.lang.Object 继承的方法
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

字段详细信息

accelerationPriority

protected float accelerationPriority
加速此图像的优先级。通过 setAccelerationPriority(float) 方法,子类可以随意设置不同的默认优先级,而应用程序可以随意设置特定图像的优先级。

从以下版本开始:
1.5

UndefinedProperty

public static final Object UndefinedProperty
每当获得某个不是为特定图象定义的属性时,应返回 UndefinedProperty 对象。


SCALE_DEFAULT

public static final int SCALE_DEFAULT
使用默认的图像缩放算法。

从以下版本开始:
JDK1.1
另请参见:
常量字段值

SCALE_FAST

public static final int SCALE_FAST
选择一种图像缩放算法,在这种缩放算法中,缩放速度比缩放平滑度具有更高的优先级。

从以下版本开始:
JDK1.1
另请参见:
常量字段值

SCALE_SMOOTH

public static final int SCALE_SMOOTH
选择图像平滑度比缩放速度具有更高优先级的图像缩放算法。

从以下版本开始:
JDK1.1
另请参见:
常量字段值

SCALE_REPLICATE

public static final int SCALE_REPLICATE
使用 ReplicateScaleFilter 类中包含的图像缩放算法。Image 对象可以随意替代不同的过滤器,以执行相同的算法,但它能更高效地集成工具包所提供的图像处理基础设施。

从以下版本开始:
JDK1.1
另请参见:
ReplicateScaleFilter, 常量字段值

SCALE_AREA_AVERAGING

public static final int SCALE_AREA_AVERAGING
使用 Area Averaging 图像缩放算法。图像对象可以随意替代不同的过滤器,以执行相同的算法,但它能更高效地集成工具包所提供的图像基础设施。

从以下版本开始:
JDK1.1
另请参见:
AreaAveragingScaleFilter, 常量字段值
构造方法详细信息

Image

public Image()
方法详细信息

getWidth

public abstract int getWidth(ImageObserver observer)
确定图像的宽度。如果宽度未知,则此方法返回 -1,然后通知指定的 ImageObserver 对象。

参数:
observer - 等待加载图像的对象。
返回:
此图像的宽度,如果宽度未知则返回 -1
另请参见:
getHeight(java.awt.image.ImageObserver), ImageObserver

getHeight

public abstract int getHeight(ImageObserver observer)
确定图像的高度。如果高度未知,则此方法返回 -1,然后通知指定的 ImageObserver 对象。

参数:
observer - 等待加载图像的对象。
返回:
此图像的高度,如果高度未知则返回 -1
另请参见:
getWidth(java.awt.image.ImageObserver), ImageObserver

getSource

public abstract ImageProducer getSource()
获取生成图像像素的对象。此方法由图像过滤类和执行图像转换及缩放的方法调用。

返回:
为此图像生成像素的图像生产者。
另请参见:
ImageProducer

getGraphics

public abstract Graphics getGraphics()
创建供绘制闭屏图像使用的图形上下文。此方法仅供闭屏图象调用。

返回:
绘制闭屏图像的图形上下文。
抛出:
UnsupportedOperationException - 如果为非闭屏图像所调用。
另请参见:
Graphics, Component.createImage(int, int)

getProperty

public abstract Object getProperty(String name,
                                   ImageObserver observer)
通过名称获取此图像的属性。

各种图像格式都定义有自己的私人属性名。如果某属性不是为特定图像定义的,则此方法返回 UndefinedProperty 对象。

如果此图像的属性目前未知,则此方法返回 null,然后通知 ImageObserver 对象。

属性名 "comment" 应该用于存储可选注释,在应用程序中它显示为图像的描述、来源或作者。

参数:
name - 属性名。
observer - 等待加载此图像的对象。
返回:
指定属性的值。
抛出:
NullPointerException - 如果属性名为 null。
另请参见:
ImageObserver, UndefinedProperty

getScaledInstance

public Image getScaledInstance(int width,
                               int height,
                               int hints)
创建此图像的缩放版本。返回一个新的 Image 对象,默认情况下,该对象按指定的 widthheight 呈现图像。即使已经完全加载了初始源图像,新的 Image 对象也可以被异步加载。

如果 widthheight 为负数,则替换该值以维持初始图像尺寸的高宽比。如果 widthheight 都为负,则使用初始图像尺寸。

参数:
width - 将图像缩放到的宽度。
height - 将图像缩放到的高度。
hints - 指示用于图像重新取样的算法类型的标志。
返回:
图像的缩放版本。
抛出:
IllegalArgumentException - 如果 widthheight 为零。
从以下版本开始:
JDK1.1
另请参见:
SCALE_DEFAULT, SCALE_FAST, SCALE_SMOOTH, SCALE_REPLICATE, SCALE_AREA_AVERAGING

flush

public abstract void flush()
刷新此 Image 对象正在使用的所有资源。这包括为呈现到屏幕而缓存的所有像素数据和用来存储图像数据或像素的所有系统资源。图像被重置为与初始创建时类似的状态,因此如果再次呈现,则必须重新创建图像数据或再次从源获取。

此方法始终将图像保持为可以重构的状态。这意味着此方法仅应用于图像的缓存或其他二级的表示形式,如从 ImageProducer生成的那些(例如,从文件读取)。对于仅有一个数据副本的闭屏图像,它不执行任何操作。


getCapabilities

public ImageCapabilities getCapabilities(GraphicsConfiguration gc)
返回 ImageCapabilities 对象,查询该对象即可了解指定 GraphicsConfiguration 上此 Image 的功能。这允许程序员查找关于他们已经创建的特定 Image 对象的更多运行时信息。例如,用户可能创建一个 BufferedImage,但是系统所剩显存可能不足以在给定 GraphicsConfiguration 上创建该大小的图像,因此尽管该对象一般而言是可加速的,但在此 GraphicsConfiguration 上它确实不具有该功能。

参数:
gc - GraphicsConfiguration 对象。此参数值为 null 将导致获取默认 GraphicsConfiguration 的图像功能。
返回:
包含指定 GraphicsConfiguration 上此 Image 的功能的 ImageCapabilities 对象。
从以下版本开始:
1.5
另请参见:
VolatileImage.getCapabilities()

setAccelerationPriority

public void setAccelerationPriority(float priority)
就加速的重要性设置此图像的提示。此优先级提示用于在确定如何使用稀缺的加速资源(如显存)时与其他 Image 对象的优先级进行比较。如果可能加速此 Image,但在加速时进行该加速的可用资源不足,若可以通过取消加速具有较低优先级的其他图像来释放足够资源,则其他那些 Image 可能为了这一目的而被取消加速。具有相同优先级的图像利用资源的方式是先到先得。

参数:
priority - 介于 0 和 1 之间的值(包括 0 和 1),较大的值指示加速的重要性较高。值 0 意味着永远不应该加速此 Image。其他值用于确定相对于其他 Image 的加速优先级。
抛出:
IllegalArgumentException - 如果 priority 小于零或大于 1。
从以下版本开始:
1.5

getAccelerationPriority

public float getAccelerationPriority()
返回加速优先级提示的当前值。

返回:
介于 0 和 1 之间的值(包括 0 和 1),表示当前优先级值
从以下版本开始:
1.5
另请参见:
setAccelerationPriority

JavaTM 2 Platform
Standard Ed. 5.0

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

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