Module javafx.graphics

软件包 javafx.scene.image

Class WritableImage

java.lang.Object

javafx.scene.image.Image

javafx.scene.image.WritableImage

public class WritableImage
extends Image

WritableImage类表示由应用程序提供的像素构建的自定义图形图像，可能来自任何数量来源的 PixelReader对象，包括从文件或URL读取的图像。

从以下版本开始：

JavaFX 2.2

Property Summary

Properties inherited from class javafx.scene.image.Image

error, exception, height, progress, width

构造方法摘要

构造方法

Constructor	描述
WritableImage(int width, int height)	构造指定尺寸的空图像。
WritableImage(PixelReader reader, int width, int height)	构造指定尺寸的图像，从指定的PixelReader初始化。
WritableImage(PixelReader reader, int x, int y, int width, int height)	构建指定尺寸的图像，从PixelReader的指定区域初始化。

方法摘要

Modifier and Type	方法	描述
PixelWriter	getPixelWriter()	该方法返回一个 PixelWriter ，它提供访问以写入图像的像素。

Methods inherited from class javafx.scene.image.Image

cancel, errorProperty, exceptionProperty, getException, getHeight, getPixelReader, getProgress, getRequestedHeight, getRequestedWidth, getUrl, getWidth, heightProperty, isBackgroundLoading, isError, isPreserveRatio, isSmooth, progressProperty, widthProperty

Methods inherited from class java.lang.Object

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

构造方法详细信息

WritableImage

public WritableImage(int width,
                     int height)

构造指定尺寸的空图像。 图像最初将填充透明像素。 以这种方式构建的图像将始终是可读写的，所以相应的getPixelReader（）和getPixelWriter（）将始终返回有效的对象。 尺寸必须为正数(> 0) 。

参数

width - 可写图像的所需宽度

height - 所需图像的期望高度

异常

IllegalArgumentException - 如果任一维为负或为零。

WritableImage

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

构造指定尺寸的图像，从指定的PixelReader初始化。 图像最初将填充从PixelReader返回的PixelReader 。 如果PixelReader访问不包含必需数量的像素行和列的曲面，则将抛出ArrayIndexOutOfBoundsException 。 以这种方式构建的图像将始终是可读写的，所以相应的getPixelReader（）和getPixelWriter（）将始终返回有效的对象。 尺寸必须为正数(> 0) 。

参数

reader - 从 PixelReader构建

width - width图像的期望宽度和要从 reader读取的区域的宽度

height - 所需图像的期望高度和要从 reader读取的区域的宽度

异常

ArrayIndexOutOfBoundsException - 如果 reader不访问至少所请求尺寸的曲面

IllegalArgumentException - 如果任一维为负或为零。

WritableImage

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

构造指定尺寸的图像，从PixelReader的指定区域初始化。 最初将使用从指定区域的PixelReader返回的数据填充图像。 如果PixelReader访问不包含必需数量的像素行和列的曲面，则将抛出ArrayIndexOutOfBoundsException 。 以这种方式构建的图像将始终是可读写的，所以相应的getPixelReader（）和getPixelWriter（）将始终返回有效的对象。 尺寸必须为正数(> 0) 。

参数

reader - 从 PixelReader构建

x - 要从 reader读取的区域的左上角的X坐标

y - 要从 reader读取的区域的左上角的Y坐标

width - width图像的期望宽度和要从 reader读取的区域的宽度

height - 所需图像的期望高度和要从 reader读取的区域的宽度

异常

ArrayIndexOutOfBoundsException - 如果 reader不访问至少包含指定区域的表面

IllegalArgumentException - 如果任一维为负或为零。

方法详细信息

getPixelWriter

public final PixelWriter getPixelWriter()

该方法返回一个 PixelWriter ，它提供访问以写入图像的像素。

结果

用于将像素写入图像的 PixelWriter