Класс BufferStrategy
- Прямые известные подклассы:
-
Component.BltBufferStrategy,Component.FlipBufferStrategy
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();
- С момента:
- 1.4
- См. также:
Краткое описание конструкторов
| Модификатор | Конструктор | Описание |
|---|---|---|
protected |
Конструктор для вызова подклассами. |
Краткое описание методов
| Модификатор и тип | Метод | Описание |
|---|---|---|
abstract boolean |
contentsLost() |
Возвращает, был ли буфер отрисовки утерян с момента последнего вызова getDrawGraphics. |
abstract boolean |
contentsRestored() |
Возвращает, был ли буфер отрисовки недавно восстановлен из состояния потери и повторно инициализирован до стандартного цвета фона (белого). |
void |
dispose() |
Освобождает системные ресурсы, в настоящее время используемые этим BufferStrategy, и удаляет его из связанного компонента. |
abstract BufferCapabilities |
getCapabilities() |
Возвращает BufferCapabilities для этой BufferStrategy. |
abstract Graphics |
getDrawGraphics() |
Создаёт контекст графики для буфера отрисовки. |
abstract void |
show() |
Делает следующий доступный буфер видимым, копируя память (копирование) или изменяя указатель дисплея (переключение). |
Подробное описание конструкторов
BufferStrategy
protected BufferStrategy()
Подробное описание методов
getCapabilities
public abstract BufferCapabilities getCapabilities()
BufferCapabilities для этой BufferStrategy.- Возвращает:
- возможности буферизации этой стратегии
getDrawGraphics
public abstract Graphics getDrawGraphics()
- Возвращает:
- контекст графики для буфера отрисовки
contentsLost
public abstract boolean contentsLost()
getDrawGraphics. Поскольку буферы в стратегии буферизации обычно имеют тип VolatileImage, они могут быть утеряны. Для обсуждения потерянных буферов см. VolatileImage.- Возвращает:
- Буфер отрисовки был потерян с момента последнего вызова
getDrawGraphics. - См. также:
contentsRestored
public abstract boolean contentsRestored()
VolatileImage, они могут быть утеряны. Если поверхность была недавно восстановлена из состояния потери с момента последнего вызова getDrawGraphics, она может потребовать перерисовки. Для обсуждения потерянных буферов см. VolatileImage.- Возвращает:
- Буфер отрисовки был восстановлен с момента последнего вызова
getDrawGraphics. - См. также:
show
public abstract void show()
dispose
public void dispose()
BufferStrategy, и удаляет его из связанного компонента. После вызова этого метода getBufferStrategy вернёт null. Попытка использовать BufferStrategy после того, как он был удалён, приведёт к неопределённому поведению.- С момента:
- 1.6
- См. также:
© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://download.java.net/java/early_access/jdk24/docs/api/java.desktop/java/awt/image/BufferStrategy.html