javafx.scene.image

Class WritableImage

java.lang.Object

javafx.scene.image.Image

javafx.scene.image.WritableImage

public class WritableImage
extends Image

The WritableImage class represents a custom graphical image that is constructed from pixels supplied by the application, and possibly from PixelReader objects from any number of sources, including images read from a file or URL.

Since:

JavaFX 2.2

Property Summary

Properties inherited from class javafx.scene.image.Image

acc_platformImageProperty, errorProperty, exceptionProperty, heightProperty, progressProperty, widthProperty

Field Summary

Fields

Modifier and Type	Field and Description
private ImageLoader	tkImageLoader
private PixelWriter	writer

Constructor Summary

Constructors

Constructor and Description
WritableImage(int width, int height) Construct an empty image of the specified dimensions.
WritableImage(PixelReader reader, int width, int height) Construct an image of the specified dimensions, initialized from the indicated PixelReader.
WritableImage(PixelReader reader, int x, int y, int width, int height) Construct an image of the specified dimensions, initialized from the indicated region of the PixelReader.

Method Summary

Modifier and Type	Method and Description
PixelWriter	getPixelWriter() This method returns a PixelWriter that provides access to write the pixels of the image.
private java.lang.Object	getTkImageLoader()
(package private) boolean	isAnimation() Indicates whether image is animated.
private void	loadTkImage(java.lang.Object loader)
(package private) boolean	pixelsReadable()

Methods inherited from class javafx.scene.image.Image

acc_platformImageProperty, cancel, dispose, errorProperty, exceptionProperty, fromPlatformImage, getException, getHeight, getInputSource, getPixelReader, getPlatformImage, getProgress, getRequestedHeight, getRequestedWidth, getUrl, getWidth, getWritablePlatformImage, heightProperty, isBackgroundLoading, isError, isPreserveRatio, isSmooth, pixelsDirty, progressProperty, setPlatformImage, setProgress, widthProperty

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

tkImageLoader

private ImageLoader tkImageLoader

writer

private PixelWriter writer

Constructor Detail

WritableImage

public WritableImage(int width,
                     int height)

Construct an empty image of the specified dimensions. The image will initially be filled with transparent pixels. Images constructed this way will always be readable and writable so the corresponding getPixelReader() and getPixelWriter() will always return valid objects. The dimensions must both be positive numbers (> 0).

Parameters:

width - the desired width of the writable image

height - the desired height of the desired image

Throws:

java.lang.IllegalArgumentException - if either dimension is negative or zero.

WritableImage

public WritableImage(PixelReader reader,
                     int width,
                     int height)

Construct an image of the specified dimensions, initialized from the indicated PixelReader. The image will initially be filled with data returned from the PixelReader. If the PixelReader accesses a surface that does not contain the necessary number of pixel rows and columns then an ArrayIndexOutOfBoundsException will be thrown. Images constructed this way will always be readable and writable so the corresponding getPixelReader() and getPixelWriter() will always return valid objects. The dimensions must both be positive numbers (> 0).

Parameters:

reader - the PixelReader to construct from

width - the desired width of the writable image and the width of the region to be read from the reader

height - the desired height of the desired image and the width of the region to be read from the reader

Throws:

java.lang.ArrayIndexOutOfBoundsException - if the reader does not access a surface of at least the requested dimensions

java.lang.IllegalArgumentException - if either dimension is negative or zero.

WritableImage

public WritableImage(PixelReader reader,
                     int x,
                     int y,
                     int width,
                     int height)

Construct an image of the specified dimensions, initialized from the indicated region of the PixelReader. The image will initially be filled with data returned from the PixelReader for the specified region. If the PixelReader accesses a surface that does not contain the necessary number of pixel rows and columns then an ArrayIndexOutOfBoundsException will be thrown. Images constructed this way will always be readable and writable so the corresponding getPixelReader() and getPixelWriter() will always return valid objects. The dimensions must both be positive numbers (> 0).

Parameters:

reader - the PixelReader to construct from

x - the X coordinate of the upper left corner of the region to read from the reader

y - the Y coordinate of the upper left corner of the region to read from the reader

width - the desired width of the writable image and the width of the region to be read from the reader

height - the desired height of the desired image and the width of the region to be read from the reader

Throws:

java.lang.ArrayIndexOutOfBoundsException - if the reader does not access a surface containing at least the indicated region

java.lang.IllegalArgumentException - if either dimension is negative or zero.

Method Detail

isAnimation

boolean isAnimation()

Description copied from class: Image

Indicates whether image is animated.

Overrides:

isAnimation in class Image

pixelsReadable

boolean pixelsReadable()

Overrides:

pixelsReadable in class Image

getPixelWriter

public final PixelWriter getPixelWriter()

This method returns a PixelWriter that provides access to write the pixels of the image.

Returns:

the PixelWriter for writing pixels to the image

loadTkImage

private void loadTkImage(java.lang.Object loader)

getTkImageLoader

private java.lang.Object getTkImageLoader()