java.awt.image

Класс VolatileImage

java.lang. Объект

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

java.awt.image. VolatileImage

Все Реализованные Интерфейсы:

Прозрачность

public abstract class VolatileImage
extends Image
implements Transparency

VolatileImage является изображением, которое может потерять его содержание в любое время из-за обстоятельств вне управления приложения (например, ситуации, вызванные операционной системой или другими приложениями). Из-за потенциала для аппаратного ускорения у объекта VolatileImage могут быть существенные выигрыши в производительности на некоторых платформах.

Поверхность рисунка изображения (память, где содержание изображения фактически находится) может быть потеряна или лишена законной силы, вызывая содержание той памяти уйти. Поверхность рисунка таким образом должна быть восстановлена или воссоздана и содержание той поверхностной потребности, которая будет повторно представлена. VolatileImage обеспечивает интерфейс для того, чтобы он позволил пользователю обнаруживать эти проблемы и фиксировать их, когда они происходят.

Когда объект VolatileImage создается, ограниченные системные ресурсы, такие как видеопамять (VRAM) могут быть выделены, чтобы поддерживать изображение. Когда объект VolatileImage больше не используется, он может быть собран "мусор", и те системные ресурсы будут возвращены, но этот процесс не происходит в гарантируемые времена. Приложения, которые создают много объектов VolatileImage (например, окно изменения размеров может вызвать воссоздание своего заднего буфера как размер, изменяются), может исчерпать оптимальные системные ресурсы для новых объектов VolatileImage просто, потому что старые объекты еще не были удалены из системы. (Новые объекты VolatileImage могут все еще быть созданы, но они, возможно, не выполняют так же как создаваемые в ускоренной памяти). Метод сброса можно вызвать в любое время, чтобы заранее высвободить средства, используемые VolatileImage так, чтобы он не препятствовал последующим объектам VolatileImage быть ускоренным. Таким образом приложения могут иметь больше контроля над состоянием ресурсов, приведенных в рабочее состояние устаревшими объектами VolatileImage.

Это изображение не должно быть разделено на подклассы непосредственно, но должно быть создано при использовании Component.createVolatileImage или GraphicsConfiguration.createCompatibleVolatileImage(int, int) методы.

Пример использования объекта VolatileImage следует:

 // image creation
 VolatileImage vImg = createVolatileImage(w, h);


 // rendering to the image
 void renderOffscreen() {
      do {
          if (vImg.validate(getGraphicsConfiguration()) ==
              VolatileImage.IMAGE_INCOMPATIBLE)
          {
              // old vImg doesn't work with new GraphicsConfig; re-create it
              vImg = createVolatileImage(w, h);
          }
          Graphics2D g = vImg.createGraphics();
          //
          // miscellaneous rendering commands...
          //
          g.dispose();
      } while (vImg.contentsLost());
 }


 // copying from the image (here, gScreen is the Graphics
 // object for the onscreen window)
 do {
      int returnCode = vImg.validate(getGraphicsConfiguration());
      if (returnCode == VolatileImage.IMAGE_RESTORED) {
          // Contents need to be restored
          renderOffscreen();      // restore contents
      } else if (returnCode == VolatileImage.IMAGE_INCOMPATIBLE) {
          // old vImg doesn't work with new GraphicsConfig; re-create it
          vImg = createVolatileImage(w, h);
          renderOffscreen();
      }
      gScreen.drawImage(vImg, 0, 0, this);
 } while (vImg.contentsLost());
 

Отметьте, что этот class разделяет на подклассы от Image class, который включает методы, которые берут ImageObserver параметр для асинхронных уведомлений как информация получается от потенциала ImageProducer. Начиная с этого VolatileImage не загружается из асинхронного источника, различные методы, которые берут ImageObserver параметр будет вести себя, как будто данные были уже получены из ImageProducer. Определенно, это означает, что возвращаемые значения от таких методов никогда не будут указывать, что информация еще не доступна и ImageObserver используемый в таких методах никогда не должен будет записываться для асинхронного уведомления об обратном вызове.

С тех пор:

1.4

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

Поля

