next_fli_frame(3alleg4) [debian man page]

next_fli_frame(3alleg4) 					  Allegro manual					   next_fli_frame(3alleg4)

NAME

       next_fli_frame - Reads the next frame of the current animation file. Allegro game programming library.

SYNOPSIS

       #include <allegro.h>

       int next_fli_frame(int loop);

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, oth-
       erwise it will return FLI_EOF. The frame is read into the global variables fli_bitmap and fli_palette. Example:

	  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... */
	  }

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.

SEE ALSO

       open_fli(3alleg4), fli_bitmap(3alleg4), fli_palette(3alleg4), fli_timer(3alleg4), fli_frame(3alleg4)

Allegro 							   version 4.4.2					   next_fli_frame(3alleg4)

play_fli(3alleg4)						  Allegro manual						 play_fli(3alleg4)

NAME

       play_fli - Plays a FLI or FLC animation from disk. Allegro game programming library.

SYNOPSIS

       #include <allegro.h>

       int play_fli(const char *filename, BITMAP *bmp, int loop, int (*callback)());

DESCRIPTION

       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.

SEE ALSO

       play_memory_fli(3alleg4), install_timer(3alleg4), fli_frame(3alleg4)

Allegro 							   version 4.4.2						 play_fli(3alleg4)