-
- 所有已知实现类:
-
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)
创建一个RenderedImage,它使用给定的RenderContext表示此图像的渲染。RenderedImage
createScaledRendering(int w, int h, RenderingHints hints)
创建此图像的RenderedImage实例,宽度为w,高度为h(以像素为单位)。float
getHeight()
获取用户坐标空间中的高度。float
getMinX()
获取与渲染无关的图像数据的最小X坐标。float
getMinY()
获取与渲染无关的图像数据的最小Y坐标。Object
getProperty(String name)
从此图像的属性集中获取属性。String[]
getPropertyNames()
返回getProperty识别的名称列表。Vector<RenderableImage>
getSources()
返回RenderableImages的矢量,RenderableImages是此RenderableImage的图像数据源。float
getWidth()
获取用户坐标空间中的宽度。boolean
isDynamic()
如果使用相同参数的连续渲染(即,调用createRendering()或createScaledRendering())可能产生不同的结果,则返回true。
-
-
-
方法详细信息
-
getSources
Vector<RenderableImage> getSources()
返回RenderableImages的矢量,RenderableImages是此RenderableImage的图像数据源。 请注意,此方法可能返回空向量,以指示图像没有源或null,以指示没有可用信息。- 结果
- 一个(可能是空的)RenderableImages矢量,或者为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)
创建此图像的RenderedImage实例,宽度为w,高度为h(以像素为单位)。 RenderContext是使用适当的usr2dev变换和完整图像的感兴趣区域自动构建的。 所有渲染提示都来自传递的提示。如果w == 0,它将被视为等于Math.round(h *(getWidth()/ getHeight()))。 类似地,如果h == 0,它将被视为等于Math.round(w *(getHeight()/ getWidth()))。 w或h中的一个必须为非零,否则将抛出IllegalArgumentException。
创建的RenderedImage可能具有由String HINTS_OBSERVED标识的属性,以指示用于创建图像的RenderingHints。 此外,通过创建的RenderedImage上的getSources()方法获得的任何RenderedImages可能具有此类属性。
- 参数
-
w
- 渲染图像的宽度(以像素为单位)或0。 -
h
- 渲染图像的高度(以像素为单位)或0。 -
hints
- 包含提示的RenderingHints对象。 - 结果
- 包含渲染数据的RenderedImage。
-
createDefaultRendering
RenderedImage createDefaultRendering()
返回此图像的RenderedImage实例,其默认宽度和高度(以像素为单位)。 RenderContext是使用适当的usr2dev变换和完整图像的感兴趣区域自动构建的。 渲染提示为空。 createDefaultRendering可以使用存储的渲染来提高速度。- 结果
- 包含渲染数据的RenderedImage。
-
createRendering
RenderedImage createRendering(RenderContext renderContext)
创建一个RenderedImage,它使用给定的RenderContext表示此图像的渲染。 这是获取RenderableImage渲染的最常用方法。创建的RenderedImage可能具有由String HINTS_OBSERVED标识的属性,以指示使用哪些RenderingHints(来自RenderContext)来创建图像。 此外,通过创建的RenderedImage上的getSources()方法获得的任何RenderedImages可能具有此类属性。
- 参数
-
renderContext
- 用于生成渲染的RenderContext。 - 结果
- a RenderedImage containing the rendered data.
-
-