Модификатор и Тип	Поле и Описание
static int	IMAGE_INCOMPATIBLE Проверенное изображение является несовместимым с предоставленным GraphicsConfiguration возразите и должен быть воссоздан как соответствующий.
static int	IMAGE_OK Проверенное изображение готово использовать как есть.
static int	IMAGE_RESTORED Проверенное изображение было восстановлено и теперь готово использовать.
protected int	прозрачность Значение прозрачности, с которым создавалось это изображение.

Поля, наследованные от class java.awt. Изображение

accelerationPriority, SCALE_AREA_AVERAGING, SCALE_DEFAULT, SCALE_FAST, SCALE_REPLICATE, SCALE_SMOOTH, UndefinedProperty

Поля, наследованные от интерфейса java.awt. Прозрачность

BITMASK, OPAQUE, TRANSLUCENT

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

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

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

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

Модификатор и Тип	Метод и Описание
abstract boolean	contentsLost() Возвраты true если рендеринг данных был потерян с тех пор последний validate вызвать.
abstract Graphics2D	createGraphics() Создает a Graphics2D, который может использоваться, чтобы вовлечь это VolatileImage.
abstract ImageCapabilities	getCapabilities() Возвращает объект ImageCapabilities, который может быть запрошен относительно определенных возможностей этого VolatileImage.
Графика	getGraphics() Этот метод возвращает a Graphics2D, но здесь для назад совместимости.
abstract int	getHeight() Возвращает height VolatileImage.
abstract BufferedImage	getSnapshot() Возвращает статическое изображение снимка этого объекта.
ImageProducer	getSource() Это возвращает ImageProducer для этого VolatileImage.
int	getTransparency() Возвращает прозрачность.
abstract int	getWidth() Возвращает width VolatileImage.
abstract int	validate(GraphicsConfiguration gc) Попытки восстановить поверхность рисунка изображения, если поверхность была потеряна начиная с последнего validate вызвать.

Методы, наследованные от class java.awt. Изображение

flush, getAccelerationPriority, getCapabilities, getHeight, getProperty, getScaledInstance, getWidth, setAccelerationPriority

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

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Полевая Деталь

IMAGE_OK

public static final int IMAGE_OK

Проверенное изображение готово использовать как есть.

См. Также:

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

IMAGE_RESTORED

public static final int IMAGE_RESTORED

Проверенное изображение было восстановлено и теперь готово использовать. Отметьте, что восстановление заставляет содержание изображения быть потерянным.

См. Также:

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

IMAGE_INCOMPATIBLE

public static final int IMAGE_INCOMPATIBLE

Проверенное изображение является несовместимым с предоставленным GraphicsConfiguration возразите и должен быть воссоздан как соответствующий. Использование изображения как есть после получения этого кода возврата от validate неопределено.

См. Также:

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

прозрачность

protected int transparency

Значение прозрачности, с которым создавалось это изображение.

С тех пор:

1.5

См. Также:

GraphicsConfiguration.createCompatibleVolatileImage(int, int,int), GraphicsConfiguration.createCompatibleVolatileImage(int, int,ImageCapabilities,int), Transparency

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

VolatileImage

public VolatileImage()

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

getSnapshot

public abstract BufferedImage getSnapshot()

Возвращает статическое изображение снимка этого объекта. BufferedImage возвращенный является только текущим с VolatileImage во время запроса и не будет обновлен ни с какими изменениями будущего к VolatileImage.

Возвраты:

a BufferedImage представление этого VolatileImage

См. Также:

BufferedImage

getWidth

public abstract int getWidth()

Возвращает width VolatileImage.

Возвраты:

width этого VolatileImage.

getHeight

public abstract int getHeight()

Возвращает height VolatileImage.

Возвраты:

height этого VolatileImage.

getSource

public ImageProducer getSource()

