Module java.desktop
Package java.awt

Class Component.FlipBufferStrategy

    • Field Detail

      • numBuffers

        protected int numBuffers
        The number of buffers
      • drawBuffer

        protected Image drawBuffer
        The drawing buffer
      • drawVBuffer

        protected VolatileImage drawVBuffer
        The drawing buffer as a volatile image
      • validatedContents

        protected boolean validatedContents
        Whether or not the drawing buffer has been recently restored from a lost state.
    • Method Detail

      • createBuffers

        protected void createBuffers​(int numBuffers,
                                     BufferCapabilities caps)
                              throws AWTException
        Creates 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.isPageFlipping must 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.isPageFlipping is not true.
        See Also:
        BufferCapabilities.isPageFlipping()
      • getBackBuffer

        protected Image getBackBuffer​()
        Returns:
        direct access to the back buffer, as an image.
        Throws:
        IllegalStateException - if the buffers have not yet been created
      • flip

        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.
        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.FlipContents property.
        Throws:
        IllegalStateException - if the buffers have not yet been created
        See Also:
        BufferCapabilities.getFlipContents()
      • destroyBuffers

        protected void destroyBuffers​()
        Destroys the buffers created through this object
      • getDrawGraphics

        public Graphics getDrawGraphics​()
        Description copied from class: 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.
        Specified by:
        getDrawGraphics in 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.
      • revalidate

        protected void revalidate​()
        Restore the drawing buffer if it has been lost
      • contentsLost

        public boolean contentsLost​()
        Description copied from class: BufferStrategy
        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.
        Specified by:
        contentsLost in class BufferStrategy
        Returns:
        whether the drawing buffer was lost since the last call to getDrawGraphics
        See Also:
        VolatileImage
      • contentsRestored

        public boolean contentsRestored​()
        Description copied from class: BufferStrategy
        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.
        Specified by:
        contentsRestored in class BufferStrategy
        Returns:
        whether the drawing buffer was recently restored from a lost state and reinitialized to the default background color (white)
        See Also:
        VolatileImage
      • show

        public void show​()
        Makes the next available buffer visible by either blitting or flipping.
        Specified by:
        show in class BufferStrategy