Класс WritableImage

java.lang.Object

javafx.scene.image.Image

javafx.scene.image.WritableImage

public class WritableImage extends Image

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

С:: 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.