request_scroll(3alleg4) [suse man page]

request_scroll(3alleg4)                                           Allegro manual                                           request_scroll(3alleg4)

NAME

       request_scroll - Queues a hardware scroll request with triple buffering. Allegro game programming library.

SYNOPSIS

       #include <allegro.h>

       int request_scroll(int x, int y);

DESCRIPTION

       This  function  is  used for triple buffering. It requests a hardware scroll to the specified position, but returns immediately rather than
       waiting for a retrace. The scroll will then take place during the next vertical retrace, but you can carry on running  other  code  in  the
       meantime and use the poll_scroll() routine to detect when the flip has actually taken place.

       Triple  buffering  is only possible with certain drivers: you can look at the GFX_CAN_TRIPLE_BUFFER bit in the gfx_capabilities flag to see
       if it will work with the current driver.

RETURN VALUE

       This function returns zero on success, non-zero otherwise.

SEE ALSO

       poll_scroll(3alleg4), request_video_bitmap(3alleg4), gfx_capabilities(3alleg4), scroll_screen(3alleg4)

Allegro                                                            version 4.4.2                                           request_scroll(3alleg4)

request_video_bitmap(3alleg4)					  Allegro manual				     request_video_bitmap(3alleg4)

NAME

       request_video_bitmap - Triple buffering page flip request. Allegro game programming library.

SYNOPSIS

       #include <allegro.h>

       int request_video_bitmap(BITMAP *bitmap);

DESCRIPTION

       This  function  is used for triple buffering. It requests a page flip to display the specified video bitmap object, but returns immediately
       rather than waiting for a retrace. The flip will then take place during the next vertical retrace, but you can carry on running other  code
       in  the	meantime  and use the poll_scroll() routine to detect when the flip has actually taken place. Triple buffering is only possible on
       certain hardware: see the comments about request_scroll(). Example:

	  int current_page;
	  BITMAP *video_page[3];
	  ...
	  /* Create pages for page flipping */
	  video_page[0] = create_video_bitmap(SCREEN_W, SCREEN_H);
	  video_page[1] = create_video_bitmap(SCREEN_W, SCREEN_H);
	  video_page[2] = create_video_bitmap(SCREEN_W, SCREEN_H);
	  current_page = 0;
	  ...
	  /* draw the screen and flip pages */
	  draw_screen(video_page[current_page]);
	  do {
	  } while (poll_scroll());
	  request_video_bitmap(video_page[current_page]);
	  current_page = (current_page+1)%3;
	  ...

RETURN VALUE

       Returns zero on success and non-zero on failure.

SEE ALSO

       poll_scroll(3alleg4),	request_scroll(3alleg4),    gfx_capabilities(3alleg4),	  create_video_bitmap(3alleg4),    scroll_screen(3alleg4),
       ex3buf(3alleg4), exupdate(3alleg4)

Allegro 							   version 4.4.2				     request_video_bitmap(3alleg4)