Класс Image

java.lang.Object

java.awt.Image

Прямые известные подклассы:: AbstractMultiResolutionImage, BufferedImage, VolatileImage

public abstract class Image extends Object

Абстрактный класс Image является суперклассом всех классов, представляющих графические изображения. Изображение должно быть получено платформозависимым способом.

С:: 1.0

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

Модификатор и тип	Поле	Описание
`protected float`	`accelerationPriority`	Приоритет для ускорения этого изображения.
`static final int`	`SCALE_AREA_AVERAGING`	Использование алгоритма масштабирования изображения с помощью усреднения областей.
`static final int`	`SCALE_DEFAULT`	Использование алгоритма масштабирования изображений по умолчанию.
`static final int`	`SCALE_FAST`	Выбор алгоритма масштабирования изображения, который отдаёт больший приоритет скорости масштабирования, чем плавности масштабированного изображения.
`static final int`	`SCALE_REPLICATE`	Использование алгоритма масштабирования изображений, реализованного в классе `ReplicateScaleFilter`.
`static final int`	`SCALE_SMOOTH`	Выбор алгоритма масштабирования изображения, который отдаёт больший приоритет плавности изображения, чем скорости масштабирования.
`static final Object`	`UndefinedProperty`	Объект `UndefinedProperty` должен возвращаться всякий раз, когда извлекается свойство, которое не было определено для данного изображения.

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

Image()

Модификатор	Конструктор	Описание
`protected`	Конструктор для вызова подклассами.

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

Модификатор и тип	Метод	Описание
`void`	`flush()`	Очищает все реконструируемые ресурсы, используемые этим объектом Image.
`float`	`getAccelerationPriority()`	Возвращает текущее значение подсказки приоритета ускорения.
`ImageCapabilities`	`getCapabilities(GraphicsConfiguration gc)`	Возвращает объект ImageCapabilities, который можно запросить о возможностях этого изображения на указанном GraphicsConfiguration.
`abstract Graphics`	`getGraphics()`	Создаёт графический контекст для рисования на изображении вне экрана.
`abstract int`	`getHeight(ImageObserver observer)`	Определяет высоту изображения.
`abstract Object`	`getProperty(String name, ImageObserver observer)`	Получает свойство этого изображения по имени.
`Image`	`getScaledInstance(int width, int height, int hints)`	Создаёт масштабированную версию этого изображения.
`abstract ImageProducer`	`getSource()`	Получает объект, который создаёт пиксели для изображения.
`abstract int`	`getWidth(ImageObserver observer)`	Определяет ширину изображения.
`void`	`setAccelerationPriority(float priority)`	Устанавливает подсказку для этого изображения о важности ускорения.

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

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

Подробное описание полей

accelerationPriority

protected float accelerationPriority

Приоритет ускорения этого изображения. Подклассы могут свободно устанавливать разные значения по умолчанию, а приложения могут устанавливать приоритет для конкретных изображений с помощью метода setAccelerationPriority(float).

Since:: 1.5

UndefinedProperty

public static final Object UndefinedProperty

Объект UndefinedProperty должен возвращаться всякий раз, когда запрашивается свойство, которое не определено для конкретного изображения.

SCALE_DEFAULT

public static final int SCALE_DEFAULT

Использовать алгоритм масштабирования изображения по умолчанию.

Since:

1.1

См. также:

Значения константных полей

SCALE_FAST

public static final int SCALE_FAST

Выбрать алгоритм масштабирования изображения, который отдаёт приоритет скорости масштабирования перед плавностью масштабируемого изображения.

Since:

1.1

См. также:

Значения константных полей

SCALE_SMOOTH

public static final int SCALE_SMOOTH

Выбрать алгоритм масштабирования изображения, который отдаёт приоритет плавности изображения перед скоростью масштабирования.

Since:

1.1

См. также:

Значения константных полей

SCALE_REPLICATE

public static final int SCALE_REPLICATE

Использовать алгоритм масштабирования изображения, воплощённый в классе ReplicateScaleFilter. Объект Image свободен для замены другого фильтра, выполняющего тот же алгоритм, но интегрирующегося более эффективно в инфраструктуру обработки изображений, предоставляемую набором инструментов.

Since:

1.1

См. также:

SCALE_AREA_AVERAGING

public static final int SCALE_AREA_AVERAGING

Использовать алгоритм масштабирования изображения по среднему значению области. Объект изображения может свободно заменить другой фильтр, выполняющий тот же алгоритм, но интегрирующийся более эффективно в инфраструктуру обработки изображений, предоставляемую набором инструментов.

Since:

1.1

См. также:

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

Image

protected Image()

Конструктор для вызова подклассами.

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

getWidth

public abstract int getWidth(ImageObserver observer)

Определяет ширину изображения. Если ширина ещё неизвестна, этот метод возвращает -1 , и указанный объект ImageObserver уведомляется позже.

Параметры:

observer - объект, ожидающий загрузки изображения.

Возвращает:

ширину этого изображения или -1 , если ширина ещё неизвестна.

См. также:

getHeight(java.awt.image.ImageObserver)
ImageObserver

getHeight

public abstract int getHeight(ImageObserver observer)

Определяет высоту изображения. Если высота ещё неизвестна, этот метод возвращает -1 , и указанный объект ImageObserver уведомляется позже.

Параметры:

observer - объект, ожидающий загрузки изображения.

Возвращает:

высоту этого изображения или -1 , если высота ещё неизвестна.

См. также:

getWidth(java.awt.image.ImageObserver)
ImageObserver

getSource

public abstract ImageProducer getSource()

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

Возвращает:

производитель изображений, который генерирует пиксели для этого изображения.

См. также:

