Component
protected class Component.FlipBufferStrategy extends BufferStrategy
Canvas
or Window
or Applet
.Modifier and Type | Field | Description |
---|---|---|
protected BufferCapabilities |
caps |
The buffering capabilities |
protected Image |
drawBuffer |
The drawing buffer |
protected VolatileImage |
drawVBuffer |
The drawing buffer as a volatile image |
protected int |
numBuffers |
The number of buffers |
protected boolean |
validatedContents |
Whether or not the drawing buffer has been recently restored from a lost state. |
Modifier | Constructor | Description |
---|---|---|
protected |
Creates a new flipping buffer strategy for this component. |
Modifier and Type | Method | Description |
---|---|---|
boolean |
contentsLost() |
Returns whether the drawing buffer was lost since the last call to getDrawGraphics . |
boolean |
contentsRestored() |
Returns whether the drawing buffer was recently restored from a lost state and reinitialized to the default background color (white). |
protected void |
createBuffers |
Creates one or more complex, flipping buffers with the given capabilities. |
protected void |
destroyBuffers() |
Destroys the buffers created through this object |
void |
dispose() |
Releases system resources currently consumed by this BufferStrategy and removes it from the associated Component. |
protected void |
flip |
Flipping moves the contents of the back buffer to the front buffer, either by copying or by moving the video pointer. |
protected Image |
getBackBuffer() |
Provides direct access to the back buffer as an image. |
BufferCapabilities |
getCapabilities() |
Returns the BufferCapabilities for this BufferStrategy . |
Graphics |
getDrawGraphics() |
Creates a graphics context for the drawing buffer. |
protected void |
revalidate() |
Restore the drawing buffer if it has been lost |
void |
show() |
Makes the next available buffer visible by either blitting or flipping. |
protected int numBuffers
protected BufferCapabilities caps
protected Image drawBuffer
protected VolatileImage drawVBuffer
protected boolean validatedContents
protected FlipBufferStrategy(int numBuffers, BufferCapabilities caps) throws AWTException
Canvas
or Window
or Applet
.numBuffers
- the number of bufferscaps
- the capabilities of the buffersAWTException
- if the capabilities supplied could not be supported or metClassCastException
- if the component is not a canvas or window.IllegalStateException
- if the component has no peerIllegalArgumentException
- if numBuffers
is less than two, or if BufferCapabilities.isPageFlipping
is not true
.protected void createBuffers(int numBuffers, BufferCapabilities caps) throws AWTException
numBuffers
- number of buffers to create; must be greater than onecaps
- the capabilities of the buffers. BufferCapabilities.isPageFlipping
must be true
.AWTException
- if the capabilities supplied could not be supported or metIllegalStateException
- if the component has no peerIllegalArgumentException
- if numBuffers is less than two, or if BufferCapabilities.isPageFlipping
is not true
.protected Image getBackBuffer()
IllegalStateException
- if the buffers have not yet been createdprotected void flip(BufferCapabilities.FlipContents flipAction)
flipAction
- an integer value describing the flipping action for the contents of the back buffer. This should be one of the values of the BufferCapabilities.FlipContents
property.IllegalStateException
- if the buffers have not yet been createdprotected void destroyBuffers()
public BufferCapabilities getCapabilities()
BufferStrategy
BufferCapabilities
for this BufferStrategy
.getCapabilities
in class BufferStrategy
public Graphics getDrawGraphics()
BufferStrategy
getDrawGraphics
in class BufferStrategy
protected void revalidate()
public boolean contentsLost()
BufferStrategy
getDrawGraphics
. Since the buffers in a buffer strategy are usually type VolatileImage
, they may become lost. For a discussion on lost buffers, see VolatileImage
.contentsLost
in class BufferStrategy
getDrawGraphics
public boolean contentsRestored()
BufferStrategy
VolatileImage
, they may become lost. If a surface has been recently restored from a lost state since the last call to getDrawGraphics
, it may require repainting. For a discussion on lost buffers, see VolatileImage
.contentsRestored
in class BufferStrategy
public void show()
show
in class BufferStrategy
public void dispose()
BufferStrategy
and removes it from the associated Component. After invoking this method, getBufferStrategy
will return null. Trying to use a BufferStrategy
after it has been disposed will result in undefined behavior.dispose
in class BufferStrategy
© 1993, 2023, 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://docs.oracle.com/en/java/javase/21/docs/api/java.desktop/java/awt/Component.FlipBufferStrategy.html