.\" Generated by the Allegro makedoc utility
.TH get_gfx_mode_list 3alleg4 "version 4.4.2" "Allegro" "Allegro manual"
.SH NAME
get_gfx_mode_list \- Obtains a list of available video modes. Allegro game programming library.\&
.SH SYNOPSIS
.B #include <allegro.h>

.sp
.B GFX_MODE_LIST *get_gfx_mode_list(int card);
.SH 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:

.nf
   typedef struct GFX_MODE_LIST
   {
      int num_modes;
      GFX_MODE *mode;
   } GFX_MODE_LIST;
   
.fi
The mode entry  points to the actual list of video modes.

.nf
   typedef struct GFX_MODE
   {
      int width, height, bpp;
   } GFX_MODE;
   
.fi
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.
.SH "RETURN VALUE"
Returns a pointer to a list structure of the type GFX_MODE_LIST or NULL
if the request could not be satisfied.

.SH SEE ALSO
.BR destroy_gfx_mode_list (3alleg4),
.BR set_gfx_mode (3alleg4),
.BR set_color_depth (3alleg4)