Provided by: allegro4-doc_4.4.2-4_all bug

NAME

       fixasin - Fixed point inverse sine lookup table. Allegro game programming library.

SYNOPSIS

       #include <allegro.h>

       fixed fixasin(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. The inverse sine is defined only in the domain from `-1'  to  `1'.
       Outside  of  this  input  range,  the  function  will set `errno' to EDOM and return zero.
       Example:

          float angle;
          fixed val;

          /* Sets `val' to a right binary angle (`64'). */
          val = fixasin(itofix(1));
          /* Sets `angle' to 0.2405. */
          angle = fixtof(fixmul(fixasin(ftofix(0.238)), fixtorad_r));
          /* This will trigger the assert. */
          val = fixasin(ftofix(-1.09));
          ASSERT(!errno);

RETURN VALUE

       Returns the inverse sine of a fixed point value, measured as  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'.

SEE ALSO