.\" Generated by the Allegro makedoc utility
.TH next_fli_frame 3alleg4 "version 4.4.3" "Allegro" "Allegro manual"
.SH NAME
next_fli_frame \- Reads the next frame of the current animation file. Allegro game programming library.\&
.SH SYNOPSIS
.B #include <allegro.h>

.sp
.B int next_fli_frame(int loop);
.SH DESCRIPTION
Reads the next frame of the current animation file. If `loop' is not zero,
the player will cycle when it reaches the end of the file, otherwise it
will return FLI_EOF. The frame is read into the global variables
fli_bitmap and fli_palette. Example:

.nf
   while (next_fli_frame(0) == FLI_OK) {
      /* Do stuff, like play audio stream
         or check keys to skip animation. */
      /* Rest some time until next frame... */
   }
.fi
.SH "RETURN VALUE"
Returns FLI_OK on success, FLI_ERROR or FLI_NOT_OPEN on error, and FLI_EOF
on reaching the end of the file.

.SH SEE ALSO
.BR open_fli (3alleg4),
.BR fli_bitmap (3alleg4),
.BR fli_palette (3alleg4),
.BR fli_timer (3alleg4),
.BR fli_frame (3alleg4)