SDL_atan2f(3)

📦
version 3.4.18 · 9 versions
, in fedora 43, fedora 44

💖 SDL_atan2f(3) 💖

okay bestie, welcome to the SDL3 FUNCTIONS corner of the man pages, where we make triangles make sense ✨

🌸 NAME 🌸

SDL_atan2f — compute the arc tangent of y / x, using the signs of x and y to adjust the result's quadrant. yes babe, it's giving full directional awareness 💅

🎀 SYNOPSIS 🎀

#include <SDL3/SDL_stdinc.h>

float SDL_atan2f(float y, float x);

✨ DESCRIPTION ✨

so here's the vibe. the definition of z = atan2(x, y) is:

y = x tan(z)

...where the quadrant of z is determined based on the signs of x and y. quadrant awareness, we love to see it 🦋

Domain: -INF <= x <= INF,

-INF <= y <= INF

Range: -Pi <= y <= Pi

this function operates on single-precision floating point values. if you need double-precision floats, use SDL_atan2 instead — she's the big sister fr fr 💜

and if you just wanna calculate the arc tangent of a single value (no division drama, no quadrants), use SDL_atanf. different tool, different slay 🧚

⚠️ heads up bestie: this function may use a different approximation across different versions, platforms and configurations. i.e., it can return a different value given the same input on different machines or operating systems, or if SDL is updated. so like... don't expect bit-identical results everywhere, okay? no cap. 😭

🫶 FUNCTION PARAMETERS 🫶

  • y — floating point value of the numerator (y coordinate).
  • x — floating point value of the denominator (x coordinate).

🔥 RETURN VALUE 🔥

returns the arc tangent of of y / x in radians, or, if x = 0, either -Pi/2, 0, or Pi/2, depending on the value of y. she always knows which way to point 👑

💀 THREAD SAFETY 💀

it is safe to call this function from any thread. go off, concurrent queen ⭐

🌈 AVAILABILITY 🌈

this function is available since SDL 3.2.0. new-ish but iconic already 🍓

👑 SEE ALSO 👑

and that's the whole page, bestie!! this came to you from Simple Directmedia Layer, rocking version SDL 3.4.18 — mwah, go forth and compute your angles 💖✨🎀🦋

📦 where this page comes from