Класс 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, используемые в таких методах, никогда не потребуется записывать для асинхронного уведомления о возврате.