gfx_mode_select(3)

💖 gfx_mode_select 💖

okay bestie, so this one is from the Allegro manual, it's gfx_mode_select(3), and it's literally the vibe-check dialog for your graphics mode. let's get into it 🎀

---

✨ NAME ✨

gfx_mode_select — pops up the Allegro graphics mode selection dialog, no cap 💅

---

🌈 SYNOPSIS 🌈

#include <allegro.h>

int gfx_mode_select(int *card, int *w, int *h);

---

🦋 DESCRIPTION 🦋

So like. This function displays the Allegro graphics mode selection dialog — the little window where the user gets to pick a screen mode and a graphics card. iconic behavior honestly.

Here's the tea on how the defaults work 🍓: whatever values are sitting at the addresses pointed to by card, w, and h get used as the default selections in the dialog — but only if those values are actually found in the driver and mode lists. If they're not found? Then the initial selections just become the first entry in each list instead. no biggie.

And if you really want to make sure the initial selection is always the first entry, then initialize the data at the addresses you pass into the function to the value of 0 or -1. that's the hack, periodt ✨

Then — if the dialog gets OK'd — it stores the selections at the addresses passed to the function. slay. 👑

---

💫 RETURN VALUE 💫

Not gonna lie, this page doesn't spell it out — it says see the gfx_mode_select_filter function for the return values. so go peek at that one, bestie 🫶

---

👀 SEE ALSO 👀

• gfx_mode_select_ex(3)
• gfx_mode_select_filter(3)
• set_gfx_mode(3)
• gui_fg_color(3)

---

fr fr, remember: the defaults only stick if they exist in the lists — otherwise it's first-entry energy whether you like it or not 😭

---

mwah 💋 that's the whole page, and it's giving Allegro, version 4.4.3 — go forth and select your mode, main character 🌸💖