java.awt

Изображение класса

java.lang. Объект

java.awt. Изображение

Прямые Известные Подклассы:

BufferedImage, VolatileImage

public abstract class Image
extends Object

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

С тех пор:

JDK1.0

Полевая Сводка

Поля

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

Сводка конструктора

Конструкторы

Конструктор и Описание
Image()

Сводка метода

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

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

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

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

С тех пор:

JDK1.1

См. Также:

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

SCALE_FAST

public static final int SCALE_FAST

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

С тех пор:

JDK1.1

См. Также:

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

SCALE_SMOOTH

public static final int SCALE_SMOOTH

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

С тех пор:

JDK1.1

См. Также:

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

SCALE_REPLICATE

public static final int SCALE_REPLICATE

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

С тех пор:

JDK1.1

См. Также:

ReplicateScaleFilter, Постоянные Значения полей

SCALE_AREA_AVERAGING

public static final int SCALE_AREA_AVERAGING

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

С тех пор:

JDK1.1

См. Также:

AreaAveragingScaleFilter, Постоянные Значения полей

Деталь конструктора

Изображение

public Image()

Деталь метода

getWidth

public abstract int getWidth(ImageObserver observer)

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

Параметры:

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

Возвраты:

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

См. Также:

getHeight(java.awt.image.ImageObserver), ImageObserver

getHeight

public abstract int getHeight(ImageObserver observer)

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

Параметры:

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

Возвраты:

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

См. Также:

getWidth(java.awt.image.ImageObserver), ImageObserver

getSource

public abstract ImageProducer getSource()

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

Возвраты:

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

См. Также:

ImageProducer

getGraphics

public abstract Graphics getGraphics()

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

Возвраты:

графический контекст, чтобы потянуть к внеэкранному изображению.

Броски:

UnsupportedOperationException - если требующийся невнеэкранное изображение.

См. Также:

Graphics, Component.createImage(int, int)

getProperty

public abstract Object getProperty(String name,
                                   ImageObserver observer)

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

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

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

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

Параметры:

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

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

Возвраты:

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

Броски:

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

См. Также:

ImageObserver, UndefinedProperty

getScaledInstance

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

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

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

Параметры:

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

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

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

Возвраты:

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

Броски:

IllegalArgumentException - если width или height нуль.

С тех пор:

JDK1.1

См. Также:

SCALE_DEFAULT, SCALE_FAST, SCALE_SMOOTH, SCALE_REPLICATE, SCALE_AREA_AVERAGING

сброс

public void flush()

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

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

• Объекты BufferedImage оставляют основной Растр, который хранит их нетронутые пиксели, но сбросьте любую информацию, кэшируемую о тех пикселях, таких как копии, загруженные на аппаратные средства дисплея для ускоренных копирований битового массива.
• Объекты изображения, создаваемые методами Component, которые берут width и height, оставляют свой основной буфер пикселей нетронутым, но все кэшировались, информация, выпущенная очень как, делается для объектов BufferedImage.
• Объекты VolatileImage высвобождают все свои пиксельные средства включая их основную копию, которая обычно сохранена на аппаратных средствах дисплея, где ресурсы недостаточны. Эти объекты могут позже быть восстановлены, используя их validate метод.
• Объекты изображения, создаваемые классами Инструментария и Компонента, которые загружаются из файлов, URL или производятся ImageProducer разгружаются и все локальные средства высвобождаются. Эти объекты могут позже быть перезагружены от их первоисточника как необходимый, когда они представляются, так же, как, когда они сначала создавались.

getCapabilities

public ImageCapabilities getCapabilities(GraphicsConfiguration gc)

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

Параметры:

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

Возвраты:

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

С тех пор:

1.5

См. Также:

VolatileImage.getCapabilities()

setAccelerationPriority

public void setAccelerationPriority(float priority)

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

Параметры:

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

Броски:

IllegalArgumentException - если priority меньше чем нуль или больше чем 1.

С тех пор:

1.5

getAccelerationPriority

public float getAccelerationPriority()

Возвращает текущую стоимость ускоряющей приоритетной подсказки.

Возвраты:

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

С тех пор:

1.5

См. Также:

setAccelerationPriority