SDL_RectsEqualEpsilon(3)

💖 SDL_RectsEqualEpsilon(3) 💖

okay bestie, welcome to the SDL3 FUNCTIONS corner of the man pages, where we're checking if two float rectangles are basically the same. not exactly the same. within an epsilon. it's giving "close enough is good enough" and honestly? valid.

---

✨ NAME ✨

SDL_RectsEqualEpsilon — figure out whether two floating point rectangles are equal, within some given epsilon. 🎀

---

🌸 SYNOPSIS 🌸

#include <SDL3/SDL_rect.h>

SDL_FORCE_INLINE bool SDL_RectsEqualEpsilon(const SDL_FRect *a, const SDL_FRect *b, float epsilon);

---

🦋 DESCRIPTION 🦋

so here's the tea: two rectangles count as equal if both of them are not NULL and each of their x, y, width and height are within epsilon of each other. that's it, that's the whole vibe check. 💅

and if you're sitting there like "bestie what number do i even put for epsilon 😭" — the manpage says: if you don't know what value to use for epsilon, you should call the SDL_RectsEqualFloat function instead. she's got you. 🫶

now, the important part, no cap: note that this is a forced-inline function in a header, and not a public API function available in the SDL library. which is to say, the code is embedded in the calling program and the linker and the dynamic loader will not be able to find this function inside SDL itself. so don't go looking for her in the library, she lives in your code now. iconic behaviour honestly. ✨

---

🌈 FUNCTION PARAMETERS 🌈

• a — the first rectangle to test. 🍓
• b — the second rectangle to test. 🍓
• epsilon — the epsilon value for comparison. the lil tolerance window, the "close enough" radius, the grace she deserves. 👑

---

⭐ RETURN VALUE ⭐

Returns true if the rectangles are equal, false otherwise. binary. no in-between. slay. 💀

---

🧚 THREAD SAFETY 🧚

It is safe to call this function from any thread. go off, multithreaded main character. 🔥

---

👑 AVAILABILITY 👑

This function is available since SDL 3.2.0. so if you're on anything older, no she isn't. 🙈

---

💜 SEE ALSO 💜

• SDL_RectsEqualFloat(3) — the one you call when you don't know what epsilon to use. the certified "idk just use this one" queen. 🌸

---

and that's the page, bestie!! brought to you by the fine folks at Simple Directmedia Layer, straight out of SDL 3.4.18 — this whole SDL_RectsEqualEpsilon(3) moment is theirs, we're just living in it. mwah. 💖✨