play_fli3alleg4

Overview

Plays an Autodesk Animator FLI or FLC animation file on the specified BITMAP, reading the data from disk as it is required. If `loop' is not zero, the player will cycle when it reaches the end of the file, otherwise it will play through the animation once and then return. Read the beginning of chapter "FLIC routines" for a description of the callback parameter. Example:

   /* Let users skip looped animations. */
   int check_escape_key(void)
   {
      if (key[KEY_ESC])
         return 1;
      else
         return 0;
   }
   ...
      int ret = play_fli("animlogo.fli", screen, 1,
                          check_escape_key);
      if (ret == FLI_ERROR)
         abort_on_error("Error playing intro!");

Return value

The FLI player returns FLI_OK if it reached the end of the file, FLI_ERROR if something went wrong, and the value returned by the callback function if that was what stopped it.