Image (Java Platform SE 8 )

java.lang.Object
- java.awt.Image

已知直接子类：

BufferedImage， VolatileImage
```
public abstract class Image
extends Object
```
抽象类 Image是所有类的父类的图形图像表示。必须以特定于平台的方式获得图像。

从以下版本开始：

JDK1.0

Field Summary

Fields
Modifier and Type	Field and Description
`protected float`	`accelerationPriority` 优先用于加速这个图像。
`static int`	`SCALE_AREA_AVERAGING` 使用面积平均图像缩放算法。
`static int`	`SCALE_DEFAULT` 使用默认图像缩放算法。
`static int`	`SCALE_FAST` 选择一个图像缩放算法，给出了更高的优先级缩放速度比缩放图像的平滑。
`static int`	`SCALE_REPLICATE` 使用图像缩放算法体现在 `ReplicateScaleFilter`类。
`static int`	`SCALE_SMOOTH` 选择一种比缩放速度更高的图像平滑度的图像缩放算法。
`static Object`	`UndefinedProperty` 的 `UndefinedProperty`对象应返回时的属性不是一个特定的形象定义是牵强的。

构造方法摘要

构造方法

Constructor and Description

Image()

构造方法
Constructor and Description
`Image()`

方法摘要

所有方法接口方法抽象方法具体的方法
Modifier and Type	Method and Description
`void`	`flush()` 把所有的可重构资源被这个图像对象使用。
`float`	`getAccelerationPriority()` 返回加速优先级提示的当前值。
`ImageCapabilities`	`getCapabilities(GraphicsConfiguration gc)` 返回一个imagecapabilities对象可以查询到该图像的能力在指定的graphicsconfiguration。
`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)` 为这个图像设置一个提示，关于加速是多么重要的一个。

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - accelerationPriority
```
protected float accelerationPriority
```
    优先用于加速这个图像。派生类可以设置不同的默认优先级和应用程序可以自由设置优先级，通过 setAccelerationPriority(float)特定图像的方法。
    
    从以下版本开始：
    
    一点五
  - UndefinedProperty
```
public static final Object UndefinedProperty
```
    的 UndefinedProperty对象应返回时的属性不是一个特定的形象定义是牵强的。
  - SCALE_DEFAULT
```
public static final int SCALE_DEFAULT
```
    使用默认图像缩放算法。
    
    从以下版本开始：
    
    JDK1.1
    
    另请参见：
    
    Constant Field Values
  - SCALE_FAST
```
public static final int SCALE_FAST
```
    选择一个图像缩放算法，给出了更高的优先级缩放速度比缩放图像的平滑。
    
    从以下版本开始：
    
    JDK1.1
    
    另请参见：
    
    Constant Field Values
  - SCALE_SMOOTH
```
public static final int SCALE_SMOOTH
```
    选择一种比缩放速度更高的图像平滑度的图像缩放算法。
    
    从以下版本开始：
    
    JDK1.1
    
    另请参见：
    
    Constant Field Values
  - SCALE_REPLICATE
```
public static final int SCALE_REPLICATE
```
    使用图像缩放算法体现在 ReplicateScaleFilter类。的 Image对象免费替换一个不同的过滤器，执行相同的算法还集成了更有效的工具提供的成像基础。
    
    从以下版本开始：
    
    JDK1.1
    
    另请参见：
    
    ReplicateScaleFilter， Constant Field Values
  - SCALE_AREA_AVERAGING
```
public static final int SCALE_AREA_AVERAGING
```
    使用面积平均图像缩放算法。图像对象是免费的，以取代一个不同的过滤器，执行相同的算法，但更有效地集成到所提供的图像基础设施的工具包。
    
    从以下版本开始：
    
    JDK1.1
    
    另请参见：
    
    AreaAveragingScaleFilter， Constant Field Values
- Constructor Detail
  - 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 -如果属性名是空的。
    
    另请参见：
    
    ImageObserver， UndefinedProperty
  - getScaledInstance
