Provided by: allegro4-doc_4.4.3.1-3_all bug

NAME

       get_desktop_resolution  -  Finds  out  the  desktop  resolution.  Allegro game programming
       library.

SYNOPSIS

       #include <allegro.h>

       int get_desktop_resolution(int *width, int *height);

DESCRIPTION

       Finds out the currently selected desktop resolution. You can use this information to avoid
       creating  windows  bigger  than  the current resolution.  This is especially important for
       some windowed drivers which are unable to create windows bigger  than  the  desktop.  Each
       parameter is a pointer to an integer where one dimension of the screen will be stored.

       Under  some  OSes,  switching  to a full screen graphics mode may automatically change the
       desktop resolution. You have, therefore, to call this function before setting any graphics
       mode in order to retrieve the real desktop resolution. Example:

          int width, height;

          allegro_init();
          ...
          if (get_desktop_resolution(&width, &height) == 0) {
             /* Got the resolution correctly */
          }

RETURN VALUE

       Returns zero on success, or a negative number if this information is not available or does
       not apply, in which case the values stored in the variables you provided for  `width'  and
       `height' are undefined.

SEE ALSO

       desktop_color_depth(3alleg4), set_gfx_mode(3alleg4)