L_ValidatePlaybackLines

#include "l_bitmap.h"

L_LTDIS_API L_INT L_ValidatePlaybackLines(hPlayback, nRow, nLines)

HPLAYBACK hPlayback;

/* playback handle */

L_INT nRow;

/* row number of the first line to validate */

L_INT nLines;

/* number of lines to validate */

Validates lines of a bitmap that was added during a FILEREADCALLBACK function using the L_AppendPlayback function.

Parameter

Description

hPlayback

Handle that references the animation playback.

nRow

Row number of the first line in the bitmap to validate. In the FILEREADCALLBACK function, this corresponds to the first line in the buffer.

nLines

Number of lines to validate. In the FILEREADCALLBACK function, this corresponds to the number of lines in the buffer.

Returns

SUCCESS

The function was successful.

< 1

An error occurred. Refer to Return Codes.

Comments

The L_AppendPlayback function enables you to update a bitmap list in a FILEREADCALLBACK function, so that you can play an animation file as it is being loaded. The L_ValidatePlaybackLines function lets you validate the lines that the animation playback engine will render to the target bitmap.

Required DLLs and Libraries

LTDIS
LTFIL
File format DLLs

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_ClearPlaybackUpdateRect, L_GetPlaybackIndex, L_GetPlaybackState, L_GetPlaybackUpdateRect, L_SetPlaybackIndex, L_AppendPlayback

Topics:

Raster Image Functions: Creating and Maintaining Lists of Images

 

Implementing Animation

Example

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