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.

       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)