```
public Image getScaledInstance(int width,
                               int height,
                               int hints)
```
    创建此图像的缩放版本。一个新的 Image对象还将在指定的 width和 height默认渲染图像。新 Image对象可以是异步即使原始图像已经加载完全加载。
    如果width或height是负数则值替换保持原始图像的尺寸长宽比。如果width和height是负面的，那么使用原始图像的尺寸。
    
    参数
    
    width的宽度来缩放图像。
    
    height的高度来缩放图像。
    
    hints -标志来表明使用图像重采样算法的类型。
    
    结果
    
    缩放版本的图像。
    
    异常
    
    IllegalArgumentException -如果 width或 height是零。
    
    从以下版本开始：
    
    JDK1.1
    
    另请参见：
    
    SCALE_DEFAULT， SCALE_FAST， SCALE_SMOOTH， SCALE_REPLICATE， SCALE_AREA_AVERAGING
  - flush
```
public void flush()
```
    把所有的可重构资源被这个图像对象使用。这包括任何像素数据被缓存渲染到屏幕以及被他们是否可以重新创建用于存储数据或像素的图像的任何系统资源。图像复位状态相似，当它第一次产生了，如果它再次渲染，图像数据将被重建或再从源头来。
    该方法如何影响特定类型的图像对象的例子：
    - BufferedImage对象离开原栅格存储像素不变，但冲洗任何信息缓存那些像素如上传到显示硬件加速BLITS副本。
    - 图像对象创建的组件的方法，把宽度和高度把像素不变主缓冲区，但所有缓存信息的发布更像是BufferedImage对象完成。
    - volatileimage对象释放他们所有的像素资源包括初级副本，通常存储在显示硬件资源是稀缺的。这些对象可以使用他们的validate方法恢复。
    - 图像对象的工具，这是从文件加载组件类创建的URL或由ImageProducer产生卸所有本地资源发布。这些对象可以被重新从原始源需要在渲染时，当他们首先创造了。
  - getCapabilities
```
public ImageCapabilities getCapabilities(GraphicsConfiguration gc)
```
    返回一个imagecapabilities对象可以查询到该图像的能力在指定的graphicsconfiguration。这允许程序员在他们创建的特定图像对象上找到更多的运行时信息。例如，用户可以创建一个BufferedImage但系统可能没有视频内存去创造，在给定的graphicsconfiguration大小的图像，所以虽然对象可能可加速一般，它不在这graphicsconfiguration有能力。
    
    参数
    
    gc - GraphicsConfiguration对象。此参数的值无效将导致违约 GraphicsConfiguration获取图像的能力。
    
    结果
    
    一个 ImageCapabilities对象包含此 Image能力在指定的graphicsconfiguration。
    
    从以下版本开始：
    
    一点五
    
    另请参见：
    
    VolatileImage.getCapabilities()
  - setAccelerationPriority
```
public void setAccelerationPriority(float priority)
```
    为这个图像设置一个提示，关于加速是多么重要的一个。此优先级提示用于在确定如何使用视频内存之类的稀缺加速资源时，与其他图像对象的优先级进行比较时。如果有可能加速这一形象，如果没有足够的可用资源，提供加速但足够可以释放de加快低优先级的其它一些图像，然后其他的图像可能是加速在尊重这一。具有相同优先级的图像在第一个先到先得的基础上占用资源。
    
    参数
    
    priority - 0和1之间的值，值越高，表明加速度更重要。值为0意味着这个图像不应该被加速。其他的值是用来简单地确定相对于其他图像的加速优先级。
    
    异常
    
    IllegalArgumentException -如果 priority小于零或大于1。
    
    从以下版本开始：
    
    一点五
  - getAccelerationPriority
```
public float getAccelerationPriority()
```
    返回加速优先级提示的当前值。
    
    结果
    
    值在0和1之间，包含表示当前优先级值的值
    
    从以下版本开始：
    
    一点五
    
    另请参见：
    
    setAccelerationPriority

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 Image

Field Summary

构造方法摘要

方法摘要

Methods inherited from class java.lang.Object

Field Detail

accelerationPriority

UndefinedProperty

SCALE_DEFAULT

SCALE_FAST

SCALE_SMOOTH

SCALE_REPLICATE

SCALE_AREA_AVERAGING

Constructor Detail

Image

方法详细信息

getWidth

getHeight

getSource

getGraphics

getProperty

getScaledInstance

flush

getCapabilities

setAccelerationPriority

getAccelerationPriority