Класс WritableImage

java.lang.Object

javafx.scene.image.Image

javafx.scene.image.WritableImage

public class WritableImage extends Image

Класс WritableImage представляет собой графическое изображение, которое строится из пикселей, предоставляемых приложением, и, возможно, из объектов PixelReader из различных источников, включая изображения, считанные из файла или URL.

Since:: JavaFX 2.2

Краткое описание свойств

Свойства, объявленные в классе javafx.scene.image.Image

error, exception, height, progress, width

Краткое описание конструкторов

Конструктор	Описание
`WritableImage(int width, int height)`	Создаёт пустое изображение заданных размеров.
`WritableImage(PixelBuffer<? extends Buffer> pixelBuffer)`	Создаёт `WritableImage` с использованием указанного `PixelBuffer`.
`WritableImage(PixelReader reader, int width, int height)`	Создаёт изображение заданных размеров, инициализированное из указанного `PixelReader`.
`WritableImage(PixelReader reader, int x, int y, int width, int height)`	Создаёт изображение заданных размеров, инициализированное из указанной области `PixelReader`.

Краткое описание методов

Модификатор и тип	Метод	Описание
`final PixelWriter`	`getPixelWriter()`	Этот метод возвращает `PixelWriter`, который предоставляет доступ для записи пикселей изображения.

Методы, объявленные в классе javafx.scene.image.Image

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

Методы, объявленные в классе 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(PixelBuffer<? extends Buffer> pixelBuffer)

Создаёт WritableImage, используя указанный PixelBuffer. Buffer, предоставленный PixelBuffer, будет напрямую использован в качестве данных пикселей для этого изображения. PixelBuffer может быть использован несколькими WritableImage. Изображения, созданные таким способом, могут читаться с помощью Image.getPixelReader(), но не могут записываться с помощью WritableImage.getPixelWriter().

Параметры:: pixelBuffer - PixelBuffer, используемый для создания изображения
Исключения:: NullPointerException - если pixelBuffer является null
С:: 13

WritableImage

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

Создаёт изображение заданных размеров, инициализированное из указанного PixelReader. Изображение изначально будет заполнено данными, возвращёнными PixelReader. Если PixelReader обращается к поверхности, которая не содержит необходимого количества строк и столбцов пикселей, будет брошено исключение ArrayIndexOutOfBoundsException. Изображения, созданные таким образом, всегда будут читаемыми и записываемыми, поэтому соответствующие getPixelReader() и getPixelWriter() всегда будут возвращать корректные объекты. Размеры должны быть положительными числами (> 0).

Параметры:: reader - PixelReader, для построения; 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 - координата X левого верхнего угла области для чтения из reader; y - координата Y левого верхнего угла области для чтения из reader; width - желаемая ширина записываемого изображения и ширина области для чтения из reader; height - желаемая высота изображения и высота области для чтения из reader
Исключения:: ArrayIndexOutOfBoundsException - если reader не обращается к поверхности, содержащей указанную область; IllegalArgumentException - если любой из размеров отрицательный или равен нулю.

Подробное описание методов

getPixelWriter

public final PixelWriter getPixelWriter()

Этот метод возвращает объект PixelWriter, предоставляющий доступ для записи пикселей изображения. Этот метод не поддерживается для изображений, созданных с помощью PixelBuffer.

Возвращает:: объект PixelWriter для записи пикселей в изображение
Исключения:: UnsupportedOperationException - если это изображение было создано с помощью PixelBuffer

© 2008, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from JavaFX API Documentation.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Java, JavaFX and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.