---
name: "get_gfx_mode_list"
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_list/3alleg4"
---

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

Obtains a list of available video modes. Allegro game programming library.

## NAME

get\_gfx\_mode\_list - Obtains a list of available video modes. Allegro game programming library.

## SYNOPSIS

**#include \<allegro.h\>**

**GFX\_MODE\_LIST \*get\_gfx\_mode\_list(int card);**

## DESCRIPTION

Attempts to create a list of all the supported video modes for a certain graphics driver, made up from the GFX\_MODE\_LIST structure, which has the following definition:

```
   typedef struct GFX_MODE_LIST
   {
      int num_modes;
      GFX_MODE *mode;
   } GFX_MODE_LIST;
```

The mode entry  points to the actual list of video modes.

```
   typedef struct GFX_MODE
   {
      int width, height, bpp;
   } GFX_MODE;
```

This list of video modes is terminated with an { 0, 0, 0 } entry.

Note that the card parameter must refer to a \_real\_ driver. This function fails if you pass GFX\_SAFE, GFX\_AUTODETECT, or any other "magic" driver.

## RETURN VALUE

Returns a pointer to a list structure of the type GFX\_MODE\_LIST or NULL if the request could not be satisfied.

## SEE ALSO

**destroy\_gfx\_mode\_list**(3alleg4), **set\_gfx\_mode**(3alleg4), **set\_color\_depth**(3alleg4)