get_gfx_mode_type man page

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


#include <allegro.h>

int get_gfx_mode_type(int graphics_card);


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:


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.


/* 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(3), get_gfx_mode(3), set_gfx_mode(3), is_windowed_mode(3)


Explore man page connections for get_gfx_mode_type(3).