Provided by: allegro4-doc_4.4.3.1-4.1build3_all bug

NAME

       get_gfx_mode_type  -  Retrieves  type  information for a specific graphics card. Allegro game programming
       library.

SYNOPSIS

       #include <allegro.h>

       int get_gfx_mode_type(int graphics_card);

DESCRIPTION

       This function lets you determine the types of operating  modes  that  a  specific  graphics  card  driver
       operates  in.  It  will tell you whether it is a windowed, fullscreen, definitely windowed or fullscreen,
       and/or a magic driver.

       The value returned is a bitfield consisting of these fields:

       GFX_TYPE_UNKNOWN GFX_TYPE_WINDOWED GFX_TYPE_FULLSCREEN GFX_TYPE_DEFINITE GFX_TYPE_MAGIC

       The return value will only be equivalent to GFX_TYPE_UNKNOWN when it is a  driver  unrecognized  on  that
       platform,  or  it  is  a  bogus  value. Test for the other types by using a bitwise AND. If the driver is
       windowed or fullscreen, it will also have the definite flag set.  For example,

          int gfx_type = get_gfx_mode_type(GFX_AUTODETECT_WINDOWED);

       gfx_type would have the GFX_TYPE_WINDOWED, GFX_TYPE_DEFINITE, and GFX_TYPE_MAGIC flags set.

       Allegro needs to be initialized first.

       Example:

          /* Accept the use of only windowed drivers in our selection dialog */
          int accept_windowed(int card , int w , int h , int color_depth)
          {
             if (get_gfx_mode_type(card) & GFX_TYPE_WINDOWED)
                return 0;
             return 1;
          }

          /* In main: */
          gfx_mode_select_filter(&card, &w, &h, &color_depth, accept_windowed);

RETURN VALUE

       Returns a bitfield describing the graphics mode type.

SEE ALSO

       gfx_mode_select_filter(3alleg4), get_gfx_mode(3alleg4), set_gfx_mode(3alleg4), is_windowed_mode(3alleg4)