1request_refresh_rate(3)         Allegro manual         request_refresh_rate(3)
2
3
4

NAME

6       request_refresh_rate  - Requests a specific refresh rate during graphic
7       mode switch. Allegro game programming library.
8

SYNOPSIS

10       #include <allegro.h>
11
12
13       void request_refresh_rate(int rate);
14

DESCRIPTION

16       Requests that the next call to set_gfx_mode() try to use the  specified
17       refresh  rate, if possible. Not all drivers are able to control this at
18       all, and even when they can, not all rates  will  be  possible  on  all
19       hardware,  so  the  actual settings may differ from what you requested.
20       After you call set_gfx_mode(), you can use get_refresh_rate()  to  find
21       out  what was actually selected. At the moment only the DOS VESA 3.0, X
22       DGA 2.0 and some Windows DirectX drivers  support  this  function.  The
23       speed  is  specified in Hz, eg. 60, 70. To return to the normal default
24       selection, pass a rate value of zero. Example:
25
26          request_refresh_rate(60);
27          if (set_gfx_mode(GFX_AUTODETECT, 640, 480, 0, 0) != 0)
28             abort_on_error("Couldn't set graphic mode!");
29          if (get_refresh_rate() != 60)
30             abort_on_error("Couldn't set refresh rate to 60Hz!");
31
32

SEE ALSO

34       set_gfx_mode(3), get_refresh_rate(3)
35
36
37
38Allegro                          version 4.2.3         request_refresh_rate(3)
Impressum