AL_APPLY_WINDOW_CONSTRAINTS(3)

💖 NAME 💖

al_apply_window_constraints — Allegro 5 API ✨

Okay so this page is from the Allegro reference manual, and it's all about al_apply_window_constraints. 💅

✨ SYNOPSIS ✨

#include <allegro5/allegro.h>

void al_apply_window_constraints(ALLEGRO_DISPLAY *display, bool onoff)

🎀 DESCRIPTION 🎀

Bestie, this function enables or disables constraints that were previously set by the al_set_window_constraints(3) function. That's it — it's the on/off switch for your window-size rules. 🫶

When it's enabled, the specified display will automatically resize itself to new sizes so it conforms to those constraints in these cases:

• The specified display is resizable, not maximized, and not in fullscreen mode. ✅
• If the appropriate current display size (width or height) is less than the value of the constraint. This one applies to minimum constraints. 📏
• If the appropriate current display size (width or height) is greater than the value of the constraint. This one applies to maximum constraints. 📐

Heads up, bestie: constraints are not applied when a display is toggled from windowed to maximized or fullscreen modes. 😭

When a display is toggled from maximized/fullscreen back to windowed mode, then the display may be resized as described above. The later case is also possible when a user drags the maximized display via mouse. 🖱️✨

If it's disabled, the specified display will stop using constraints. Periodt. 💀

🌈 SEE ALSO 🌈

• al_get_window_constraints(3)
• al_set_window_constraints(3)

---

Source/version: Allegro reference manual. Date: this footer doesn't print one, just the tag al_apply_w...constraints(3) — so that's the cute little sign-off, bestie 💖🎀