fgi_open() (Fastgraph/Image)

Win32 DirectX Fastgraph/Light

Prototype

int fgi_open (char *fgi_file);

Function fgi_open (ByVal fgi_file As String) As Long

function fgi_open (fgi_file : string) : integer;

Description

The fgi_open() function opens an FGI library file and returns a file handle through which the files in that library can be accessed. For information about creating and maintaining FGI libraries, refer to Chapter 3 of the Fastgraph/Image 6.0 User's Guide.

Parameters

fgi_file is the name of the FGI library to open. A device and path name may be included as part of the FGI library's file name. It must be terminated by a null character (that is, a zero byte).

Return value

If the FGI library is opened successfully, fgi_open() returns the file handle through which other Fastgraph/Image functions reference the FGI library. If fgi_open() cannot open fgi_file, it returns zero.

Restrictions

none

See also

fgi_close()

Examples

FGIW1, FGIW2, FGIW3, FGIW4, FGIW5, FGIW6