java.awt.image.renderable

Interface RenderableImage

所有已知实现类：

RenderableImageOp

public interface RenderableImage

一个renderableimage渲染是独立影像的通用接口（一个概念它包含分辨率无关）。也就是说，被描述的图像，并有操作施加到它们独立于任何特定的渲染的图像。例如，一个renderableimage可以旋转和裁剪，分辨率独立条款。然后，它可以被渲染为各种特定的情况下，如草稿预览，高品质的屏幕显示，或打印机，每一个在一个最佳的方式。

一个renderedimage返回从一个renderableimage通过createrendering()方法，以rendercontext。的rendercontext指定如何renderedimage应构建。请注意，这是不可能直接从renderableimage提取像素。

的createdefaultrendering()和createscaledrendering()方法是方便的方法，构建一个适当的rendercontext内部。所有的渲染方法可以返回一个参考先前产生的渲染。

Field Summary

Fields

Modifier and Type	Field and Description
static String	HINTS_OBSERVED 字符串常量，可以用来识别一个renderedimage通过createrendering或createscaledrendering方法获得的财产。

方法摘要

Modifier and Type	Method and Description
RenderedImage	createDefaultRendering() 到达一个renderedimage这个图像实例的默认宽度和高度，以像素为单位。
RenderedImage	createRendering(RenderContext renderContext) 创建一个renderedimage表示绘制这个图像使用一个给定的rendercontext。
RenderedImage	createScaledRendering(int w, int h, RenderingHints hints) 创建一个与该图像的宽度W renderedimage实例，并在像素高度H。
float	getHeight() 获取用户坐标空间中的高度。
float	getMinX() 获取渲染独立图像数据的最小x坐标。
float	getMinY() 获取渲染独立图像数据的最小坐标。
Object	getProperty(String name) 从该图像的属性集获取一个属性。
String[]	getPropertyNames() 返回一个列表的名称被getProperty。
Vector<RenderableImage>	getSources() 返回一个renderableimages，对此renderableimage图像数据的源向量。
float	getWidth() 获取用户坐标空间中的宽度。
boolean	isDynamic() 如果连续的效果图返回true（即调用createrendering()或createscaledrendering()）使用相同的参数可能会产生不同的结果。

Field Detail

HINTS_OBSERVED

static final String HINTS_OBSERVED

字符串常量，可以用来识别一个renderedimage通过createrendering或createscaledrendering方法获得的财产。如果这样的属性存在，该属性的值将是一个renderinghints对象指定的提示是在创建渲染观察。

另请参见：

Constant Field Values

方法详细信息

getSources

Vector<RenderableImage> getSources()

返回一个renderableimages，对此renderableimage图像数据的源向量。请注意，此方法可以返回一个空的向量，以指示该图像没有任何来源，或为空，以指示没有可用的信息。

结果

一个（可能为空）renderableimages向量，或空。

getProperty

Object getProperty(String name)

从该图像的属性集获取一个属性。如果属性名是不认可的，java.awt.image.undefinedproperty将返回。

参数

name -属性得到的名称，作为字符串。

结果

引用对象的属性值，或java.awt.image.undefinedproperty。

getPropertyNames

String[] getPropertyNames()

返回一个列表的名称被getProperty。

结果

属性名称列表。

isDynamic

boolean isDynamic()

如果连续的效果图返回true（即调用createrendering()或createscaledrendering()）使用相同的参数可能会产生不同的结果。此方法可用于确定是否将现有的渲染缓存和重用。它总是安全返回真实。

结果

true如果连续的效果图具有相同的参数可能会产生不同的结果； false否则。

getWidth

float getWidth()

获取用户坐标空间中的宽度。按照惯例，一个renderableimage通常的宽度等于图像的纵横比（宽度除以身高）。

结果

用户坐标中图像的宽度。

getHeight

float getHeight()

获取用户坐标空间中的高度。按照惯例，一个renderedimage通常高度等于1.0f。

结果

用户坐标中图像的高度。

getMinX

float getMinX()

获取渲染独立图像数据的最小x坐标。

结果

绘制独立图像数据的最小x坐标。

getMinY

float getMinY()

获取渲染独立图像数据的最小坐标。

结果

绘制独立图像数据的最小坐标。

createScaledRendering

RenderedImage createScaledRendering(int w,
                                    int h,
                                    RenderingHints hints)

创建一个与该图像的宽度W renderedimage实例，并在像素高度H。的rendercontext自动建立与适当的usr2dev变换和图像感兴趣区域的全。所有的渲染提示都来自于传递的提示。

如果W = = 0，它将采取同样的数学。圆（H *（getwidth() / getheight()））。同样，如果H = = 0，它将采取同样的数学。圆（W *（getheight() / getwidth()））。一个W或H必须是非零的否则将抛出一个时。

创建renderedimage可能有属性的字符串hints_observed表示renderinghints用于创建图像识别。除此之外的任何renderedimages，通过创建renderedimage的getsources()方法得到的可能会有这样一种特性。

参数

w -渲染图像中像素的宽度，或0。

h -渲染图像中像素的高度，或0。

hints - renderinghints对象包含的暗示。

结果

一个renderedimage含呈现的数据。

createDefaultRendering

RenderedImage createDefaultRendering()

到达一个renderedimage这个图像实例的默认宽度和高度，以像素为单位。的rendercontext自动建立与适当的usr2dev变换和图像感兴趣区域的全。渲染提示是空的。createdefaultrendering可以使用存储的渲染速度。

结果

一个renderedimage含呈现的数据。

createRendering

RenderedImage createRendering(RenderContext renderContext)

创建一个renderedimage表示绘制这个图像使用一个给定的rendercontext。这是获得一个渲染一个renderableimage最普通的方式。

创建renderedimage可能有属性的字符串hints_observed表示renderinghints确定（从rendercontext）被用来创建图像。除此之外的任何renderedimages，通过创建renderedimage的getsources()方法得到的可能会有这样一种特性。

参数

renderContext - rendercontext使用产生的渲染。

结果

一个renderedimage含呈现的数据。