ImageProducer

getGraphics

public abstract Graphics getGraphics()

Создаёт контекст графики для рисования на изображении вне экрана. Этот метод может быть вызван только для изображений вне экрана.

Возвращает:

контекст графики для рисования на изображении вне экрана.

Исключения:

UnsupportedOperationException - если вызов осуществляется для изображения, не находящегося вне экрана.

См. также:

getProperty

public abstract Object getProperty(String name, ImageObserver observer)

Получает свойство этого изображения по имени.

Индивидуальные имена свойств определяются различными форматами изображений. Если свойство не определено для конкретного изображения, этот метод возвращает объект UndefinedProperty.

Если свойства этого изображения ещё не известны, этот метод возвращает null, и объект ImageObserver уведомляется позже.

Имя свойства "comment" должно использоваться для хранения необязательного комментария, который может быть представлен приложению как описание изображения, его источника или автора.

Параметры:

name - имя свойства.

observer - объект, ожидающий загрузки этого изображения.

Возвращает:

значение заданного свойства.

Исключения:

NullPointerException - если имя свойства равно null.

См. также:

getScaledInstance

public Image getScaledInstance(int width, int height, int hints)

Создаёт масштабированную версию этого изображения. Возвращается новый объект Image, который будет отображать изображение с заданной шириной width и высотой height по умолчанию. Новый объект Image может загружаться асинхронно, даже если исходное изображение уже полностью загружено.

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

Параметры:

width - ширина, до которой масштабировать изображение.

height - высота, до которой масштабировать изображение.

hints - флаги, указывающие тип алгоритма, который нужно использовать для повторной выборки изображения.

Возвращает:

масштабированную версию изображения.

Исключения:

IllegalArgumentException - если width или height равны нулю.

Since:

1.1

См. также:

SCALE_DEFAULT
SCALE_FAST
SCALE_SMOOTH
SCALE_REPLICATE
SCALE_AREA_AVERAGING

flush

public void flush()

Очищает все ресурсы, которые можно восстановить, используемые этим объектом Image. Это включает в себя любые данные пикселей, которые кешируются для отображения на экране, а также любые системные ресурсы, которые используются для хранения данных или пикселей для изображения, если они могут быть воссозданы. Изображение сбрасывается в состояние, аналогичное тому, в котором оно было создано, так что если оно будет снова отображено, данные изображения придётся снова воссоздать или получить из источника.

Примеры того, как этот метод влияет на определённые типы объектов Image:

Объекты BufferedImage оставляют неизменённым основной Raster, хранящий их пиксели, но очищают любые кешированные данные о пикселях, такие как копии, загруженные на аппаратное обеспечение дисплея для ускоренных копирований.
Объекты Image, созданные методами Component, которые принимают ширину и высоту, оставляют их основной буфер пикселей неизменённым, но все кешированные данные высвобождаются так же, как и для объектов BufferedImage.
Объекты VolatileImage высвобождают все свои ресурсы пикселей, включая их основную копию, которая обычно хранится на аппаратном обеспечении дисплея, где ресурсы ограничены. Эти объекты могут быть восстановлены позже с помощью метода validate.
Объекты Image, созданные классами Toolkit и Component, которые загружаются из файлов, URL-адресов или создаются ImageProducer, разгружаются, и все локальные ресурсы высвобождаются. Эти объекты могут быть перезагружены из их исходного источника по мере необходимости при их отображении, как и при их первоначальном создании.

getCapabilities

public ImageCapabilities getCapabilities(GraphicsConfiguration gc)

Возвращает объект ImageCapabilities, который позволяет узнать возможности данного изображения на указанном GraphicsConfiguration. Это позволяет программистам получить дополнительную информацию во время выполнения о конкретном объекте Image, который они создали. Например, пользователь может создать BufferedImage, но система может не иметь свободной видеопамяти для создания изображения такого размера на заданном GraphicsConfiguration, поэтому, хотя объект может быть ускорен в общем случае, он не обладает этой возможностью на данном GraphicsConfiguration.

Параметры:

gc - объект GraphicsConfiguration. Значение null для этого параметра приведет к получению возможностей изображения для по умолчанию GraphicsConfiguration.

Возвращает:

объект ImageCapabilities, содержащий возможности этого Image на указанном GraphicsConfiguration.

С:

1.5

См. также:

VolatileImage.getCapabilities()

setAccelerationPriority

public void setAccelerationPriority(float priority)

Устанавливает подсказку для этого изображения о том, насколько важна ускорение. Эта подсказка приоритета используется для сравнения с приоритетами других объектов Image при определении способа использования ограниченных ресурсов ускорения, таких как видеопамять. Когда и если ускорение данного Image возможно, если доступных ресурсов недостаточно для обеспечения этого ускорения, но достаточно для освобождения ресурсов путем деакселерации другого изображения с более низким приоритетом, то это другое изображение может быть деакселерировано в пользу этого. Изображения с одинаковым приоритетом занимают ресурсы по принципу «первым пришёл — первым обслужен».

Параметры:: priority - значение от 0 до 1 включительно, где более высокие значения указывают на большую важность ускорения. Значение 0 означает, что это изображение никогда не должно ускоряться. Другие значения используются только для определения приоритета ускорения относительно других изображений.
Исключения:: IllegalArgumentException - если priority меньше нуля или больше 1.
С:: 1.5

getAccelerationPriority

public float getAccelerationPriority()

Возвращает текущее значение подсказки приоритета ускорения.

Возвращает:

значение от 0 до 1 включительно, которое представляет текущее значение приоритета

С:

1.5

См. также:

setAccelerationPriority

© 1993, 2021, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/17/docs/api/java.desktop/java/awt/Image.html