fgi_showjpeg() (Fastgraph/Image)

Win32 DirectX Fastgraph/Light

Prototype

int fgi_showjpeg (char *filename, int flags, int handle);

Function fgi_showjpeg (ByVal filename As String, ByVal flags As Long, ByVal handle As Long) As Long

function fgi_showjpeg (filename : string; flags, handle : integer) : integer;

Description

The fgi_showjpeg() function displays a JPEG file stored in an FGI library. The JPEG image can be either grayscale or color, but it must be a baseline JPEG file. Baseline JPEG files use Huffman encoding and cannot use the progressive, hierarchical, or lossless compression and storage modes.

Parameters

filename is the name of the JPEG file. It may only include a file name and extension (such as PICTURE.JPG) and must be terminated by a zero byte.

flags is a series of flags that controls how the image is displayed:

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 JPEG file

-4 = The specified file is not a baseline JPEG file or does not have a valid JPEG structure

-5 = Error allocating memory

Restrictions

This function is meaningful only with direct color virtual buffers.

See also

fgi_display(), fgi_jpeghead(), fg_jpegsize()