diff -r 000000000000 -r 1bce908db942 multimediacommscontroller/mmccvideosourcesink/inc/mccvideosource.h --- /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 +#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& aVideoTypes ); + + virtual void SetAudioCodecL( const TMccCodecInfo& aAudioCodec ); + + virtual void GetAudioCodecL( TMccCodecInfo& aAudioCodec ); + + virtual void GetSupportedAudioCodecsL( RArray& 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 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