Класс 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).

С тех пор:: 1.5

UndefinedProperty

public static final Object UndefinedProperty

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

SCALE_DEFAULT

public static final int SCALE_DEFAULT

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

С тех пор:

1.1

См. также:

SCALE_FAST

public static final int SCALE_FAST

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

С тех пор:

1.1

См. также:

SCALE_SMOOTH

public static final int SCALE_SMOOTH

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

С тех пор:

1.1

См. также:

SCALE_REPLICATE

public static final int SCALE_REPLICATE

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

С тех пор:

1.1

См. также:

SCALE_AREA_AVERAGING

public static final int SCALE_AREA_AVERAGING

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

С тех пор:

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 равны нулю.

С тех пор:

1.1

См. также:

flush

public void flush()

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

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

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

getCapabilities

public ImageCapabilities getCapabilities(GraphicsConfiguration gc)

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

Параметры:

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

Возвращает:

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

С:

1.5

См. также:

setAccelerationPriority

public void setAccelerationPriority(float priority)

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

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

getAccelerationPriority

public float getAccelerationPriority()

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

Возвращает:

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

С:

1.5

См. также:

© 1993, 2023, 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/21/docs/api/java.desktop/java/awt/Image.html