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