fgi_pcxhead() (Fastgraph/Image)

Win32 DirectX Fastgraph/Light

Prototype

int fgi_pcxhead (char *filename, void *header, int handle);

Function fgi_pcxhead (ByVal filename As String, header() As Any, ByVal handle As Long) As Long

function fgi_pcxhead (filename : string; var header; handle : integer) : integer;

Description

The fgi_pcxhead() function reads the header of a PCX file stored in an FGI library.

Parameters

filename is the name of the PCX file. 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).

header is the name of the buffer to receive the PCX file header. Its size must be at least 128 bytes.

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 a PCX file

Restrictions

none

See also

fgi_pcxpal(), fg_pcxrange(), fg_pcxsize(), fgi_showpcx()