Docjar: A Java Source and Docuemnt Enginecom.*    java.*    javax.*    org.*    all    new    plug-in

Quick Search    Search Deep

java.awt
Class Component.FlipBufferStrategy  view Component.FlipBufferStrategy download Component.FlipBufferStrategy.java

java.lang.Object
  extended byjava.awt.image.BufferStrategy
      extended byjava.awt.Component.FlipBufferStrategy
Direct Known Subclasses:
Canvas.CanvasFlipBufferStrategy, Window.WindowFlipBufferStrategy
Enclosing class:
Component

protected class Component.FlipBufferStrategy
extends java.awt.image.BufferStrategy

This class provides support for flipping component buffers. It can only be used on Canvases and Windows.

Since:
1.4

Field Summary
protected  BufferCapabilities caps
          The capabilities of this buffering strategy.
protected  Image drawBuffer
          An Image reference to the drawing buffer.
protected  java.awt.image.VolatileImage drawVBuffer
          A VolatileImage reference to the drawing buffer.
private  int height
          The height of the back buffer.
protected  int numBuffers
          The number of buffers.
protected  boolean validatedContents
          Whether or not the image buffer resources are allocated and ready to be drawn into.
private  int width
          The width of the back buffer.
 
Constructor Summary
protected Component.FlipBufferStrategy(int numBuffers, BufferCapabilities caps)
          Creates a flipping buffer strategy.
 
Method Summary
 boolean contentsLost()
          Returns whether or not the image buffer resources have been lost.
 boolean contentsRestored()
          Returns whether or not the image buffer resources have been restored.
protected  void createBuffers(int numBuffers, BufferCapabilities caps)
          Creates a multi-buffer flipping strategy.
protected  void destroyBuffers()
          Release the back buffer's resources.
protected  void flip(BufferCapabilities.FlipContents flipAction)
          Perform a flip operation to transfer the contents of the back buffer to the front buffer.
protected  Image getBackBuffer()
          Return a direct reference to the back buffer image.
 BufferCapabilities getCapabilities()
          Retrieves the capabilities of this buffer strategy.
 Graphics getDrawGraphics()
          Retrieves a graphics object that can be used to draw into this strategy's image buffer.
protected  void revalidate()
          Re-create the image buffer resources if they've been lost.
 void show()
          Bring the contents of the back buffer to the front buffer.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

numBuffers

protected int numBuffers
The number of buffers.


caps

protected BufferCapabilities caps
The capabilities of this buffering strategy.


drawBuffer

protected Image drawBuffer
An Image reference to the drawing buffer.


drawVBuffer

protected java.awt.image.VolatileImage drawVBuffer
A VolatileImage reference to the drawing buffer.


validatedContents

protected boolean validatedContents
Whether or not the image buffer resources are allocated and ready to be drawn into.


width

private int width
The width of the back buffer.


height

private int height
The height of the back buffer.

Constructor Detail

Component.FlipBufferStrategy

protected Component.FlipBufferStrategy(int numBuffers,
                                       BufferCapabilities caps)
                                throws AWTException
Creates a flipping buffer strategy. The only supported strategy for FlipBufferStrategy itself is a double-buffer page flipping strategy. It forms the basis for more complex derived strategies.

Method Detail

createBuffers

protected void createBuffers(int numBuffers,
                             BufferCapabilities caps)
                      throws AWTException
Creates a multi-buffer flipping strategy. The number of buffers must be greater than one and the buffer capabilities must specify page flipping.


getBackBuffer

protected Image getBackBuffer()
Return a direct reference to the back buffer image.


flip

protected void flip(BufferCapabilities.FlipContents flipAction)
Perform a flip operation to transfer the contents of the back buffer to the front buffer.


destroyBuffers

protected void destroyBuffers()
Release the back buffer's resources.


getCapabilities

public BufferCapabilities getCapabilities()
Retrieves the capabilities of this buffer strategy.


getDrawGraphics

public Graphics getDrawGraphics()
Retrieves a graphics object that can be used to draw into this strategy's image buffer.


revalidate

protected void revalidate()
Re-create the image buffer resources if they've been lost.


contentsLost

public boolean contentsLost()
Returns whether or not the image buffer resources have been lost.


contentsRestored

public boolean contentsRestored()
Returns whether or not the image buffer resources have been restored.


show

public void show()
Bring the contents of the back buffer to the front buffer.