debian man page for get_gfx_mode_list

get_gfx_mode_list(3alleg4)					  Allegro manual					get_gfx_mode_list(3alleg4)

NAME
       get_gfx_mode_list - Obtains a list of available video modes. Allegro game programming library.

SYNOPSIS
       #include <allegro.h>

       GFX_MODE_LIST *get_gfx_mode_list(int card);

DESCRIPTION
       Attempts  to  create a list of all the supported video modes for a certain graphics driver, made up from the GFX_MODE_LIST structure, which
       has the following definition:

	  typedef struct GFX_MODE_LIST
	  {
	     int num_modes;
	     GFX_MODE *mode;
	  } GFX_MODE_LIST;

       The mode entry  points to the actual list of video modes.

	  typedef struct GFX_MODE
	  {
	     int width, height, bpp;
	  } GFX_MODE;

       This list of video modes is terminated with an { 0, 0, 0 } entry.

       Note that the card parameter must refer to a _real_ driver. This function fails if you pass GFX_SAFE, GFX_AUTODETECT, or any other  "magic"
       driver.

RETURN VALUE
       Returns a pointer to a list structure of the type GFX_MODE_LIST or NULL if the request could not be satisfied.

SEE ALSO
       destroy_gfx_mode_list(3alleg4), set_gfx_mode(3alleg4), set_color_depth(3alleg4)

Allegro 							   version 4.4.2					get_gfx_mode_list(3alleg4)