fgi_showflic() (Fastgraph/Image)

Win32 DirectX Fastgraph/Light

Prototype

int fgi_showflic (char *filename, int count, int flags, int handle);

Function fgi_showflic (ByVal filename As String, ByVal count As Long, ByVal flags As Long, ByVal handle As Long) As Long

function fgi_showflic (filename : string; count, flags, handle : integer) : integer;

Description

The fgi_showflic() function plays an FLI or FLC file (collectively called flic files) stored in an FGI library. Each frame in the flic file is played in the active virtual buffer and then scaled to fit the client area. For 256-color virtual buffers, flic files are reduced to the 236 non-system colors if color reduction is enabled.

Parameters

filename is the name of the flic file. It may only include a file name and extension (such as MOVIE.FLI) and must be terminated by a null character (that is, a zero byte).

count is the number of times to play the flic file. If count is zero, the flic plays continuously. You can stop the flic play at any time by pressing the Escape key.

flags is a series of flags that controls how the image is played:\

Flag

Meaning

FG_AT_XY

If specified, play the flic file relative to the current graphics position. If not, play it relative to (0,0).

FG_IGNOREFLICPALETTE

If specified, play the flic file using the current palette. If not, use the palette values stored in the flic file.

FG_KEEPCOLORS

If specified, disable color reduction and remapping. If not, enable color reduction and remapping to avoid using the Windows system colors.

FG_NODELAY

If specified, play the flic file with no delay between frames. If not, delay between frames as specified in the flic header.

handle is the file handle for the FGI library containing filename.

Return value

0 = Success

-1 = Error reading the FGI library

-2 = The requested file is not in the FGI library

-3 = The requested file is not an FLI or FLC file

Restrictions

A logical palette must be defined and realized in order to use the palette values stored in the flic file.

When using DirectX, the active virtual buffer must not be locked.

See also

fgi_display(), fgi_flichead(), fg_flicplay(), fg_flicsize(), fg_realize()

Examples

FGIW2

Contents
Fastgraph Home Page

 

copyright 2001 Ted Gruber Software, Inc.