Provided by: allegro4-doc_4.4.2-4_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)