javafx.scene.image

Изображение класса

java.lang. Объект

javafx.scene.image. Изображение

public class Image
extends java.lang.Object

Image class представляет графические изображения и используется для того, чтобы загрузить изображения из указанного URL.

Изображения могут быть изменены, поскольку они загружаются (например, чтобы уменьшить объем памяти, использованный изображением). Приложение может определить качество фильтрации используемого, масштабируясь, и сохранить ли формат изображения исходного изображения.

Использовать ImageView для того, чтобы вывести на экран изображения загружался с этим class. То же самое Image экземпляр может быть выведен на экран многократным ImageViews.

Пример кода для того, чтобы загрузить изображения.

import javafx.scene.image.Image;

// load an image in background, displaying a placeholder while it's loading
// (assuming there's an ImageView node somewhere displaying this image)
Image image1 = new Image("flower.png", true);

// load an image and resize it to 100x150 without preserving its original
// aspect ratio
Image image2 = new Image("flower.png", 100, 150, false, false);

// load an image and resize it to width of 100 while preserving its
// original aspect ratio, using faster filtering method
Image image3 = new Image("flower.png", 100, 0, false, false);

// load an image and resize it only in one dimension, to the height of 100 and
// the original width, without preserving original aspect ratio
Image image4 = new Image("flower.png", 0, 100, false, false);

Сводка свойства

Свойства

Ввести	Свойство и Описание
ReadOnlyBooleanProperty	ошибка Указывает, была ли ошибка обнаружена, загружая изображение.
ReadOnlyDoubleProperty	height Изображение height или 0 если загрузка изображения перестала работать.
ReadOnlyDoubleProperty	продвижение Приблизительный процент загрузки изображения, которая была завершена.
ReadOnlyDoubleProperty	width Изображение width или 0 если загрузка изображения перестала работать.

Сводка конструктора

Конструкторы

Конструктор и Описание
Image(java.io.InputStream is) Создайте Image какие пиксели загружаются из указанного входного потока.
Image(java.io.InputStream is, double requestedWidth, double requestedHeight, boolean preserveRatio, boolean smooth) Создайте новое Image с указанными параметрами.
Image(java.lang.String url) Создайте Image какие пиксели загружаются из указанного url.
Image(java.lang.String url, boolean backgroundLoading) Создайте новое Image с указанными параметрами.
Image(java.lang.String url, double requestedWidth, double requestedHeight, boolean preserveRatio, boolean smooth) Создайте новое Image с указанными параметрами.
Image(java.lang.String url, double requestedWidth, double requestedHeight, boolean preserveRatio, boolean smooth, boolean backgroundLoading) Создайте новое Image с указанными параметрами.

Сводка метода

Методы

Модификатор и Тип	Метод и Описание
void	cancel() Отменяет фоновую загрузку этого изображения.
ReadOnlyBooleanProperty	errorProperty() Указывает, была ли ошибка обнаружена, загружая изображение.
double	getHeight() Изображение height или 0 если загрузка изображения перестала работать.
double	getProgress() Приблизительный процент загрузки изображения, которая была завершена.
double	getRequestedHeight() Получает height ограничивающего прямоугольника, в пределах которого исходное изображение изменяется по мере необходимости, чтобы соответствовать.
double	getRequestedWidth() Получает width ограничивающего прямоугольника, в пределах которого исходное изображение изменяется по мере необходимости, чтобы соответствовать.
double	getWidth() Изображение width или 0 если загрузка изображения перестала работать.
ReadOnlyDoubleProperty	heightProperty() Изображение height или 0 если загрузка изображения перестала работать.
boolean	isBackgroundLoading() Указывает, загружается ли изображение в фоновом режиме.
boolean	isError() Указывает, была ли ошибка обнаружена, загружая изображение.
boolean	isPreserveRatio() Указывает, сохранить ли формат изображения исходного изображения, масштабируясь, чтобы соответствовать изображению в пределах ограничивающего прямоугольника, обеспеченного width и height.
boolean	isSmooth() Указывает, использовать ли лучший качественный алгоритм фильтрации или более быстрый, масштабируя это изображение, чтобы соответствовать в пределах ограничивающего прямоугольника, обеспеченного width и height.
ReadOnlyDoubleProperty	progressProperty() Приблизительный процент загрузки изображения, которая была завершена.
ReadOnlyDoubleProperty	widthProperty() Изображение width или 0 если загрузка изображения перестала работать.

