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

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создает и возвращает копию этого объекта.
`boolean`	`equals(Object obj)`	Показывает, равен ли этот объект какому-либо другому объекту.
`protected void`	`finalize()`	Устарело, планируется удаление: этот элемент API может быть удален в будущей версии. Финализация объявлена устаревшей и может быть удалена в одном из будущих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого `Object`.
`int`	`hashCode()`	Возвращает значение хеш-кода для этого объекта.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`String`	`toString()`	Возвращает строковое представление объекта.
`final void`	`wait()`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt.
`final void`	`wait(long timeoutMillis)`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt, либо до истечения заданного промежутка реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt, либо до истечения заданного промежутка реального времени.

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

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 означает, что для этого изображения ускорение использоваться не должно. Другие значения используются только для определения приоритета ускорения относительно других изображений.
Вызывает исключение:: 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.