fg_flicskip()

Win32 DirectX Fastgraph/Light

Prototype

int fg_flicskip (void *context, int frames);

Function fg_flicskip (context() As Any, ByVal frames As Long) As Long

function fg_flicskip (var context; frames : integer) : integer;

Description

The fg_flicskip() function advances one or more frames in a flic file that was previously opened with fg_flicopen(). If the last frame played by fg_flicplay() played the frame from the fg_imagebuf() buffer, the frame position will be adjusted in the fg_imagebuf() buffer. Otherwise, the flic file position itself will be adjusted.

Parameters

context is the name of a 16-byte buffer containing the flic file context descriptor.

frames is the number of frames to skip in the flic file, starting from the current file position. If frames is negative, the flic file position will be set to the first frame.

Return value

The number of frames skipped. This value may be less than frames if the end-of-file is reached before skipping the requested number of frames. If frames is negative, the return value will be zero.

Restrictions

none

See also

fg_flicopen(), fg_flicplay()

Examples

Image