al_fixasin(3)

💖 al_fixasin(3) — Allegro 5 API 💖

okay so this is the al_fixasin(3) page from the Library Functions Manual, and it's serving pure Allegro 5 API realness, bestie. Let's go ✨

🎀 NAME 🎀

al_fixasin — Allegro 5 API 🦋

✨ SYNOPSIS ✨

#include <allegro5/allegro.h>

al_fixed al_fixasin(al_fixed x);

🌸 DESCRIPTION 🌸

This function finds the inverse sine of a value using a lookup table. The input value must be a fixed point value, no cap.

The inverse sine is defined only in the domain from -1 to 1. Outside of this input range, the function will set Allegro’s errno to EDOM and return zero. It's giving "domain error, bestie" 😭

Example:

float angle;
al_fixed val;

/* Sets `val' to a right binary angle (64). */
val = al_fixasin(al_itofix(1));

/* Sets `angle' to 0.2405. */
angle = al_fixtof(al_fixmul(al_fixasin(al_ftofix(0.238)), al_fixtorad_r));

/* This will trigger the assert. */
val = al_fixasin(al_ftofix(-1.09));
assert(!al_get_errno());

That last chunk is literally the one that triggers the assert, so yeah — it's a whole moment 💀

💜 RETURN VALUE 💜

Returns the inverse sine of a fixed point value, measured as a fixed point binary format angle, or zero if the input was out of the range. All return values of this function will be in the range -64 to 64, periodt. 👑

---

source/version: Allegro reference manual 🌈 page: al_fixasin(3) 🫶 date: not shown on this one, so we're not inventing one, bestie 🙈