RenderableImage (Java 2 Platform SE 5.0) - JavaTM 2 Platform Standard Edition 5.0 API 规范中文版
|
JavaTM 2 Platform Standard Ed. 5.0 |
|||||||||
| 上一个类 下一个类 | 框架 无框架 | |||||||||
| 摘要： 嵌套 | 字段 | 构造方法 | 方法 | 详细信息： 字段 | 构造方法 | 方法 | |||||||||
java.awt.image.renderable
接口 RenderableImage
- 所有已知实现类：
- RenderableImageOp
public interface RenderableImage
RenderableImage 是与呈现无关的图像（该概念包含与分辨率无关的意思）的公共接口。与呈现无关的图像也就是被描述的、应用与其任何特定呈现无关的操作的那些图像。例如，一个满足以下条件的 RenderableImage：它可以旋转并可以按与分辨率无关的条件进行裁剪。然后，它可以针对各种特定的上下文（如草图预览、高质量屏幕显示或打印机）以最优方式呈现。
RenderedImage 通过 createRendering() 方法从 RenderableImage 返回，该方法采用 RenderContext 作为参数。RenderContext 指定 RenderedImage 的构造方式。注意，不能直接从 RenderableImage 中提取像素。
createDefaultRendering() 和 createScaledRendering() 方法是内部构造适当 RenderContext 的便捷方法。所有呈现方法都可以返回对以前生成的呈现的引用。
| 字段摘要 | |
|---|---|
static String |
HINTS_OBSERVED
可以用于在通过 createRendering 或 createScaledRendering 方法获取的 RenderedImage 上标识属性的字符串常量。 |
| 方法摘要 | |
|---|---|
RenderedImage |
createDefaultRendering()
返回此图像具有默认宽度和高度（以像素为单位）的一个 RenderedImage 实例。 |
RenderedImage |
createRendering(RenderContext renderContext)
使用给定的 RenderContext 创建表示此图像一个呈现的 RenderedImage。 |
RenderedImage |
createScaledRendering(int w,
int h,
RenderingHints hints)
创建此图像具有宽度 w 和高度 h（以像素为单位）的一个 RenderedImage 实例。 |
float |
getHeight()
获取用户坐标空间中的高度。 |
float |
getMinX()
获取与呈现无关的图像数据的最小 X 坐标。 |
float |
getMinY()
获取与呈现无关的图像数据的最小 Y 坐标。 |
Object |
getProperty(String name)
从此图像的属性集中获取某个属性。 |
String[] |
getPropertyNames()
返回由 getProperty 识别的名称列表。 |
Vector<RenderableImage> |
getSources()
返回作为此 RenderableImage 的图像数据源的 RenderableImage 的向量。 |
float |
getWidth()
获取用户坐标空间中的宽度。 |
boolean |
isDynamic()
如果使用相同参数的后续呈现（即调用 createRendering() 或 createScaledRendering()）可以生成不同的结果，则返回 true。 |
| 字段详细信息 |
|---|
HINTS_OBSERVED
static final String HINTS_OBSERVED
- 可以用于在通过 createRendering 或 createScaledRendering 方法获取的 RenderedImage 上标识属性的字符串常量。如果存在此类属性，则该属性的值将是一个 RenderingHints 对象，该对象指定在创建该呈现时要注意的提示。
- 另请参见：
- 常量字段值
| 方法详细信息 |
|---|
getSources
Vector<RenderableImage> getSources()
- 返回作为此 RenderableImage 的图像数据源的 RenderableImage 的向量。注意，此方法可能返回空向量，指示该图像没有源，或者返回 null，指示没有可用信息。
- 返回：
- RenderableImages 的（可能为空的）Vector，或者 null。
getProperty
Object getProperty(String name)
- 从此图像的属性集中获取某个属性。如果该属性名无法识别，将返回 java.awt.Image.UndefinedProperty。
- 参数：
name- 要获取的属性名称（以 String 形式）。- 返回：
- 对属性 Object 的引用，或者值 java.awt.Image.UndefinedProperty。
getPropertyNames
String[] getPropertyNames()
- 返回由 getProperty 识别的名称列表。
- 返回：
- 属性名称列表。
isDynamic
boolean isDynamic()
- 如果使用相同参数的后续呈现（即调用 createRendering() 或 createScaledRendering()）可以生成不同的结果，则返回 true。此方法可用于确定是否可以缓存和重用现有呈现。返回 true 始终安全。
- 返回：
- 如果使用相同参数的后续呈现可以生成不同结果，则返回
true；否则返回false。
getWidth
float getWidth()
- 获取用户坐标空间中的宽度。按照惯例，RenderableImage 的常规宽度等于该图像的高宽比（宽度除以高度）。
- 返回：
- 用户坐标中图像的宽度。
getHeight
float getHeight()
- 获取用户坐标空间中的高度。按照惯例，RenderedImage 的常规宽度等于 1.0F。
- 返回：
- 用户坐标中图像的高度。
getMinX
float getMinX()
- 获取与呈现无关的图像数据的最小 X 坐标。
- 返回：
- 与呈现无关的图像数据的最小 X 坐标。
getMinY
float getMinY()
- 获取与呈现无关的图像数据的最小 Y 坐标。
- 返回：
- 与呈现无关的图像数据的最小 Y 坐标。
createScaledRendering
RenderedImage createScaledRendering(int w, int h, RenderingHints hints)
- 创建此图像具有宽度 w 和高度 h（以像素为单位）的一个 RenderedImage 实例。使用适当的 usr2dev 变换和完整图像的感兴趣区域自动构建 RenderContext。所有呈现提示均来自传入的提示。
如果 w == 0，则该值将等于 Math.round(h*(getWidth()/getHeight()))。类似地，如果 h == 0，则该值将等于 Math.round(w*(getHeight()/getWidth()))。w 和 h 中必须有一个不为零，否则将抛出 IllegalArgumentException。
创建的 RenderedImage 可能有一个由字符串 HINTS_OBSERVED 标识的属性，以指示使用了哪些 RenderingHints 创建该图像。此外，通过创建的 RenderedImage 上的 getSources() 方法获取的任何 RenderedImage 都可能具该属性。
- 参数：
w- 所呈现图像的宽度（以像素为单位），或者为 0。h- 所呈现图像的高度（以像素为单位），或者为 0。hints- 包含提示的 RenderingHints 对象。- 返回：
- 包含所呈现数据的 RenderedImage。
createDefaultRendering
RenderedImage createDefaultRendering()
- 返回此图像具有默认宽度和高度（以像素为单位）的一个 RenderedImage 实例。使用适当的 usr2dev 变换和完整图像的感兴趣区域自动构建 RenderContext。该呈现提示为空。为提高速度，createDefaultRendering 可能会使用已存储的呈现。
- 返回：
- 包含所呈现数据的 RenderedImage。
createRendering
RenderedImage createRendering(RenderContext renderContext)
- 使用给定的 RenderContext 创建表示此图像一个呈现的 RenderedImage。这是获取 RenderableImage 的呈现的最通用的方法。
创建的 RenderedImage 可能有一个由字符串 HINTS_OBSERVED 标识的属性，以指示使用了哪些 RenderingHints（来自 RenderContext）创建该图像。此外，通过创建的 RenderedImage 上的 getSources() 方法获取的任何 RenderedImage 都可能具有该属性。
- 参数：
renderContext- 用于生成呈现的 RenderContext。- 返回：
- 包含所呈现数据的 RenderedImage。
|
JavaTM 2 Platform Standard Ed. 5.0 |
|||||||||
| 上一个类 下一个类 | 框架 无框架 | |||||||||
| 摘要： 嵌套 | 字段 | 构造方法 | 方法 | 详细信息： 字段 | 构造方法 | 方法 | |||||||||
提交错误或意见
有关更多的 API 参考资料和开发人员文档，请参阅 Java 2 SDK SE 开发人员文档。该文档包含更详细的、面向开发人员的描述，以及总体概述、术语定义、使用技巧和工作代码示例。
版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策。