Класс 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`	Использовать алгоритм масштабирования изображения 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, который может быть запрошен о возможностях этого Image на указанной 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

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

Since:

1.1

См. также:

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

Image

protected Image()

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

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

getWidth

public abstract int getWidth(ImageObserver observer)

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

Параметры:

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

Возвращает:

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

См. также:

getHeight

public abstract int getHeight(ImageObserver observer)

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

Параметры:

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

Возвращает:

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

См. также:

getSource

public abstract ImageProducer getSource()

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

Возвращает:

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

См. также:

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

См. также:

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, который можно запросить для определения возможностей этого Image в указанной GraphicsConfiguration. Это позволяет программистам получить дополнительную информацию во время выполнения о конкретном объекте Image, который они создали. Например, пользователь может создать BufferedImage, но система может не иметь свободной видеопамяти для создания изображения такого размера в заданной GraphicsConfiguration, поэтому, хотя объект может быть ускоряемым в общем случае, он не обладает такой способностью в данной GraphicsConfiguration.

Parameters:

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

Returns:

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

Since:

1.5

See Also:

setAccelerationPriority

public void setAccelerationPriority(float priority)

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

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

getAccelerationPriority

public float getAccelerationPriority()

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

Returns:

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

Since:

1.5

See Also:

© 1993, 2025, 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://download.java.net/java/early_access/jdk24/docs/api/java.desktop/java/awt/Image.html