Provided by: allegro5-doc_5.2.8.0+dfsg-1_all bug

NAME

       al_flip_display - Allegro 5 API

SYNOPSIS

              #include <allegro5/allegro.h>

              void al_flip_display(void)

DESCRIPTION

       Copies or updates the front and back buffers so that what has been drawn previously on the
       currently selected display becomes visible on screen.  Pointers to the special back buffer
       bitmap  remain  valid and retain their semantics as the back buffer, although the contents
       may have changed.

              Note: If not using the ALLEGRO_SINGLE_BUFFER option, you typically want  to  redraw
              every pixel of the backbuffer bitmap to avoid uninitialized memory artifacts.

       Several display options change how this function behaves:

       • With  ALLEGRO_SINGLE_BUFFER,  no flipping is done.  You still have to call this function
         to display graphics, depending on how the used graphics system works.

       • The ALLEGRO_SWAP_METHOD option may  have  additional  information  about  what  kind  of
         operation is used internally to flip the front and back buffers.

       • If  ALLEGRO_VSYNC is 1, this function will force waiting for vsync.  If ALLEGRO_VSYNC is
         2, this function will not wait for vsync.  With  many  drivers  the  vsync  behavior  is
         controlled  by  the  user and not the application, and ALLEGRO_VSYNC will not be set; in
         this case al_flip_display(3alleg5) will wait for vsync depending on the settings set  in
         the system’s graphics preferences.

SEE ALSO

       al_set_new_display_flags(3alleg5), al_set_new_display_option(3alleg5)