Spec-Zone .ru
спецификации, руководства, описания, API
|
public class Image
extends java.lang.Object
Image
class представляет графические изображения и используется для того, чтобы загрузить изображения из указанного URL. Изображения могут быть изменены, поскольку они загружаются (например, чтобы уменьшить объем памяти, использованный изображением). Приложение может определить качество фильтрации используемого, масштабируясь, и сохранить ли формат изображения исходного изображения.
Все URL, поддерживаемые URL
может быть передан конструктору. Если переданной строкой не является допустимый URL, а путь вместо этого, Изображение ищется на пути к классу в этом случае.
Использовать ImageView
для того, чтобы вывести на экран изображения загружался с этим class. То же самое Image
экземпляр может быть выведен на экран многократным ImageView
s.
Пример кода для того, чтобы загрузить изображения.
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) // The image is located in default package of the classpath Image image1 = new Image("/flower.png", true); // load an image and resize it to 100x150 without preserving its original // aspect ratio // The image is located in my.res package of the classpath Image image2 = new Image("my/res/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 // The image is downloaded from the supplied URL through http protocol Image image3 = new Image("http://sample.com/res/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 // The image is located in the current working directory Image image4 = new Image("file: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.
|
PixelReader |
getPixelReader()
Этот метод возвращает a
PixelReader это обеспечивает доступ, чтобы считать пиксели изображения, если изображение читаемо. |
double |
getProgress()
Получает значение продвижения свойства.
|
double |
getRequestedHeight()
Получает height ограничивающего прямоугольника, в пределах которого исходное изображение изменяется по мере необходимости, чтобы соответствовать.
|
double |
getRequestedWidth()
Получает width ограничивающего прямоугольника, в пределах которого исходное изображение изменяется по мере необходимости, чтобы соответствовать.
|
double |
getWidth()
Получает значение свойства width.
|
ReadOnlyDoubleProperty |
heightProperty()
Изображение height или
0 если загрузка изображения перестала работать. |
boolean |
isBackgroundLoading()
Указывает, загружается ли изображение в фоновом режиме.
|
boolean |
isError()
Получает значение ошибки свойства.
|
boolean |
isPreserveRatio()
Указывает, сохранить ли формат изображения исходного изображения, масштабируясь, чтобы соответствовать изображению в пределах ограничивающего прямоугольника, обеспеченного
width и height . |
boolean |
isSmooth()
Указывает, использовать ли лучший качественный алгоритм фильтрации или более быстрый, масштабируя это изображение, чтобы соответствовать в пределах ограничивающего прямоугольника, обеспеченного
width и height . |
ReadOnlyDoubleProperty |
progressProperty()
Приблизительный процент загрузки изображения, которая была завершена.
|
ReadOnlyDoubleProperty |
widthProperty()
Изображение width или
0 если загрузка изображения перестала работать. |
public final ReadOnlyDoubleProperty progressProperty
getProgress()
public final ReadOnlyDoubleProperty widthProperty
0
если загрузка изображения перестала работать. В то время как изображение загружается, оно устанавливается в 0
.getWidth()
public final ReadOnlyDoubleProperty heightProperty
0
если загрузка изображения перестала работать. В то время как изображение загружается, оно устанавливается в 0
.getHeight()
public final ReadOnlyBooleanProperty errorProperty
isError()
public Image(java.lang.String url)
Image
с контентом, загруженным из указанного url.url
- строка, представляющая URL, чтобы использовать в выборке пиксельных данныхjava.lang.NullPointerException
- если URL является нулемjava.lang.IllegalArgumentException
- если URL недопустим или неподдерживаетсяImage(java.lang.String, java.io.InputStream, double, double, boolean, boolean, boolean)
public Image(java.lang.String url, boolean backgroundLoading)
Image
с указанными параметрами.url
- строка, представляющая URL, чтобы использовать в выборке пиксельных данныхbackgroundLoading
- указывает, загружается ли изображение в фоновом режимеjava.lang.NullPointerException
- если URL является нулемjava.lang.IllegalArgumentException
- если URL недопустим или неподдерживаетсяImage(java.lang.String, java.io.InputStream, double, double, boolean, boolean, boolean)
public Image(java.lang.String url, double requestedWidth, double requestedHeight, boolean preserveRatio, boolean smooth)
Image
с указанными параметрами.url
- строка, представляющая URL, чтобы использовать в выборке пиксельных данныхrequestedWidth
- ограничивающий прямоугольник изображения widthrequestedHeight
- ограничивающий прямоугольник изображения heightpreserveRatio
- указывает, сохранить ли формат изображения исходного изображения, масштабируясь, чтобы соответствовать изображению в пределах указанного ограничивающего прямоугольникаsmooth
- указывает, использовать ли лучший качественный алгоритм фильтрации или более быстрый, масштабируя это изображение, чтобы соответствовать в пределах указанного ограничивающего прямоугольникаjava.lang.NullPointerException
- если URL является нулемjava.lang.IllegalArgumentException
- если URL недопустим или неподдерживаетсяImage(java.lang.String, java.io.InputStream, double, double, boolean, boolean, boolean)
public Image(java.lang.String url, double requestedWidth, double requestedHeight, boolean preserveRatio, boolean smooth, boolean backgroundLoading)
Image
с указанными параметрами. url без схемы является threated как относительно пути к классу, url со схемой обрабатывается соответственно к использованию схемы URL.openStream()
url
- строка, представляющая URL, чтобы использовать в выборке пиксельных данныхrequestedWidth
- ограничивающий прямоугольник изображения widthrequestedHeight
- ограничивающий прямоугольник изображения heightpreserveRatio
- указывает, сохранить ли формат изображения исходного изображения, масштабируясь, чтобы соответствовать изображению в пределах указанного ограничивающего прямоугольникаsmooth
- указывает, использовать ли лучший качественный алгоритм фильтрации или более быстрый, масштабируя это изображение, чтобы соответствовать в пределах указанного ограничивающего прямоугольникаbackgroundLoading
- указывает, загружается ли изображение в фоновом режимеjava.lang.NullPointerException
- если URL является нулемjava.lang.IllegalArgumentException
- если URL недопустим или неподдерживаетсяpublic Image(java.io.InputStream is)
Image
с контентом, загруженным из указанного входного потока.is
- поток, из которого можно загрузить изображениеjava.lang.NullPointerException
- если входной поток является нулемpublic Image(java.io.InputStream is, double requestedWidth, double requestedHeight, boolean preserveRatio, boolean smooth)
Image
с указанными параметрами.is
- поток, из которого можно загрузить изображениеrequestedWidth
- ограничивающий прямоугольник изображения widthrequestedHeight
- ограничивающий прямоугольник изображения heightpreserveRatio
- указывает, сохранить ли формат изображения исходного изображения, масштабируясь, чтобы соответствовать изображению в пределах указанного ограничивающего прямоугольникаsmooth
- указывает, использовать ли лучший качественный алгоритм фильтрации или более быстрый, масштабируя это изображение, чтобы соответствовать в пределах указанного ограничивающего прямоугольникаjava.lang.NullPointerException
- если входной поток является нулемpublic final double getProgress()
public final ReadOnlyDoubleProperty progressProperty()
getProgress()
public final double getRequestedWidth()
<= 0
, тогда внутренний width изображения будет использоваться. См. preserveRatio
для информации о взаимодействии между изображением requestedWidth
, requestedHeight
и preserveRatio
атрибуты.public final double getRequestedHeight()
<= 0
, тогда внутренний height изображения будет использоваться. См. preserveRatio
для информации о взаимодействии между изображением requestedWidth
, requestedHeight
и preserveRatio
атрибуты.public final double getWidth()
0
если загрузка изображения перестала работать. В то время как изображение загружается, оно устанавливается в 0
.public final ReadOnlyDoubleProperty widthProperty()
0
если загрузка изображения перестала работать. В то время как изображение загружается, оно устанавливается в 0
.getWidth()
public final double getHeight()
0
если загрузка изображения перестала работать. В то время как изображение загружается, оно устанавливается в 0
.public final ReadOnlyDoubleProperty heightProperty()
0
если загрузка изображения перестала работать. В то время как изображение загружается, оно устанавливается в 0
.getHeight()
public final boolean isPreserveRatio()
width
и height
. Если установлено в true
, это влияет на размерности этого Image
следующим образом: width
устанавливается, height масштабируется, чтобы сохранить отношение height
устанавливается, width масштабируется, чтобы сохранить отношение width
и height
может отличаться от первоначально значения набора, если они должны были быть скорректированы, чтобы сохранить формат изображения. Если сброшено или установлено в false
, это влияет на размерности этого ImageView
следующим образом: width
устанавливается, width изображения масштабируется, чтобы соответствовать, и height неизменен; height
устанавливается, height изображения масштабируется, чтобы соответствовать, и height неизменен; width
и height
.public final boolean isSmooth()
width
и height
. Если не инициализированный или набор к true
лучшая качественная фильтрация будет использоваться, иначе будет использоваться более быстрая, но меньшая качественная фильтрация.
width
и height
.public final boolean isBackgroundLoading()
public final boolean isError()
public final ReadOnlyBooleanProperty errorProperty()
isError()
public void cancel()
Не имеет никакого эффекта, если это изображение не загружается в фоне или если загрузка уже завершилась.
public final PixelReader getPixelReader()
PixelReader
это обеспечивает доступ, чтобы считать пиксели изображения, если изображение читаемо. Если этот нуль возвратов метода тогда это изображение не поддерживает чтение в это время. Этот метод возвратит нуль, если изображение будет загружено из источника и будет все еще неполно {продвижение все еще < 1.0) or if
there was an error.
This method may also return null for some images in a format that
is not supported for reading and writing pixels to.PixelReader
для того, чтобы считать пиксельные данные изображенияCopyright (c) 2008, 2012, Oracle и/или его филиалы. Все права защищены. Использование подвергается