Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
get_gfx_mode_type(3)		Allegro	manual		  get_gfx_mode_type(3)

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_DEFI-
       NITE 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(3),  get_gfx_mode(3),  set_gfx_mode(3),  is_win-
       dowed_mode(3)

Allegro				 version 4.4.3		  get_gfx_mode_type(3)

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUE | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=get_gfx_mode_type&sektion=3&manpath=FreeBSD+12.1-RELEASE+and+Ports>

home | help