NAME

       gfx_mode_select - Displays the Allegro graphics mode selection dialog.

SYNOPSIS

       #include <allegro.h>

       int gfx_mode_select(int *card, int *w, int *h);

DESCRIPTION

       Displays  the  Allegro  graphics  mode selection dialog, which allows the user to select a
       screen mode and graphics card.

       The initial values at the addresses provided by card, w, and h are  used  as  the  default
       selections  in  the dialog if they are found in the driver and mode lists. If they are not
       found then the initial selections will be the first in each list. If you  wish  to  ensure
       that  the  initial  selection  is  always the first entry, then initialize the data at the
       addresses passed to the function to the value of 0 or -1.

       If the dialog is OK'd, it stores the selections at the addresses passed to the function.

RETURN VALUE

       See the gfx_mode_select_filter function for the return values.

SEE ALSO

       gfx_mode_select_ex(3alleg4),    gfx_mode_select_filter(3alleg4),    set_gfx_mode(3alleg4),
       gui_fg_color(3alleg4)