TICKIT_RECT_ADD(3)

✨ TICKIT_RECT_ADD ✨ (that's the tickit_rect_add(3) page, Library Functions Manual bestie 💖)

okay so real talk, this one is a lil gem. it's called tickit_rect_add and its whole job is obtain the union sum of two rectangles. that's it. that's the gig. union sum. slay 💅

🌸 SYNOPSIS 🌸

#include <tickit.h>

int tickit_rect_add(TickitRect dst[3],
    const TickitRect *a, const TickitRect *b);

and like, obviously you link with -ltickit 🫶

🦋 DESCRIPTION 🦋

so tickit_rect_add() takes the rectangle structs pointed at by a and b and fills up dst with a set of non-overlapping rectangles that cover the exact same area as those two originals. no cap, same area, just... reorganised.

heads up bestie: dst must be an array that can hold at least three rectangle structures. like, at minimum. don't be out here passing a tiny array, it's giving chaos 😭

depending on the geometry of the rectangles you handed over, this bad boy might produce one, two, or three resultant rectangles. iconic range honestly. and then it returns the number of rectangular regions it initialised into your result array, so you know exactly how many of those slots are real and how many are just vibes.

now the tea on what actually lands in dst:

• if the original rectangles do not touch, the result will contain just those two. easy. effortless. no notes.
• if they do touch, the result will contain the one to three non-overlapping horizontal stripes that cover the same area, and they come out in order of increasing line number ✨ like a lil ladder going down the screen.

that's the whole vibe check. union, but tidy. 💖

🔥 RETURN VALUE 🔥

tickit_rect_add() returns the number of rectangles written to dst. that's your count, your receipt, your little "here's how many I actually gave you" 🧾✨

💜 SEE ALSO 💜

• tickit_rect_init_sized(3)
• tickit_rect_init_bounded(3)
• tickit_rect_intersect(3)
• tickit_rect_subtract(3)
• tickit_rect(7)
• tickit(7)

and that's the page!! this one comes to you straight from the Library Functions Manual, filed under TICKIT_RECT_ADD(3) — go forth and union those rectangles, bestie, you're gonna ate it 👑🎀🦋