.\" Automatically generated by Pandoc 3.6.1
.\"
.TH "al_ftofix" "3" "" "Allegro reference manual"
.SH NAME
al_ftofix \- Allegro 5 API
.SH SYNOPSIS
.IP
.EX
#include \f[B]<allegro5/allegro.h>\f[R]

al_fixed al_ftofix(double x);
.EE
.SH DESCRIPTION
Converts a floating point value to fixed point.
Unlike al_itofix(3), this function clamps values which could overflow
the type conversion, setting Allegro\[cq]s errno to ERANGE in the
process if this happens.
.PP
Example:
.IP
.EX
al_fixed number;

number = al_itofix(\-40000);
assert(al_fixfloor(number) == \-32768);

number = al_itofix(64000);
assert(al_fixfloor(number) == 32767);
assert(!al_get_errno()); \f[I]/* This will fail. */\f[R]
.EE
.SH RETURN VALUE
Returns the value of the floating point value converted to fixed point
clamping overflows (and setting Allegro\[cq]s errno).
.SH SEE ALSO
al_fixtof(3), al_itofix(3), al_fixtoi(3), al_get_errno(3)