A RenderedImage is returned from a RenderableImage via the createRendering() method, which takes a RenderContext. The RenderContext specifies how the RenderedImage should be constructed. Note that it is not possible to extract pixels directly from a RenderableImage.
The createDefaultRendering() and createScaledRendering() methods are convenience methods that construct an appropriate RenderContext internally. All of the rendering methods may return a reference to a previously produced rendering.
| Modifier and Type | Field and Description |
|---|---|
| public static final String | HINTS_OBSERVED
String constant that can be used to identify a property on a RenderedImage obtained via the createRendering or createScaledRendering methods. |
| Modifier and Type | Method and Description |
|---|---|
| public RenderedImage | Returns: a RenderedImage containing the rendered data.Returns a RenderedImage instance of this image with a default width and height in pixels. |
| public RenderedImage | Returns: a RenderedImage containing the rendered data.the RenderContext to use to produce the rendering. renderContext)Creates a RenderedImage that represented a rendering of this image using a given RenderContext. |
| public RenderedImage | Returns: a RenderedImage containing the rendered data.the width of rendered image in pixels, or 0. w, int the height of rendered image in pixels, or 0. h, RenderingHints a RenderingHints object containing hints. hints)Creates a RenderedImage instance of this image with width w, and height h in pixels. |
| public float | Returns: the height of the image in user coordinates.Gets the height in user coordinate space. |
| public float | Returns: the minimum X coordinate of the rendering-independent image data.Gets the minimum X coordinate of the rendering-independent image data. |
| public float | Returns: the minimum Y coordinate of the rendering-independent image data.Gets the minimum Y coordinate of the rendering-independent image data. |
| public Object | Returns: a reference to the property Object, or the value java.awt.Image.UndefinedProperty.the name of the property to get, as a String. name)Gets a property from the property set of this image. |
| public String[] | Returns: a list of property names.Returns a list of names recognized by getProperty. |
| public Vector | Returns: a (possibly empty) Vector of RenderableImages, or null.Returns a vector of RenderableImages that are the sources of image data for this RenderableImage. |
| public float | Returns: the width of the image in user coordinates.Gets the width in user coordinate space. |
| public boolean | Returns: true if successive renderings with the
same arguments might produce different results;
false otherwise.Returns true if successive renderings (that is, calls to createRendering() or createScaledRendering()) with the same arguments may produce different results. |
| HINTS_OBSERVED | back to summary |
|---|---|
| public static final String HINTS_OBSERVED String constant that can be used to identify a property on a RenderedImage obtained via the createRendering or createScaledRendering methods. If such a property exists, the value of the property will be a RenderingHints object specifying which hints were observed in creating the rendering. | |
| createDefaultRendering | back to summary |
|---|---|
| public RenderedImage createDefaultRendering() Returns a RenderedImage instance of this image with a default width and height in pixels. The RenderContext is built automatically with an appropriate usr2dev transform and an area of interest of the full image. The rendering hints are empty. createDefaultRendering may make use of a stored rendering for speed.
| |
| createRendering | back to summary |
|---|---|
| public RenderedImage createRendering(RenderContext renderContext) Creates a RenderedImage that represented a rendering of this image using a given RenderContext. This is the most general way to obtain a rendering of a RenderableImage. The created RenderedImage may have a property identified by the String HINTS_OBSERVED to indicate which RenderingHints (from the RenderContext) were used to create the image. In addition any RenderedImages that are obtained via the getSources() method on the created RenderedImage may have such a property.
| |
| createScaledRendering | back to summary |
|---|---|
| public RenderedImage createScaledRendering(int w, int h, RenderingHints hints) Creates a RenderedImage instance of this image with width w, and height h in pixels. The RenderContext is built automatically with an appropriate usr2dev transform and an area of interest of the full image. All the rendering hints come from hints passed in. If w == 0, it will be taken to equal Math.round(h*(getWidth()/getHeight())). Similarly, if h == 0, it will be taken to equal Math.round(w*(getHeight()/getWidth())). One of w or h must be non-zero or else an IllegalArgumentException will be thrown. The created RenderedImage may have a property identified by the String HINTS_OBSERVED to indicate which RenderingHints were used to create the image. In addition any RenderedImages that are obtained via the getSources() method on the created RenderedImage may have such a property.
| |
| getHeight | back to summary |
|---|---|
| public float getHeight() Gets the height in user coordinate space. By convention, the usual height of a RenderedImage is equal to 1.0F.
| |
| getMinX | back to summary |
|---|---|
| public float getMinX() Gets the minimum X coordinate of the rendering-independent image data.
| |
| getMinY | back to summary |
|---|---|
| public float getMinY() Gets the minimum Y coordinate of the rendering-independent image data.
| |
| getProperty | back to summary |
|---|---|
| public Object getProperty(String name) Gets a property from the property set of this image. If the property name is not recognized, java.awt.Image.UndefinedProperty will be returned. | |
| getPropertyNames | back to summary |
|---|---|
| public String[] getPropertyNames() Returns a list of names recognized by getProperty.
| |
| getSources | back to summary |
|---|---|
| public Vector Returns a vector of RenderableImages that are the sources of image data for this RenderableImage. Note that this method may return an empty vector, to indicate that the image has no sources, or null, to indicate that no information is available.
| |
| getWidth | back to summary |
|---|---|
| public float getWidth() Gets the width in user coordinate space. By convention, the usual width of a RenderableImage is equal to the image's aspect ratio (width divided by height).
| |
| isDynamic | back to summary |
|---|---|
| public boolean isDynamic() Returns true if successive renderings (that is, calls to createRendering() or createScaledRendering()) with the same arguments may produce different results. This method may be used to determine whether an existing rendering may be cached and reused. It is always safe to return true.
| |