Методы, наследованные от class java.lang. Объект

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

Деталь свойства

продвижение

Приблизительный процент загрузки изображения, которая была завершена. Положительное значение между 0 и 1, где 0 0 % и 1, составляет 100 %.

См. Также:

getProgress()

width

Изображение width или 0 если загрузка изображения перестала работать. В то время как изображение загружается, оно устанавливается в 0.

См. Также:

getWidth()

height

Изображение height или 0 если загрузка изображения перестала работать. В то время как изображение загружается, оно устанавливается в 0.

См. Также:

getHeight()

ошибка

Указывает, была ли ошибка обнаружена, загружая изображение.

См. Также:

isError()

Деталь конструктора

Изображение

public Image(java.lang.String url)

Создайте Image какие пиксели загружаются из указанного url.

Параметры:

url - строка, представляющая URL, чтобы использовать в выборке пиксельных данных

Изображение

public Image(java.lang.String url,
     boolean backgroundLoading)

Создайте новое Image с указанными параметрами.

Параметры:

url - строка, представляющая URL, чтобы использовать в выборке пиксельных данных

backgroundLoading - указывает, загружается ли изображение в фоновом режиме

Изображение

public Image(java.lang.String url,
     double requestedWidth,
     double requestedHeight,
     boolean preserveRatio,
     boolean smooth)

Создайте новое Image с указанными параметрами.

Параметры:

url - строка, представляющая URL, чтобы использовать в выборке пиксельных данных

requestedWidth - ограничивающий прямоугольник изображения width

requestedHeight - ограничивающий прямоугольник изображения height

preserveRatio - указывает, сохранить ли формат изображения исходного изображения, масштабируясь, чтобы соответствовать изображению в пределах указанного ограничивающего прямоугольника

smooth - указывает, использовать ли лучший качественный алгоритм фильтрации или более быстрый, масштабируя это изображение, чтобы соответствовать в пределах указанного ограничивающего прямоугольника

Изображение

public Image(java.lang.String url,
     double requestedWidth,
     double requestedHeight,
     boolean preserveRatio,
     boolean smooth,
     boolean backgroundLoading)

Создайте новое Image с указанными параметрами.

Параметры:

url - строка, представляющая URL, чтобы использовать в выборке пиксельных данных

requestedWidth - ограничивающий прямоугольник изображения width

requestedHeight - ограничивающий прямоугольник изображения height

preserveRatio - указывает, сохранить ли формат изображения исходного изображения, масштабируясь, чтобы соответствовать изображению в пределах указанного ограничивающего прямоугольника

smooth - указывает, использовать ли лучший качественный алгоритм фильтрации или более быстрый, масштабируя это изображение, чтобы соответствовать в пределах указанного ограничивающего прямоугольника

backgroundLoading - указывает, загружается ли изображение в фоновом режиме

Изображение

public Image(java.io.InputStream is)

Создайте Image какие пиксели загружаются из указанного входного потока.

Параметры:

is - поток, из которого можно загрузить изображение

Изображение

public Image(java.io.InputStream is,
     double requestedWidth,
     double requestedHeight,
     boolean preserveRatio,
     boolean smooth)

Создайте новое Image с указанными параметрами.

Параметры:

is - поток, из которого можно загрузить изображение

requestedWidth - ограничивающий прямоугольник изображения width

requestedHeight - ограничивающий прямоугольник изображения height

preserveRatio - указывает, сохранить ли формат изображения исходного изображения, масштабируясь, чтобы соответствовать изображению в пределах указанного ограничивающего прямоугольника

smooth - указывает, использовать ли лучший качественный алгоритм фильтрации или более быстрый, масштабируя это изображение, чтобы соответствовать в пределах указанного ограничивающего прямоугольника

Деталь метода

getProgress

public final double getProgress()

Приблизительный процент загрузки изображения, которая была завершена. Положительное значение между 0 и 1, где 0 0 % и 1, составляет 100 %.

progressProperty

