fgi_seek() (Fastgraph/Image)

Win32 DirectX Fastgraph/Light

Prototype

int fgi_seek (char *filename, int handle);

Function fgi_seek (ByVal filename As String, ByVal handle As Long) As Long

function fgi_seek (filename : string; handle : integer) : integer;

Description

The fgi_seek() function positions the FGI file pointer at the beginning of the requested file. This function is called internally by other Fastgraph/Image functions and is not usually called directly by applications.

Parameters

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

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

Restrictions

none

See also

fgi_readnext()