gfx_mode_select(3alleg4)

💖 gfx_mode_select — the Allegro manual, but make it cute 💖

okay bestie, gather round, because this is gfx_mode_select(3alleg4) from the Allegro manual and it's literally the vibes-picker for your graphics setup. no cap.

✨ NAME ✨

gfx_mode_select</p> — pops up the Allegro graphics mode selection dialog. that's it, that's the whole job, and she does it gorgeously. 💅

🌸 SYNOPSIS 🌸

#include <allegro.h>

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

🦋 DESCRIPTION 🦋

So like. This function brings up the Allegro graphics mode selection dialog, which is the lil window where the user gets to pick their screen mode and their graphics card. very main character of them honestly.

Here's the tea tho — the values already sitting at the addresses you pass in via card, w, and h get used as the default selections in the dialog. but only if they actually show up in the driver and mode lists. if they're not in there? then the initial selection just falls back to the first entry in each list. 🤷♀️

And if you want to guarantee the first entry is always the one preselected, bestie, just initialize the data at the addresses you're passing in to either 0 or -1. iconic behavior. ⭐

Then if the user hits OK on that dialog, it stores the selections at the addresses you passed to the function. cute, right? 🎀

💀 RETURN VALUE 💀

ngl, the return values live somewhere else — go check out the gfx_mode_select_filter function for those. i'm not making this up, that's just where they are. 🙈

🌈 SEE ALSO 🌈

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

fr fr, if you forget the defaults, the dialog just picks the first thing in the list and moves on. set 0 or -1 if you want that on purpose. no surprises, no drama. 🫶

and that's the whole page, bestie!! 🥳 this was brought to you by Allegro, version 4.4.3 — go forth and select your modes, you absolute legend. mwah 💖✨