Это возвращает ImageProducer для этого VolatileImage. Отметьте, что объект VolatileImage оптимизируется для того, чтобы представить операции и блитировать на экран или другие объекты VolatileImage, в противоположность чтению назад пикселей изображения. Поэтому, операции такой как getSource возможно, не выполняет с такой скоростью, как операции, которые не полагаются на чтение пикселей. Отметьте также, что пиксельные значения, считанные из изображения, являются текущими с теми в изображении только в то время, когда они получаются. Этот метод берет снимок изображения в то время, когда с просьбой обращаются и объект ImageProducer возвращенные работы с тем статическим изображением снимка, не исходный VolatileImage. Вызов getSource () эквивалентен вызову getSnapshot ().getSource ().

Определенный:

getSource в class Image

Возвраты:

ImageProducer это может использоваться, чтобы произвести пиксели для a BufferedImage представление этого Изображения.

См. Также:

ImageProducer, getSnapshot()

getGraphics

public Graphics getGraphics()

Этот метод возвращает a Graphics2D, но здесь для назад совместимости. createGraphics более удобно, так как это, как объявляют, возвращает a Graphics2D.

Определенный:

getGraphics в class Image

Возвраты:

a Graphics2D, который может использоваться, чтобы вовлечь это изображение.

См. Также:

Graphics, Component.createImage(int, int)

createGraphics

public abstract Graphics2D createGraphics()

Создает a Graphics2D, который может использоваться, чтобы вовлечь это VolatileImage.

Возвраты:

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

проверить

public abstract int validate(GraphicsConfiguration gc)

Попытки восстановить поверхность рисунка изображения, если поверхность была потеряна начиная с последнего validate вызвать. Также проверяет этого изображения против данного параметра GraphicsConfiguration, чтобы видеть, являются ли операции от этого изображения до GraphicsConfiguration совместимыми. Примером несовместимой комбинации могла бы быть ситуация, где объект VolatileImage создавался на одном графическом устройстве и затем использовался, чтобы представить к различному графическому устройству. Так как объекты VolatileImage имеют тенденцию быть очень специфичными для устройства, эта работа не могла бы работать как предназначено, таким образом, код возврата от этого проверяет вызова, отметил бы что несовместимость. Нулевое или неправильное значение для gc может заставить неправильные значения быть возвращенными из validate и может вызвать более поздние проблемы с рендерингом.

Параметры:

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

Возвраты:

IMAGE_OK если изображение не нуждалось в проверке допустимости
IMAGE_RESTORED если изображение необходимое восстановление. Восстановление подразумевает, что на содержание изображения, возможно, влияли, и изображение, возможно, должно быть повторно представлено.
IMAGE_INCOMPATIBLE если изображение является несовместимым с GraphicsConfiguration объект, который передают в validate метод. Несовместимость подразумевает, что изображение, возможно, должно быть воссоздано с новым Component или GraphicsConfiguration чтобы получить изображение, которое может использоваться успешно с этим GraphicsConfiguration. Несовместимое изображение не проверяется на то, было ли восстановление необходимо, таким образом, состояние изображения неизменно после возвращаемого значения IMAGE_INCOMPATIBLE и это возвращаемое значение ничего не подразумевает о том, должно ли изображение быть восстановлено.

См. Также:

GraphicsConfiguration, Component, IMAGE_OK, IMAGE_RESTORED, IMAGE_INCOMPATIBLE

contentsLost

public abstract boolean contentsLost()

Возвраты true если рендеринг данных был потерян с тех пор последний validate вызвать. Этот метод должно вызвать приложение в конце любого ряда рендеринга операций к или от изображения, чтобы видеть, должно ли изображение быть проверено и сделанный заново рендеринг.

Возвраты:

true если поверхность рисунка должна быть восстановлена; false иначе.

getCapabilities

public abstract ImageCapabilities getCapabilities()

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

Возвраты:

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

С тех пор:

1.4

getTransparency

public int getTransparency()

Возвращает прозрачность. Возвраты или НЕПРОЗРАЧНАЯ, БИТОВАЯ МАСКА, или ПОЛУПРОЗРАЧНЫЙ.

Определенный:

getTransparency в интерфейсе Transparency

Возвраты:

прозрачность этого VolatileImage.

С тех пор:

1.5

См. Также:

Transparency.OPAQUE, Transparency.BITMASK, Transparency.TRANSLUCENT