--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/multimediacommscontroller/mmccfilesourcesink/inc/mccfilesource.h Tue Feb 02 01:04:58 2010 +0200
@@ -0,0 +1,368 @@
+/*
+* Copyright (c) 2006 Nokia Corporation and/or its subsidiary(-ies).
+* All rights reserved.
+* This component and the accompanying materials are made available
+* under the terms of "Eclipse Public License v1.0"
+* which accompanies this distribution, and is available
+* at the URL "http://www.eclipse.org/legal/epl-v10.html".
+*
+* Initial Contributors:
+* Nokia Corporation - initial contribution.
+*
+* Contributors:
+*
+* Description:
+*
+*/
+
+
+
+// INCLUDES
+#ifndef MCCFILESOURCE_H
+#define MCCFILESOURCE_H
+
+#include <e32std.h>
+#include "mccdatasource.h"
+
+
+class CMccFileSourceImpl;
+class TMccFileSourceSetting;
+
+/**
+*
+*/
+class CMccFileSource: public CMccDataSource
+ {
+
+ public: // Methods called internally or by the controller
+
+ /**
+ * Two-phased constructor.
+ */
+ static MDataSource* NewSourceL( TUid aImplementationUid,
+ const TDesC8& aInitData );
+
+ void ConstructSourceL ( const TDesC8& aInitData );
+
+ CMccFileSource();
+
+ virtual ~CMccFileSource();
+
+ public: // From CMccDataSource
+
+ virtual void GetParameterL( TUint32 aParam, TDes8& aVal );
+
+ virtual void SetParameterL( TUint32 aParam, const TDesC8& aVal );
+
+ public:
+
+ /**
+ * Opens a 3GP file for streaming
+ * @since SWIS Lite
+ * @param TFileName aFileName
+ */
+ virtual void OpenFileL( TFileName aFileName, TBool aFileChangeMode = EFalse );
+
+ /**
+ * Closes the 3GP file
+ * @since SWIS Lite
+ */
+ virtual void CloseFileL();
+
+ /**
+ * Gets filename
+ */
+ TFileName& FileNameL();
+
+ /**
+ * Seeks to given position in a file
+ * @since SWIS Lite
+ * @param TTimeIntervalMicroSeconds aPosition
+ */
+ virtual void SetPositionL( TTimeIntervalMicroSeconds aPosition );
+
+ /**
+ * Returns the current video framerate
+ * @since SWIS Lite
+ * @return TReal32
+ */
+ virtual TReal VideoFrameRateL();
+
+ /**
+ * Returns the current audio bitrate
+ * @since SWIS Lite
+ * @return TUint
+ */
+ virtual TUint32 AudioBitRateL();
+
+ /**
+ * Returns the duration of media clip
+ * @since SWIS Lite
+ * @return TTimeIntervalMicroSeconds
+ */
+ virtual TTimeIntervalMicroSeconds DurationL();
+
+ /**
+ * Returns the video framesize
+ * @since SWIS Lite
+ * @return TSize
+ */
+ virtual TSize VideoFrameSizeL();
+
+ /**
+ * Returns the video bitrate
+ * @since SWIS Lite
+ * @return TUint
+ */
+ virtual TUint32 VideoBitRateL();
+
+ /**
+ * Returns the current reading position
+ * @since SWIS Lite
+ * @return TTimeIntervalMicroSeconds
+ */
+ virtual TTimeIntervalMicroSeconds PositionL();
+
+ /**
+ * Returns the audio fourCC
+ * @return TFourCC
+ */
+ virtual TFourCC AudioFourCCL();
+
+ /**
+ * Returns the video fourCC
+ * @return TFourCC
+ */
+ virtual TFourCC VideoFourCCL();
+
+ private: // From MDataSource
+
+ /**
+ * Reads audio frames from file
+ * @since SWIS Lite
+ * @param
+ * @return
+ */
+ void ReadAudioFrameL();
+
+ /**
+ * Reads one video frame from file
+ * @since SWIS Lite
+ * @param
+ * @return
+ */
+ void ReadVideoFrameL();
+
+ //\// Callback functions for timers
+ /**
+ * Callback function for periodic timer
+ * @since SWIS Lite
+ * @param TAny*
+ * @return TInt
+ */
+ static TInt TickAudio( TAny* aObject );
+
+ /**
+ * Callback function for periodic timer
+ * @since SWIS Lite
+ * @param TAny*
+ * @return TInt
+ */
+ static TInt TickVideo( TAny* aObject );
+
+ public: // From MDataSource
+
+ /**
+ * From MDataSource. Returns the data type as a fourCC code of the data source.
+ *
+ * @since Series 60 3.0
+ * @param "aMediaId"
+ * This identifies the type of media eg audio or video and the stream id.
+ * Only KUidMediaTypeAudio -mediatype is supported.
+ * @return The fourCC code identifying the source datatype for the specified aMediaId.
+ */
+ TFourCC SourceDataTypeCode( TMediaId /*aMediaId*/ );
+
+ /**
+ * From MDataSource. Sets the data type as a fourCC code for the data source
+ *
+ * @since Series 60 3.0
+ * @param "aSourceFourCC"
+ * This specifies the data type as a fourCC code to set the source to.
+ *
+ * @param "aMediaId"
+ * This identifies the type of media eg audio or video and the stream id.
+ * Only KUidMediaTypeAudio -mediatype is supported.
+ *
+ * @return KErrNone if successful, KErrNotSupported if the source does not support having
+ * it's data type set, otherwise a system wide error code.
+ */
+ TInt SetSourceDataTypeCode( TFourCC aCodec,
+ TMediaId aMedia );
+
+ /**
+ * From MDataSource. Not used. Leaves with KErrNotSupported.
+ *
+ * @since Series 60 3.0
+ * @param "aBuffer"
+ * The buffer that has been emptied by a data sink and is now available for reuse
+ * @return None
+ */
+ void BufferEmptiedL( CMMFBuffer* aBuffer );
+
+ /**
+ * From MDataSource. Method to indicate whether the data source can create a buffer.
+ *
+ * @since Series 60 3.0
+ *
+ * @return EFalse
+ */
+ TBool CanCreateSourceBuffer();
+
+ /**
+ * From MDataSource. Not used. Leaves with KErrNotSupported.
+ *
+ * @since Series 60 3.0
+ * @param "aMediaId"
+ * This identifies the type of media eg audio or video and the stream id.
+ * This parameter is required in cases where the source can supply data
+ * of more than one media type and/or multiple strams of data eg a multimedia file.
+ *
+ * @param "aReference"
+ * This must be written to by the method to indicate whether the created buffer is
+ * a 'reference' buffer. A 'reference' buffer is a buffer that is owned by the source
+ * and should be used in preference to the sink buffer provided the sink buffer
+ * is also not a reference buffer.
+ * .
+ * @return The created buffer
+ */
+ CMMFBuffer* CreateSourceBufferL( TMediaId,
+ TBool& aReference );
+
+ /**
+ * From MDataSource. Method to 'logon' the data source to the same thread that source will be supplying data in.
+ *
+ * Jitterbuffer for incoming packets and downlink timeout timer are created here.
+ *
+ * @param "aEventHandler"
+ * This is an MAsyncEventHandler to handle asynchronous events that occur during the
+ * transfer of multimedia data. The event handler must be in the same thread as the data transfer
+ * thread - hence the reason it is passed in the SourceThreadLogon as opposed to say the constructor.
+ *
+ *
+ * @return KErrNone if successful, otherwise a system wide error code.
+ */
+ TInt SourceThreadLogon( MAsyncEventHandler& aEventHandler );
+
+ /**
+ * From MDataSource. Method to 'logoff' the data source from the same thread that source supplies data in.
+ *
+ * Jitterbuffer for incoming packets and downlink timeout timer are deleted. Datasource deletes the
+ * stream(s) and unregisters itself as an observer for the RTP session for incoming RTP and RTCP packets.
+ *
+ * @return None
+ */
+ void SourceThreadLogoff();
+
+ /**
+ * From MDataSource. Method to 'prime' the data source.
+ *
+ * Datasource is set to primed state.
+ *
+ * @since Series 60 3.0
+ * @return None
+ */
+ void SourcePrimeL();
+
+ /**
+ * From MDataSource. Method to 'play' the data source.
+ *
+ * Downlink timeout timer is started and datasource is set to playing state.
+ *
+ * @since Series 60 3.0
+ * @return None
+ */
+ void SourcePlayL();
+
+ /**
+ * From MDataSource. Method to 'pause' the data source.
+ *
+ * Downlink timeout timer is stopped and datasource is set to paused state.
+ *
+ * @since Series 60 3.0
+ * @return None
+ */
+ void SourcePauseL();
+
+ /**
+ * From MDataSource. Method to 'stop' the data source.
+ *
+ * Downlink timeout timer is stopped and datasource is set to stopped state.
+ *
+ * @since Series 60 3.0
+ * @return None
+ */
+ void SourceStopL();
+
+ /**
+ * From MDataSource. Method called by a MDataSink to request the data source to fill aBuffer with data.
+ *
+ * Datasource gets packet from jitterbuffer and forwards it to the payloadformatdecoder
+ * for further processing. Datasource works synchronously; consumers BufferFilledL
+ * is called when RTP packet is got succesfully from jitterbuffer.
+ *
+ * @since Series 60 3.0
+ * @param "aBuffer"
+ * The buffer that needs filling with data
+ *
+ * @param "aConsumer"
+ * The data sink that consumes the data. The data source needs this to make the BufferFilledL
+ * callback on aConsumer when the data source has completed filling the aBuffer.
+ *
+ * @param "aMediaId"
+ * This identifies the type of media eg audio or video and the stream id.
+ * This parameter is required in cases where the source can supply data
+ * of more than one media type and/or multiple strams of data eg a multimedia file.
+ * @return None
+ */
+ void FillBufferL( CMMFBuffer* aBuffer,
+ MDataSink* aConsumer,
+ TMediaId aMediaId );
+
+ /**
+ * From MDataSource
+ */
+ void NegotiateSourceL( MDataSink& aDataSink );
+
+ private:
+
+ /**
+ * Updates the current reading position
+ * @since SWIS Lite
+ * @param
+ */
+ void UpdatePositionL();
+
+ /**
+ * Returns the frame lenght from given audio sample
+ * @since SWIS Lite
+ */
+ TUint GetFrameLength( TPtrC8 aData );
+
+ void GetFileInfoL( TMccFileSourceSetting& aSettings );
+
+ private:
+
+ CMccFileSourceImpl* iSourceImpl;
+ #ifdef EUNIT_TEST
+ friend class UT_CMccFileSource;
+ friend class UT_CMccMultiplexer;
+ #endif
+
+ };
+
+
+#endif
+
+
+// End of file
\ No newline at end of file