--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/multimediacommscontroller/mmccvideosourcesink/inc/mccvideosource.h Tue Feb 02 01:04:58 2010 +0200
@@ -0,0 +1,328 @@
+/*
+* 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 MCCVIDEOSOURCE_H
+#define MCCVIDEOSOURCE_H
+
+#include <e32std.h>
+#include "mccdatasource.h"
+#include "mccinternalcodecs.h"
+
+class CMccVideoSourceImpl;
+class CMccFileSourceImpl;
+class TMccCodecInfo;
+class MMccCameraHandler;
+
+// CLASS DECLARATIONS
+
+/**
+* Helper class to contain user information
+*/
+class TMccVideoSourceUser
+ {
+ public:
+
+ TMccVideoSourceUser( MAsyncEventHandler* aEventHandler ) :
+ iEventHandler( aEventHandler ),
+ iCodecInfo(),
+ iReserved1( 0 ),
+ iReserved2( 0 )
+ {
+ }
+
+ public:
+ MAsyncEventHandler* iEventHandler;
+ TMccCodecInfo iCodecInfo;
+ TUint32 iReserved1;
+ TUint32 iReserved2;
+ };
+
+/**
+* Video source is used to get video data from camera.
+*
+*/
+class CMccVideoSource: 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 );
+
+ CMccVideoSource();
+
+ virtual ~CMccVideoSource();
+
+ public: // new
+
+ virtual void SetCameraHandler( MMccCameraHandler& aCameraHandler );
+
+ virtual TInt CameraIndex() const;
+
+ virtual void SetVideoCodecL( const TMccCodecInfo& aVideoCodec );
+
+ virtual void GetVideoCodecL( TMccCodecInfo& aVideoCodec );
+
+ virtual void GetSupportedVideoCodecsL( RArray<TFourCC>& aVideoTypes );
+
+ virtual void SetAudioCodecL( const TMccCodecInfo& aAudioCodec );
+
+ virtual void GetAudioCodecL( TMccCodecInfo& aAudioCodec );
+
+ virtual void GetSupportedAudioCodecsL( RArray<TFourCC>& aAudioTypes );
+
+ virtual void SetAudioEnabledL( TBool aEnabled );
+
+ virtual TBool AudioEnabledL() const;
+
+ virtual void SetGainL( TInt aGain );
+
+ virtual TInt GainL() const;
+
+ virtual TInt MaxGainL() const;
+
+ public: // From MMccSourceSink
+
+ virtual TInt AddUser( MAsyncEventHandler* aUser );
+
+ virtual void RemoveUser( MAsyncEventHandler* aUser );
+
+ virtual void SetCurrentUser( MAsyncEventHandler* aUser );
+
+ virtual void UpdateL( const TDesC8& aVal );
+
+ virtual void GetParameterL( TUint32 aParam, TDes8& aVal );
+
+ virtual void SetParameterL( TUint32 aParam, const TDesC8& aVal );
+
+ 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 );
+
+ public: // From MMccRateAdaptationObserver
+
+ TInt RateAdaptationRequest( const TMccEvent& aInputData,
+ TMccEvent& aOutputData );
+
+
+ private:
+
+ void AddUserL( MAsyncEventHandler* aUser );
+
+ TBool MultipleCodecs() const;
+
+ void UpdateCurrentUserL();
+
+ private:
+
+ #if ( ( defined(MCC_VIDEO_SOURCE_FOR_EMU) || defined(_lint) ) && !defined(TEST_EUNIT) )
+ CMccFileSourceImpl* iSourceImpl;
+ #else
+ CMccVideoSourceImpl* iSourceImpl;
+ #endif
+
+ TUint iCameraIndex;
+
+ RPointerArray<TMccVideoSourceUser> iUsers;
+
+ MAsyncEventHandler* iCurrentUser;
+
+ TUint32 iReserved1;
+ TUint32 iReserved2;
+
+ private:
+
+ #ifdef TEST_EUNIT
+ friend class UT_CMccVideoSource;
+ #endif
+
+
+ };
+
+
+#endif
+
+
+// End of file
\ No newline at end of file