1.1 --- a/epoc32/include/animationdataprovider.h	Tue Nov 24 13:55:44 2009 +0000
     1.2 +++ b/epoc32/include/animationdataprovider.h	Tue Mar 16 16:12:26 2010 +0000
     1.3 @@ -1,1 +1,66 @@
     1.4 -animationdataprovider.h
     1.5 +// Copyright (c) 2004-2009 Nokia Corporation and/or its subsidiary(-ies).
     1.6 +// All rights reserved.
     1.7 +// This component and the accompanying materials are made available
     1.8 +// 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
     1.9 +// which accompanies this distribution, and is available
    1.10 +// at the URL "http://www.symbianfoundation.org/legal/licencesv10.html".
    1.11 +//
    1.12 +// Initial Contributors:
    1.13 +// Nokia Corporation - initial contribution.
    1.14 +//
    1.15 +// Contributors:
    1.16 +//
    1.17 +// Description:
    1.18 +//
    1.19 +
    1.20 +#ifndef __ANIMATIONDATAPROVIDER_H__
    1.21 +#define __ANIMATIONDATAPROVIDER_H__
    1.22 +
    1.23 +#include <e32std.h>
    1.24 +#include <animationframe.h>
    1.25 +
    1.26 +class MAnimationDataProviderObserver;
    1.27 +
    1.28 +_LIT8(KUndefinedAnimationDataType, "undefined");
    1.29 +
    1.30 +/**
    1.31 +Pure virtual base class for data providers.
    1.32 +
    1.33 +A data provider takes an animation specification (such as a file), converts
    1.34 +it (if needed) into a format recognised by an animator (such as CAnimationFrame
    1.35 +objects), and passes it to the animator, via the medium of an animation.
    1.36 +
    1.37 +Most animation types take a data provider as an argument during contruction.
    1.38 +For more detailed usage instructions, refer to the documentation of the derived
    1.39 +classes.
    1.40 +
    1.41 +@see CAnimation
    1.42 +@see MAnimationDataProviderObserver
    1.43 +@publishedAll
    1.44 +@released
    1.45 +*/
    1.46 +class CAnimationDataProvider : public CBase
    1.47 +	{
    1.48 +public:
    1.49 +    IMPORT_C void SetObserver(MAnimationDataProviderObserver* aObserver);
    1.50 +    /** Called from the animation when it is ready to begin receiving data. */
    1.51 +    virtual void StartL() = 0;
    1.52 +    /** Called from the animation to obtain the type of data to expect.
    1.53 +    @return An 8 bit identifier string*/
    1.54 +    virtual TPtrC8 DataType() = 0;
    1.55 +protected:
    1.56 +	IMPORT_C CAnimationDataProvider();
    1.57 +	IMPORT_C virtual void CAnimationDataProvider_Reserved1();
    1.58 +	IMPORT_C virtual void CAnimationDataProvider_Reserved2();
    1.59 +
    1.60 +    IMPORT_C void SendEventL(TInt aEvent);
    1.61 +    IMPORT_C void SendEventL(TInt aEvent, TInt aData);
    1.62 +    IMPORT_C void SendEventL(TInt aEvent, TAny* aData, TInt aDataSize);
    1.63 +protected: 
    1.64 +	/** Reserved for future use */
    1.65 +	TInt iCAnimationDataProvider_Reserved;
    1.66 +	/** The destination to send data to. Usually an animation class. */
    1.67 +	MAnimationDataProviderObserver* iObserver;
    1.68 +	};
    1.69 +
    1.70 +#endif // __ANIMATIONDATAPROVIDER_H__