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