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