---
name: "get_gfx_mode_type"
section: "3alleg4"
platform: "linux"
package: "allegro4-doc"
version: "2:4.4.3.1-5"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/get_gfx_mode_type"
---

# get\_gfx\_mode\_type(3alleg4)

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

## 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)