fg_loadpcx() (legacy function)

Win32 DirectX Fastgraph/Light

Prototype

int fg_loadpcx (char *filename, int flags);

Function fg_loadpcx (ByVal filename As String, ByVal flags As Long) As Long

function fg_loadpcx (filename : string; flags : integer) : integer;

Description

The fg_loadpcx() legacy function displays a PCX file. It is equivalent to the fg_showpcx() function.

For 256-color virtual buffers, 256-color PCX files are reduced to the 236 non-system colors if color reduction is enabled. 16-color and monochrome PCX files are always remapped to colors 10 to 25 to avoid conflicts with the system colors.

Parameters

filename is the name of the PCX file. A device and path name may be included as part of the file name. The file name must be terminated by a zero byte.

flags is a series of flags that controls how the image is displayed. Refer to the description of fg_showpcx() for the meanings of the flags.

Return value

0 = Success

1 = The specified file does not exist

2 = The specified file is not a PCX file

3 = The PCX file cannot be loaded into the active virtual buffer

4 = Error allocating memory

Restrictions

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

24-bit PCX files can only be loaded into direct color virtual buffers.

Replaced by

fg_showpcx()