al_triangulate_polygon(3)

💖 al_triangulate_polygon(3) — Library Functions Manual 💖

🌸 NAME 🌸

okay so al_triangulate_polygon — Allegro 5 API. That's the name, bestie, and this is literally its whole manual moment. periodt. 💅

---

✨ SYNOPSIS ✨

#include <allegro5/allegro_primitives.h>

bool al_triangulate_polygon(
   const float* vertices, size_t vertex_stride, const int* vertex_counts,
   void (*emit_triangle)(int, int, int, void*), void* userdata)

---

🦋 DESCRIPTION 🦋

bestie, this one divides a simple polygon into triangles, with zero or more other simple polygons subtracted from it — the holes. The holes cannot touch or intersect with the outline of the main polygon. Simple means the polygon does not have to be convex but must not be self-overlapping.

🚨 caveat check: holes cannot touch or intersect with the outline of the main polygon, and the polygon must not be self-overlapping. no cap, that part matters. 💀

💅 Parameters 💅

• vertices — an interleaved array of (x, y) vertex coordinates for each of the polygons, including holes. 💖
• vertex_stride — the distance (in bytes) between successive pairs of vertices in the array. 🦋
• vertex_counts — number of vertices for each polygon. The number of vertices in the main polygon is given by vertex_counts[0] and must be at least three. Subsequent elements indicate the number of vertices in each hole. The array must be terminated with an element with value zero. 👑
• emit_triangle — a function to be called for every set of three points that form a triangle. The function is passed the indices of the points in vertices and userdata. 🔥
• userdata — arbitrary data to be passed to emit_triangle. 🎀

---

🔥 SINCE 🔥

5.1.0 ✨ — that's the version, bestie. it's been giving since 5.1.0, fr fr.

---

🌈 SEE ALSO 🌈

al_draw_filled_polygon_with_holes(3) — go read that one too, bestie. iykyk. 🫶

---

— Allegro reference manual · Allegro 5 API · al_triangulate_polygon(3) · date? not printed in this footer, so don't come for me 🙈💖