Класс WritableImage
java.lang.Object
javafx.scene.image.Image
javafx.scene.image.WritableImage
public class WritableImage
extends Image Класс
WritableImage представляет собой графическое изображение, созданное из пикселей, предоставленных приложением, и, возможно, из объектов PixelReader из различных источников, включая изображения, прочитанные из файла или URL.- С момента:
- JavaFX 2.2
Краткое описание свойств
Краткое описание конструкторов
| Конструктор | Описание |
|---|---|
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. |
Краткое описание методов
| Модификатор и тип | Метод | Описание |
|---|---|---|
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
Подробное описание конструкторов
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.
