al_get_window_borders(3)

💅 al_get_window_borders(3) 💅

okay bestie, this one is from the Allegro 5 API and lives in the Library Functions Manual — and it is literally here to hand you the size of a window’s borders when it can. 🫶

🌸 NAME 🌸

al_get_window_borders — Allegro 5 API. Yes, that’s the whole name, and yes, it’s giving “tiny but useful” energy. ✨

🦋 SYNOPSIS 🦋

#include <allegro5/allegro.h>

bool al_get_window_borders(ALLEGRO_DISPLAY *display, int *left, int *top, int *right, int *bottom)

💖 DESCRIPTION 💖

So here’s the tea ☕: if that information is available, al_get_window_borders returns TRUE and fills in the size of the window borders. No cap.

You can pass NULL for borders you do not want to retrieve — lowkey iconic, honestly, because sometimes you only need some of the numbers. 💅

If the border information is not available, it returns FALSE. That’s it. That’s the vibe check. 🫠

[Unstable API]: This is an experimental feature and currently only partially works on X11 and Windows. The meaning of the upper border may change when menus are present. ⚠️

👑 SEE ALSO 👑

• al_set_window_position(3) — go peek at this one too 👀
• al_get_window_position(3) — and this one, fr fr 🎀

⭐ SINCE ⭐

5.2.9 — periodt, that’s when this landed. 🌈

---

mwah 💋 — source/version is the Allegro reference manual, the footer page tag is al_get_window_borders(3), and there’s no date listed on this page, so I’m not gonna invent one bestie 😭✨