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)