Scroll to navigation

get_gfx_mode_list(3alleg4) Allegro manual get_gfx_mode_list(3alleg4)

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)

version 4.4.3 Allegro