java.lang.Object | ||
↳ | java.awt.image.BufferStrategy | |
↳ | java.awt.Component.FlipBufferStrategy |
Inner class for flipping buffers on a component. That component must
be a Canvas
or Window
.
Fields | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
caps | The buffering capabilities | ||||||||||
drawBuffer | The drawing buffer | ||||||||||
drawVBuffer | The drawing buffer as a volatile image | ||||||||||
numBuffers | The number of buffers | ||||||||||
validatedContents | Whether or not the drawing buffer has been recently restored from a lost state. |
Protected Constructors | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Creates a new flipping buffer strategy for this component.
|
Public Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Returns whether the drawing buffer was lost since the last call to
getDrawGraphics . | |||||||||||
Returns whether the drawing buffer was recently restored from a lost
state and reinitialized to the default background color (white).
| |||||||||||
Releases system resources currently consumed by this
BufferStrategy and
removes it from the associated Component. | |||||||||||
Returns the
BufferCapabilities for this
BufferStrategy . | |||||||||||
Creates a graphics context for the drawing buffer.
| |||||||||||
Makes the next available buffer visible by either blitting or
flipping.
|
Protected Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Creates one or more complex, flipping buffers with the given
capabilities.
| |||||||||||
Destroys the buffers created through this object
| |||||||||||
Flipping moves the contents of the back buffer to the front buffer,
either by copying or by moving the video pointer.
| |||||||||||
Restore the drawing buffer if it has been lost
|
[Expand]
Inherited Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
From class
java.awt.image.BufferStrategy
| |||||||||||
From class
java.lang.Object
|
The number of buffers
Whether or not the drawing buffer has been recently restored from a lost state.
Creates a new flipping buffer strategy for this component.
The component must be a Canvas
or Window
.
numBuffers | the number of buffers |
---|---|
caps | the capabilities of the buffers |
AWTException | if the capabilities supplied could not be supported or met |
---|---|
ClassCastException | if the component is not a canvas or window. |
Returns whether the drawing buffer was lost since the last call to
getDrawGraphics
. Since the buffers in a buffer strategy
are usually type VolatileImage
, they may become lost.
For a discussion on lost buffers, see VolatileImage
.
getDrawGraphics
Returns whether the drawing buffer was recently restored from a lost
state and reinitialized to the default background color (white).
Since the buffers in a buffer strategy are usually type
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
.
Releases system resources currently consumed by this
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.
Returns the BufferCapabilities
for this
BufferStrategy
.
Creates a graphics context for the drawing buffer. This method may not be synchronized for performance reasons; use of this method by multiple threads should be handled at the application level. Disposal of the graphics object obtained must be handled by the application.
Makes the next available buffer visible by either blitting or flipping.
Creates one or more complex, flipping buffers with the given capabilities.
numBuffers | number of buffers to create; must be greater than one |
---|---|
caps | the capabilities of the buffers.
BufferCapabilities.isPageFlipping must be
true . |
AWTException | if the capabilities supplied could not be supported or met |
---|---|
IllegalStateException | if the component has no peer |
IllegalArgumentException | if numBuffers is less than two,
or if BufferCapabilities.isPageFlipping is not
true . |
Destroys the buffers created through this object
Flipping moves the contents of the back buffer to the front buffer, either by copying or by moving the video pointer.
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 created |
---|
IllegalStateException | if the buffers have not yet been created |
---|
Restore the drawing buffer if it has been lost