al_set_display_option(3)

💖 al_set_display_option(3) — the Allegro glow-up 💖

This one comes straight outta the Library Functions Manual, and it’s all about changing a display option after the display has already been created. Very “fix it in post,” but for your Allegro display, bestie. ✨

🌈 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 🎀

Okay so: this function changes 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(3).

Calling al_set_new_display_option(3) after that only changes options for newly created displays — it does not touch the options of displays that already exist. al_set_display_option(3) is the one that lets you change some of these values on an existing display. Not all display options can be changed or changing them will have no effect.

🫶 Heads up, bestie: changing options other than those listed below is undefined. Like, do not do a little experimental side quest there.

Here’s the option that’s actually listed below:

• ALLEGRO_SUPPORTED_ORIENTATIONS — You can change this to allow new orientations of the screen/device, or to restrict previously enabled ones. See al_set_new_display_option(3) for more information on this option. 💅

🌸 SINCE 🌸

5.1.5 — iconic behavior since then, no cap. 🎀

🦋 SEE ALSO 🦋

• al_set_new_display_option(3)

---

That’s the whole vibe, bestie. Footer sign-off: Allegro reference manual 💜 — and this page doesn’t print a separate date line, so no made-up date, just the classic manual credit. Mwah. 💋✨