Bink SDK 1.5v

BinkGetRects

The function BinkGetRects returns the dirty rectangles of the last decompressed video frame.

S32 BinkGetRects(
  HBINK bink,
  BINK_GETRECTS_FLAGS getrects_flags
);

In Parameters

bink
Specifies the Bink handle.
getrects_flags
Specifies the type of rectangle list you'd prefer.

Returns

Returns the number of dirty rectangles found.

Discussion

This function returns one or more dirty rectangles that outline the frame areas that changed in the last call to BinkDoFrame. "Dirty rectangles" are the rectangles that enclose all of the pixels that changes from the previous frame to this frame. The dirty rectangles are placed in the FrameRects field of the BINK structure. You will usually pass the dirty rectangle information directly to the BinkBufferBlit function for blasting onto the screen. If you are using BinkBuffers, you can use the SurfaceType field in your BinkBuffer structure for the getrects_flags parameter. This function returns the number of dirty rectangles found.


Group: Bink API
Related Functions: BinkBufferBlit, BinkDoFrame
Related Basic Types: BINK_GETRECTS_FLAGS, HBINK, S32
Related Structures: BINK

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