Bink SDK 1.5v

BinkGoto

The function BinkGoto jumps to a new frame inside the Bink file.

void BinkGoto(
  HBINK bink,
  U32 frame_num,
  BINK_GOTO_FLAGS goto_flags
);

In Parameters

bink
Specifies the Bink handle.
frame_num
Specifies the frame number to jump to.
goto_flags
Specifies the type of jump to perform.

Discussion

This function allows you to immediately skip to another frame in a Bink file. The frame_num parameter specifies which frame to skip to (the first frame is frame 1). If the new frame data is in Bink's read ahead memory, then this function will be performed instantly (only a few pointers are updated). However, if the new frame data is outside Bink's read buffer, then Bink has to do a seek (slow on a CD-ROM), and then read the frame's data. Even with a seek, though, BinkGoto is still pretty fast. It's often difficult to notice a seek pause at all. You can also find the nearest key frame manually with the BinkGetKeyFrame function.


Group: Bink API
Related Sections: Critical File I/O handling in Bink
Related Functions: BinkGetKeyFrame
Related Basic Types: BINK_GOTO_FLAGS, HBINK, U32, void

For technical support, e-mail Bink1@radgametools.com
© Copyright 1994-2003 RAD Game Tools, Inc. All Rights Reserved.