LPlayBack::Create

#include "ltwrappr.h"

virtual L_INT LPlayBack::Create(pBitmap, pLBitmapList=NULL)

LBitmapBase L_FAR * pBitmap;	/* pointer to an LBitmapBase object */
LBitmapList L_FAR * pLBitmapList;	/* pointer to an LBitmapList object */

Creates an animation playback for the class object.

Parameter	Description
pBitmap	Pointer to the background bitmap. This bitmap will be invalid after the function cal, since it will be attached to the internal bitmap. This is an optional parameter. If you pass NULL, then the playback will be created using the internal bitmap object. In this case the internal bitmap object must be allocated. You can access the internal bitmap object by calling the LPlayBack::GetBitmap function, which is declared using the LEAD_DECLARE_PLAYBACK_BITMAP() macro. For more information about C++ Wrapper macros, refer to Wrapper Macros.
pLBitmapList	Optional pointer to the bitmap list containing images to be played. The list can be created using LBitmapList::Create and related functions. You can also pass NULL in this parameter to let the function create an empty list.

Returns

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

Comments

The target bitmap for the playback must be allocated before calling this function.

If you pass NULL in the pLBitmapList parameter, you can use the LPlayBack::Append function to add bitmaps to the list during the playback. This is useful in any of the LFile object's load callback functions, if you want to play an animated file as it is being loaded. If you need to reference the list after the playback, you can pass the address of an LBitmapList object when you call the LPlayBack::Destroy function.

Required DLLs and Libraries

LTDIS
LTFIL

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

Functions:	Class Members
Topics:	Raster Image Functions: Creating and Maintaining Lists of Images
	Implementing Animation