Класс BufferStrategy

public abstract class BufferStrategy
extends Object

Класс BufferStrategy представляет механизм организации сложной памяти на конкретном Canvas или Window. Ограничения аппаратного и программного обеспечения определяют, может ли и как конкретная стратегия буферизации быть реализованой. Эти ограничения обнаруживаются через возможности GraphicsConfiguration используемого при создании Canvas или Window.

Стоит отметить, что термины буфер и поверхность предназначены быть синонимами: область непрерывной памяти, либо в памяти устройства видеовывода, либо в системной памяти.

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

В качестве альтернативы, содержимое заднего буфера может быть скопировано или скопировано вперёд в цепочке вместо перемещения указателя видео.

Double buffering:

                    ***********         ***********
                    *         * ------> *         *
 [To display] <---- * Front B *   Show  * Back B. * <---- Rendering
                    *         * <------ *         *
                    ***********         ***********

 Triple buffering:

 [To      ***********         ***********        ***********
 display] *         * --------+---------+------> *         *
    <---- * Front B *   Show  * Mid. B. *        * Back B. * <---- Rendering
          *         * <------ *         * <----- *         *
          ***********         ***********        ***********

Вот пример того, как можно создать и использовать стратегии буферизации:

// Check the capabilities of the GraphicsConfiguration
 ...

 // Create our component
 Window w = new Window(gc);

 // Show our window
 w.setVisible(true);

 // Create a general double-buffering strategy
 w.createBufferStrategy(2);
 BufferStrategy strategy = w.getBufferStrategy();

 // Main loop
 while (!done) {
     // Prepare for rendering the next frame
     // ...

     // Render single frame
     do {
         // The following loop ensures that the contents of the drawing buffer
         // are consistent in case the underlying surface was recreated
         do {
             // Get a new graphics context every time through the loop
             // to make sure the strategy is validated
             Graphics graphics = strategy.getDrawGraphics();

             // Render to graphics
             // ...

             // Dispose the graphics
             graphics.dispose();

             // Repeat the rendering if the drawing buffer contents
             // were restored
         } while (strategy.contentsRestored());

         // Display the buffer
         strategy.show();

         // Repeat the rendering if the drawing buffer was lost
     } while (strategy.contentsLost());
 }

 // Dispose the window
 w.setVisible(false);
 w.dispose();

Подробное описание конструкторов

BufferStrategy

public BufferStrategy()

Подробное описание методов

getCapabilities

public abstract BufferCapabilities getCapabilities()

Возвращает BufferCapabilities для этого BufferStrategy.

Возвращает:

возможности буферизации данной стратегии

getDrawGraphics

public abstract Graphics getDrawGraphics()

Создаёт контекст графики для буфера отрисовки. Этот метод может быть не синхронизирован для повышения производительности; использование этого метода несколькими потоками должно обрабатываться на уровне приложения. Утилизация объекта графики, полученного, должна обрабатываться приложением.

Возвращает:

контекст графики для буфера отрисовки

contentsLost

public abstract boolean contentsLost()

Возвращает, был ли буфер отрисовки утерян с момента последнего вызова getDrawGraphics. Поскольку буферы в стратегии буферизации обычно являются типа VolatileImage, они могут быть утеряны. Обсуждение утерянных буферов см. в VolatileImage.

Возвращает:

Был ли буфер отрисовки утерян с момента последнего вызова getDrawGraphics.

См. также:

VolatileImage

contentsRestored

public abstract boolean contentsRestored()

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

Возвращает:

Был ли буфер отрисовки восстановлен с момента последнего вызова getDrawGraphics.

См. также:

VolatileImage

show

public abstract void show()

Делает следующий доступный буфер видимым, либо копируя память (blitting), либо изменяя указатель дисплея (переключая).

dispose

public void dispose()

Освобождает системные ресурсы, в настоящее время используемые этим BufferStrategy, и удаляет его из связанного компонента. После вызова этого метода, getBufferStrategy вернёт null. Попытка использовать BufferStrategy после того, как он был утилизирован, приведёт к неопределённому поведению.

С:

1.6

См. также:

Window.createBufferStrategy(int), Canvas.createBufferStrategy(int), Window.getBufferStrategy(), Canvas.getBufferStrategy()