Class Component.FlipBufferStrategy
java.lang.Object
java.awt.image.BufferStrategy
java.awt.Component.FlipBufferStrategy
- Enclosing class:
- Component
Inner class for flipping buffers on a component.  That component must
 be a 
Canvas or Window or Applet.- Since:
- 1.4
- See Also:
- 
Field SummaryFieldsModifier and TypeFieldDescriptionprotected BufferCapabilitiesThe buffering capabilitiesprotected ImageThe drawing bufferprotected VolatileImageThe drawing buffer as a volatile imageprotected intThe number of buffersprotected booleanWhether or not the drawing buffer has been recently restored from a lost state.
- 
Constructor SummaryConstructorsModifierConstructorDescriptionprotectedFlipBufferStrategy(int numBuffers, BufferCapabilities caps) Creates a new flipping buffer strategy for this component.
- 
Method SummaryModifier and TypeMethodDescriptionbooleanReturns whether the drawing buffer was lost since the last call togetDrawGraphics.booleanReturns whether the drawing buffer was recently restored from a lost state and reinitialized to the default background color (white).protected voidcreateBuffers(int numBuffers, BufferCapabilities caps) Creates one or more complex, flipping buffers with the given capabilities.protected voidDestroys the buffers created through this objectvoiddispose()Releases system resources currently consumed by thisBufferStrategyand removes it from the associated Component.protected voidflip(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 ImageProvides direct access to the back buffer as an image.Returns theBufferCapabilitiesfor thisBufferStrategy.Creates a graphics context for the drawing buffer.protected voidRestore the drawing buffer if it has been lostvoidshow()Makes the next available buffer visible by either blitting or flipping.
- 
Field Details- 
numBuffersprotected int numBuffersThe number of buffers
- 
capsThe buffering capabilities
- 
drawBufferThe drawing buffer
- 
drawVBufferThe drawing buffer as a volatile image
- 
validatedContentsprotected boolean validatedContentsWhether or not the drawing buffer has been recently restored from a lost state.
 
- 
- 
Constructor Details- 
FlipBufferStrategyCreates a new flipping buffer strategy for this component. The component must be aCanvasorWindoworApplet.- Parameters:
- numBuffers- the number of buffers
- caps- the capabilities of the buffers
- Throws:
- AWTException- if the capabilities supplied could not be supported or met
- ClassCastException- if the component is not a canvas or window.
- IllegalStateException- if the component has no peer
- IllegalArgumentException- if- numBuffersis less than two, or if- BufferCapabilities.isPageFlippingis not- true.
- See Also:
 
 
- 
- 
Method Details- 
createBuffersCreates one or more complex, flipping buffers with the given capabilities.- Parameters:
- numBuffers- number of buffers to create; must be greater than one
- caps- the capabilities of the buffers.- BufferCapabilities.isPageFlippingmust be- true.
- Throws:
- 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.isPageFlippingis not- true.
- See Also:
 
- 
getBackBufferProvides direct access to the back buffer as an image.- Returns:
- the back buffer as an image
- Throws:
- IllegalStateException- if the buffers have not yet been created
 
- 
flipFlipping moves the contents of the back buffer to the front buffer, either by copying or by moving the video pointer.- Parameters:
- 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.FlipContentsproperty.
- Throws:
- IllegalStateException- if the buffers have not yet been created
- See Also:
 
- 
destroyBuffersprotected void destroyBuffers()Destroys the buffers created through this object
- 
getCapabilitiesDescription copied from class:BufferStrategyReturns theBufferCapabilitiesfor thisBufferStrategy.- Specified by:
- getCapabilitiesin class- BufferStrategy
- Returns:
- the buffering capabilities of this strategy
 
- 
getDrawGraphicsDescription copied from class:BufferStrategyCreates 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.- Specified by:
- getDrawGraphicsin class- BufferStrategy
- Returns:
- the graphics on 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 must be handled by the application.
 
- 
revalidateprotected void revalidate()Restore the drawing buffer if it has been lost
- 
contentsLostpublic boolean contentsLost()Description copied from class:BufferStrategyReturns whether the drawing buffer was lost since the last call togetDrawGraphics. Since the buffers in a buffer strategy are usually typeVolatileImage, they may become lost. For a discussion on lost buffers, seeVolatileImage.- Specified by:
- contentsLostin class- BufferStrategy
- Returns:
- whether the drawing buffer was lost since the last call to
 getDrawGraphics
- See Also:
 
- 
contentsRestoredpublic boolean contentsRestored()Description copied from class:BufferStrategyReturns 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 typeVolatileImage, they may become lost. If a surface has been recently restored from a lost state since the last call togetDrawGraphics, it may require repainting. For a discussion on lost buffers, seeVolatileImage.- Specified by:
- contentsRestoredin class- BufferStrategy
- Returns:
- whether the drawing buffer was recently restored from a lost state and reinitialized to the default background color (white)
- See Also:
 
- 
showpublic void show()Makes the next available buffer visible by either blitting or flipping.- Specified by:
- showin class- BufferStrategy
 
- 
disposepublic void dispose()Releases system resources currently consumed by thisBufferStrategyand removes it from the associated Component. After invoking this method,getBufferStrategywill return null. Trying to use aBufferStrategyafter it has been disposed will result in undefined behavior.- Overrides:
- disposein class- BufferStrategy
- Since:
- 1.6
- See Also:
 
 
-