L_GetPlaybackUpdateRect

#include "l_bitmap.h"

L_LTDIS_API L_INT L_GetPlaybackUpdateRect(hPlayback, prcUpdate, fClear)

HPLAYBACK hPlayback;	/* playback handle */
L_RECT * prcUpdate;	/* address of the RECT structure to be updated */
L_BOOL fClear;	/* TRUE if you want to clear the rectangle */

Gets the update rectangle in the target bitmap during an animation playback. The rectangle uses bitmap coordinates, and it is cumulative.

Parameter	Description
hPlayback	Handle that references the animation playback.
prcUpdate	Address of the RECT structure that this function will fill with the coordinates of the update rectangle
fClear	TRUE if you want to clear the rectangle; FALSE if you do not.

Returns

SUCCESS	The function was successful.
< 1	An error occurred. Refer to Return Codes.

Comments

You usually call this after the following states, which you can get with the L_GetPlaybackState function:

Constant	Meaning
PLAYSTATE_POSTCLEAR	[0x0001] Indicates that the target bitmap has been cleared.
PLAYSTATE_POSTRENDER	[0x0003] Indicates that an image has been rendered to the target bitmap.
PLAYSTATE_POSTDISPOSE	[0x0005] Indicates that the current image has been disposed of. The index is incremented after processing this state.

This function uses bitmap coordinates to specify the update rectangle. Therefore, you must account for the bitmap's view perspective. For more information, refer to Accounting for View Perspective.

Required DLLs and Libraries

LTDIS

For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application.

Platforms

Windows 2000 / XP/Vista, Windows CE.

See Also

Functions:	L_CreatePlayback, L_DestroyPlayback, L_GetPlaybackDelay, L_CancelPlaybackWait, L_ProcessPlayback, L_GetPlaybackIndex, L_GetPlaybackState, L_GetPlaybackUpdateRect, L_SetPlaybackIndex, L_AppendPlayback, L_ValidatePlaybackLines
Topics:	Raster Image Functions: Creating and Maintaining Lists of Images
	Implementing Animation

Example

For a short example, refer to L_ProcessPlayback. For complete sample code, refer to the CHILD.C module of the DEMO example.