Класс VolatileImage

public abstract class VolatileImage
extends Image
implements Transparency

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

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

При создании объекта VolatileImage могут быть выделены ограниченные системные ресурсы, такие как видеопамять (VRAM), для поддержки изображения. Когда объект VolatileImage больше не используется, он может быть собран сборщиком мусора, и эти системные ресурсы будут возвращены, но этот процесс не гарантируется. Приложения, создающие множество объектов VolatileImage (например, окно, изменяющее размер, может потребовать пересоздания буфера заднего плана при изменении размера), могут столкнуться с недостатком оптимальных системных ресурсов для новых объектов VolatileImage просто потому, что старые объекты ещё не были удалены из системы. (Новые объекты VolatileImage всё ещё могут быть созданы, но они могут работать не так эффективно, как объекты, созданные в ускоренной памяти). Метод flush можно вызывать в любой момент, чтобы активно освободить ресурсы, используемые объектом 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());

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