Modifier and Type | Field and Description |
---|---|
protected BufferCapabilities |
caps
The buffering capabilities
|
protected Image |
drawBuffer
The drawing buffer
|
protected java.awt.image.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 and Description |
---|---|
protected |
Component.FlipBufferStrategy(int numBuffers,
BufferCapabilities caps)
Creates a new flipping buffer strategy for this component.
|
Modifier and Type | Method and 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(int numBuffers,
BufferCapabilities caps)
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(BufferCapabilities.FlipContents flipAction)
Flipping moves the contents of the back buffer to the front buffer,
either by copying or by moving the video pointer.
|
protected Image |
getBackBuffer()
|
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.
|
Canvas
or Window
.numBuffers
- the number of bufferscaps
- the capabilities of the buffersAWTException
- if the capabilities supplied could not be
supported or metjava.lang.ClassCastException
- if the component is not a canvas or
window.java.lang.IllegalStateException
- if the component has no peerjava.lang.IllegalArgumentException
- if numBuffers
is less than two,
or if BufferCapabilities.isPageFlipping
is not
true
.Canvas
,
Window
,
createBuffers(int, BufferCapabilities)
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 metjava.lang.IllegalStateException
- if the component has no peerjava.lang.IllegalArgumentException
- if numBuffers is less than two,
or if BufferCapabilities.isPageFlipping
is not
true
.BufferCapabilities.isPageFlipping()
java.lang.IllegalStateException
- if the buffers have not yet
been createdflipAction
- 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.java.lang.IllegalStateException
- if the buffers have not yet
been createdBufferCapabilities.getFlipContents()
java.awt.image.BufferStrategy
BufferCapabilities
for this
BufferStrategy
.getCapabilities
in class java.awt.image.BufferStrategy
java.awt.image.BufferStrategy
getDrawGraphics
in class java.awt.image.BufferStrategy
java.awt.image.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 java.awt.image.BufferStrategy
getDrawGraphics
VolatileImage
java.awt.image.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 java.awt.image.BufferStrategy
VolatileImage
show
in class java.awt.image.BufferStrategy
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 java.awt.image.BufferStrategy
Window.createBufferStrategy(int)
,
Canvas.createBufferStrategy(int)
,
Window.getBufferStrategy()
,
Canvas.getBufferStrategy()