Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
al_flip_display(3)	    Library Functions Manual	      al_flip_display(3)

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 unini-
	    tialized 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 applica-
       tion, and ALLEGRO_VSYNC will not be set; in this case  al_flip_display(3)
       will  wait for vsync depending on the settings set in the system's graph-
       ics preferences.

SEE ALSO
     al_set_new_display_flags(3), al_set_new_display_option(3)

Allegro reference manual				      al_flip_display(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=al_flip_display&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>

home | help