al_draw_filled_polygon(3)

💖 al_draw_filled_polygon(3) 💖

okay so bestie, welcome to the <allegro_primitives.h> corner of the Library Functions Manual — this is the Allegro 5 API primer on filling in shapes, and honestly? it slays. let's get into it 🎀

---

✨ SYNOPSIS ✨

#include <allegro5/allegro_primitives.h>

void al_draw_filled_polygon(const float *vertices, int vertex_count,
   ALLEGRO_COLOR color)

that's the whole vibe right there — three little args and you're drawing. 💅

---

🌸 DESCRIPTION 🌸

okay so this one draws a filled, simple polygon. and "simple" here is doing a LOT of work, so let's be clear about what it means: the polygon does not have to be convex (so no worries, you don't have to be all well-behaved and bulgey), but it must not be self-overlapping. like, at all. self-overlap is not the move, it's giving chaos, it's giving undefined-adjacent behavior energy 💀 — so keep your edges from crossing each other, periodt.

your three arguments, bestie:

• vertices — interleaved array of (x, y) vertex coordinates ✨ (yes, interleaved — x then y then x then y, do not try to be cute and split them into two arrays, that's not what she asked for)
• vertex_count — number of vertices in the array 🔢
• color — color of the filled polygon 🎨

and here's the part you CANNOT skip, iykyk: when the y-axis is facing downwards (which is the usual, the normal situation, the standard vibe), the coordinates must be ordered anti-clockwise. 🌀 not clockwise, not "whatever feels right" — anti-clockwise. the winding order is the main character here and you WILL respect her.

---

⭐ SINCE ⭐

5.1.0 — she's been iconic since 5.1.0, no cap 🫶

---

🦋 SEE ALSO 🦋

• al_draw_polygon(3) — for when you want the outline only, no fill, lowkey the thinner sister
• al_draw_filled_polygon_with_holes(3) — for when your polygon has ✨lore✨ (holes, specifically)

---

and that's the page!! 🌈 go forth and fill your simple, non-self-overlapping, anti-clockwise polygons, bestie, you're gonna eat 🔥

fr fr keep that winding order correct or your shape will simply not be the shape you wanted, and that's on the y-axis facing downwards 🙈

al_draw_filled_polygon(3) — Allegro reference manual 🧚‍♀️ (the footer's just the manual name, no date on this one, that's all she wrote) 💜