1al_flip_display(3)                                          al_flip_display(3)
2
3
4

NAME

6       al_flip_display - Allegro 5 API
7

SYNOPSIS

9              #include <allegro5/allegro.h>
10
11              void al_flip_display(void)
12

DESCRIPTION

14       Copies  or  updates  the  front  and back buffers so that what has been
15       drawn previously on the currently selected display becomes  visible  on
16       screen.   Pointers  to  the special back buffer bitmap remain valid and
17       retain their semantics as the back buffer, although  the  contents  may
18       have changed.
19
20              Note:  If  not using the ALLEGRO_SINGLE_BUFFER option, you typi‐
21              cally want to redraw every pixel of  the  backbuffer  bitmap  to
22              avoid uninitialized memory artifacts.
23
24       Several display options change how this function behaves:
25
26       • With  ALLEGRO_SINGLE_BUFFER,  no flipping is done.  You still have to
27         call this function to display graphics, depending  on  how  the  used
28         graphics system works.
29
30       • The  ALLEGRO_SWAP_METHOD option may have additional information about
31         what kind of operation is used internally to flip the front and  back
32         buffers.
33
34       • If  ALLEGRO_VSYNC  is  1, this function will force waiting for vsync.
35         If ALLEGRO_VSYNC is 2, this function will not wait for  vsync.   With
36         many drivers the vsync behavior is controlled by the user and not the
37         application,  and  ALLEGRO_VSYNC  will  not  be  set;  in  this  case
38         al_flip_display(3)  will wait for vsync depending on the settings set
39         in the system’s graphics preferences.
40

SEE ALSO

42       al_set_new_display_flags(3), al_set_new_display_option(3)
43
44
45
46Allegro reference manual                                    al_flip_display(3)
Impressum