fgi_flicopen() (Fastgraph/Image)

Win32 DirectX Fastgraph/Light

Prototype

int fgi_flicopen (char *filename, void *context, int handle);

Function fgi_flicopen (ByVal filename As String, context() As Any, ByVal handle As Long) As Long

function fgi_flicopen (filename : string; var context; handle : integer) : integer;

Description

The fgi_flicopen() function opens an FLI or FLC file (collectively called flic files) stored in an FGI library for subsequent processing by other low-level flic file support functions. If successful, the file pointer will be positioned at the beginning of the first frame.

Parameters

filename is the name of the FLI/FLC 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).

context is the name of a 20-byte buffer that will receive the flic file context descriptor. The descriptor values will only be meaningful if the return value is zero.

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

none

See also

fg_flicplay(), fgi_flicskip(), fgi_showflic()

Examples

FGIW2