fgi_showspr() (Fastgraph/Image legacy function)

Win32 DirectX Fastgraph/Light

Prototype

int fgi_showspr (char *filename, int handle);

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

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

Description

The fgi_showspr() legacy function displays a standard pixel run (SPR) file stored in an FGI library. The image will be positioned so that its lower left corner is at the graphics cursorposition in the active virtual buffer.

Parameters

filename is the name of the SPR file. It may only include a file name and extension (such as PICTURE.SPR) 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

-3 = The requested file is not an SPR file

Restrictions

none

Replaced by

BMP and PCX display functions