---
name: "al_set_display_option"
section: "3alleg5"
platform: "linux"
package: "allegro5-doc"
version: "2:5.2.10.1+dfsg-1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/al_set_display_option/3alleg5"
---

# al\_set\_display\_option(3alleg5)

Allegro 5 API

## NAME

al\_set\_display\_option - Allegro 5 API

## SYNOPSIS

-

  ```
  #include <allegro5/allegro.h>
  void al_set_display_option(ALLEGRO_DISPLAY *display, int option, int value)
  ```

## DESCRIPTION

Change an option that was previously set for a display. After displays are created, they take on the options set with al\_set\_new\_display\_option(3alleg5). Calling al\_set\_new\_display\_option(3alleg5) subsequently only changes options for newly created displays, and doesn’t touch the options of already created displays. al\_set\_display\_option(3alleg5) allows changing some of these values. Not all display options can be changed or changing them will have no effect. Changing options other than those listed below is undefined.

- •

  ALLEGRO\_SUPPORTED\_ORIENTATIONS - This can be changed to allow new or restrict previously enabled orientations of the screen/device. See al\_set\_new\_display\_option(3alleg5) for more information on this option.

## SINCE

5\.1.5

## SEE ALSO

al\_set\_new\_display\_option(3alleg5)
