// Copyright (c) 2004-2009 Nokia Corporation and/or its subsidiary(-ies).

 // All rights reserved.

 // This component and the accompanying materials are made available

 // under the terms of the License "Symbian Foundation License v1.0" to Symbian Foundation members and "Symbian Foundation End User License Agreement v1.0" to non-members

 // which accompanies this distribution, and is available

 // at the URL "http://www.symbianfoundation.org/legal/licencesv10.html".

 //

 // Initial Contributors:

 // Nokia Corporation - initial contribution.

 //

 // Contributors:

 //

 // Description:

 //

 #ifndef __ANIMATIONDATAPROVIDER_H__

 #define __ANIMATIONDATAPROVIDER_H__

 #include <e32std.h>

 #include <animationframe.h>

 class MAnimationDataProviderObserver;

 _LIT8(KUndefinedAnimationDataType, "undefined");

 /**

 Pure virtual base class for data providers.

 A data provider takes an animation specification (such as a file), converts

 it (if needed) into a format recognised by an animator (such as CAnimationFrame

 objects), and passes it to the animator, via the medium of an animation.

 Most animation types take a data provider as an argument during contruction.

 For more detailed usage instructions, refer to the documentation of the derived

 classes.

 @see CAnimation

 @see MAnimationDataProviderObserver

 @publishedAll

 @released

 */

 class CAnimationDataProvider : public CBase

 	{

 public:

     IMPORT_C void SetObserver(MAnimationDataProviderObserver* aObserver);

     /** Called from the animation when it is ready to begin receiving data. */

     virtual void StartL() = 0;

     /** Called from the animation to obtain the type of data to expect.

     @return An 8 bit identifier string*/

     virtual TPtrC8 DataType() = 0;

 protected:

 	IMPORT_C CAnimationDataProvider();

 	IMPORT_C virtual void CAnimationDataProvider_Reserved1();

 	IMPORT_C virtual void CAnimationDataProvider_Reserved2();

     IMPORT_C void SendEventL(TInt aEvent);

     IMPORT_C void SendEventL(TInt aEvent, TInt aData);

     IMPORT_C void SendEventL(TInt aEvent, TAny* aData, TInt aDataSize);

 protected: 

 	/** Reserved for future use */

 	TInt iCAnimationDataProvider_Reserved;

 	/** The destination to send data to. Usually an animation class. */

 	MAnimationDataProviderObserver* iObserver;

 	};

 #endif // __ANIMATIONDATAPROVIDER_H__