.\" Generated by the Allegro makedoc utility
.TH get_gfx_mode_type 3alleg4 "version 4.4.3" "Allegro" "Allegro manual"
.SH NAME
get_gfx_mode_type \- Retrieves type information for a specific graphics card. Allegro game programming library.\&
.SH SYNOPSIS
.B #include <allegro.h>

.sp
.B int get_gfx_mode_type(int graphics_card);
.SH 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:

.B GFX_TYPE_UNKNOWN
.B GFX_TYPE_WINDOWED
.B GFX_TYPE_FULLSCREEN
.B GFX_TYPE_DEFINITE
.B 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,

.nf
   int gfx_type = get_gfx_mode_type(GFX_AUTODETECT_WINDOWED);
   
.fi
gfx_type would have the GFX_TYPE_WINDOWED, GFX_TYPE_DEFINITE, and
GFX_TYPE_MAGIC flags set.

Allegro needs to be initialized first.

Example:

.nf
   /* 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);
   
.fi
.SH "RETURN VALUE"
Returns a bitfield describing the graphics mode type.

.SH SEE ALSO
.BR gfx_mode_select_filter (3alleg4),
.BR get_gfx_mode (3alleg4),
.BR set_gfx_mode (3alleg4),
.BR is_windowed_mode (3alleg4)