get_gfx_mode_type(3alleg4) [debian man page]

get_gfx_mode_type(3alleg4)					  Allegro manual					get_gfx_mode_type(3alleg4)

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)

Allegro 							   version 4.4.2					get_gfx_mode_type(3alleg4)

gfx_mode_select_filter(3alleg4) 				  Allegro manual				   gfx_mode_select_filter(3alleg4)

NAME

       gfx_mode_select_filter - Even more extended version of the graphics mode selection dialog. Allegro game programming library.

SYNOPSIS

       #include <allegro.h>

       int gfx_mode_select_filter(int *card, int *w, int *h, int *color_depth, int (*filter)(int, int, int, int));

DESCRIPTION

       Even  more  extended version of the graphics mode selection dialog, which allows the programmer to customize the contents of the dialog and
       the user to select the color depth as well as the resolution and hardware driver.  `filter'  will  be  passed  (card,  w,  h,  color_depth)
       quadruplets and must return 0 to let the specified quadruplet be added to the list of displayed modes.

       As  with  gfx_mode_select, the values stored at the addresses passed to the function will be used as suggestions for the initial selections
       in the dialog, defaulting to the first entry in each list if the values are not found. Initialize the data stored at the  addresses  passed
       to the function to the value of 0 or -1 if you want to ensure that the initial selection for each list will be the first entry.

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

       Example usage :

	  ret = gfx_mode_select_filter(&card, &w, &h, &color_depth, user_filter);
	  if (ret) {/* User okayed dialog or user_filter removed all modes */
	     if (card == GFX_NONE) {
		// No modes available
		*card = 0;/* Make sure not to leave *card == GFX_NONE */
		return -1;
	     }
	     /* Handle changing to new mode here... */

	  } else {/* User cancelled dialog or there was an error (unlikely) */
	     if (card == GFX_NONE) {
		/* Error, probably out of memory */
		*card = 0;/* Make sure not to leave *card == GFX_NONE */
		return -2;
	     }
	     /* Carry on in current graphics mode if that is acceptable */
	  }

RETURN VALUE

       Returns	zero if the user cancelled the dialog or an error occurred. In the case of an error then *card is assigned the value GFX_NONE. The
       functions return non-zero if the user made a selection OR if all the modes were filtered out. In the case that all of the modes	were  fil-
       tered  out, then *card is assigned the value GFX_NONE. This means you should NOT initialize the *card to the value of GFX_NONE, as it could
       interfere with determining the proper return value.

SEE ALSO

       gfx_mode_select(3alleg4), gfx_mode_select_ex(3alleg4), set_color_depth(3alleg4), set_gfx_mode(3alleg4), gui_fg_color(3alleg4)

Allegro 							   version 4.4.2				   gfx_mode_select_filter(3alleg4)