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

FreeBSD Manual Pages

  
 
  

home | help
get_desktop_resolution(3)	 Allegro manual        get_desktop_resolution(3)

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  in-
     formation	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 res-
     olution. 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  vari-
     ables you provided for `width' and `height' are undefined.

SEE ALSO
     desktop_color_depth(3), set_gfx_mode(3)

Allegro 			  version 4.4.3        get_desktop_resolution(3)

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

home | help