public final ReadOnlyDoubleProperty progressProperty()

Приблизительный процент загрузки изображения, которая была завершена. Положительное значение между 0 и 1, где 0 0 % и 1, составляет 100 %.

См. Также:

getProgress()

getRequestedWidth

public final double getRequestedWidth()

Получает width ограничивающего прямоугольника, в пределах которого исходное изображение изменяется по мере необходимости, чтобы соответствовать. Если установлено в значение <= 0, тогда внутренний width изображения будет использоваться.

См. preserveRatio для информации о взаимодействии между изображением requestedWidth, requestedHeight и preserveRatio атрибуты.

Возвраты:

Требуемый width

getRequestedHeight

public final double getRequestedHeight()

Получает height ограничивающего прямоугольника, в пределах которого исходное изображение изменяется по мере необходимости, чтобы соответствовать. Если установлено в значение <= 0, тогда внутренний height изображения будет использоваться.

См. preserveRatio для информации о взаимодействии между изображением requestedWidth, requestedHeight и preserveRatio атрибуты.

Возвраты:

Требуемый height

getWidth

public final double getWidth()

Изображение width или 0 если загрузка изображения перестала работать. В то время как изображение загружается, оно устанавливается в 0.

widthProperty

public final ReadOnlyDoubleProperty widthProperty()

Изображение width или 0 если загрузка изображения перестала работать. В то время как изображение загружается, оно устанавливается в 0.

См. Также:

getWidth()

getHeight

public final double getHeight()

Изображение height или 0 если загрузка изображения перестала работать. В то время как изображение загружается, оно устанавливается в 0.

heightProperty

public final ReadOnlyDoubleProperty heightProperty()

Изображение height или 0 если загрузка изображения перестала работать. В то время как изображение загружается, оно устанавливается в 0.

См. Также:

getHeight()

isPreserveRatio

public final boolean isPreserveRatio()

Указывает, сохранить ли формат изображения исходного изображения, масштабируясь, чтобы соответствовать изображению в пределах ограничивающего прямоугольника, обеспеченного width и height.

Если установлено в true, это влияет на размерности этого Image следующим образом:

• Если только width устанавливается, height масштабируется, чтобы сохранить отношение
• Если только height устанавливается, width масштабируется, чтобы сохранить отношение
• Если оба устанавливаются, они оба могут масштабироваться, чтобы добраться, лучшие помещаются в width прямоугольником height, сохраняя исходный формат изображения

Сообщаемый width и height может отличаться от первоначально значения набора, если они должны были быть скорректированы, чтобы сохранить формат изображения. Если сброшено или установлено в false, это влияет на размерности этого ImageView следующим образом:

• Если только width устанавливается, width изображения масштабируется, чтобы соответствовать, и height неизменен;
• Если только height устанавливается, height изображения масштабируется, чтобы соответствовать, и height неизменен;
• Если оба устанавливаются, изображение масштабируется, чтобы соответствовать обоим.

isSmooth

public final boolean isSmooth()

Указывает, использовать ли лучший качественный алгоритм фильтрации или более быстрый, масштабируя это изображение, чтобы соответствовать в пределах ограничивающего прямоугольника, обеспеченного width и height.

Если не инициализированный или набор к true лучшая качественная фильтрация будет использоваться, иначе будет использоваться более быстрая, но меньшая качественная фильтрация.

Возвраты:

истина, если лучшее качество (но медленнее) фильтрация алгоритма используется для того, чтобы масштабироваться, чтобы соответствовать в пределах ограничивающего прямоугольника, обеспеченного width и height.

isBackgroundLoading

public final boolean isBackgroundLoading()

Указывает, загружается ли изображение в фоновом режиме.

Возвраты:

истина, если изображение загружается в фоновом режиме

isError

public final boolean isError()

Указывает, была ли ошибка обнаружена, загружая изображение.

errorProperty

public final ReadOnlyBooleanProperty errorProperty()

Указывает, была ли ошибка обнаружена, загружая изображение.

См. Также:

isError()

отмена

public void cancel()

Отменяет фоновую загрузку этого изображения.

Не имеет никакого эффекта, если это изображение не загружается в фоне или если загрузка уже завершилась.