Класс 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)`	Задает подсказку для этого изображения о важности аппаратного ускорения.

Методы, объявленные в классе 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

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

Начиная с:

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, созданные методами 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

См. также:

setAccelerationPriority

public void setAccelerationPriority(float priority)

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

Параметры:: priority — значение от 0 до 1 включительно; более высокие значения указывают на большую важность ускорения. Значение 0 означает, что для этого объекта Image ускорение никогда не должно использоваться. Другие значения применяются только для определения приоритета ускорения относительно других объектов Image.
Выбрасывает:: IllegalArgumentException — если priority меньше нуля или больше 1.
Начиная с:: 1.5

getAccelerationPriority

public float getAccelerationPriority()

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

Возвращает:

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

Начиная с:

1.5

См. также:

© 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://docs.oracle.com/en/java/javase/25/docs/api/java.desktop/java/awt/Image.html