multimediacommsengine/mmceshared/inc/mcecomvideocodec.h
changeset 0 1bce908db942
child 49 64c62431ac08
equal deleted inserted replaced
-1:000000000000 0:1bce908db942
       
     1 /*
       
     2 * Copyright (c) 2005 Nokia Corporation and/or its subsidiary(-ies).
       
     3 * All rights reserved.
       
     4 * This component and the accompanying materials are made available
       
     5 * under the terms of "Eclipse Public License v1.0"
       
     6 * which accompanies this distribution, and is available
       
     7 * at the URL "http://www.eclipse.org/legal/epl-v10.html".
       
     8 *
       
     9 * Initial Contributors:
       
    10 * Nokia Corporation - initial contribution.
       
    11 *
       
    12 * Contributors:
       
    13 *
       
    14 * Description:    
       
    15 *
       
    16 */
       
    17 
       
    18 
       
    19 
       
    20 
       
    21 #ifndef CMCECOMVIDEOCODEC_H
       
    22 #define CMCECOMVIDEOCODEC_H
       
    23 
       
    24 //  INCLUDES
       
    25 #include "mcecomcodec.h"
       
    26     
       
    27     
       
    28 // FUNCTION PROTOTYPES
       
    29 
       
    30 // CLASS DECLARATION
       
    31 /**
       
    32 *  Container class for the codec information.
       
    33 *
       
    34 *  @lib 
       
    35 *  @since
       
    36 */
       
    37 class CMceComVideoCodec : public CMceComCodec
       
    38     {
       
    39 		
       
    40 public:  // Constructors and destructor
       
    41 
       
    42     /**
       
    43     * Two-phased constructor.
       
    44     * @param aSdpName sdp name
       
    45     */
       
    46     static CMceComVideoCodec* NewL( TBuf8<KMceMaxSdpNameLength> aSdpName );
       
    47     
       
    48     /**
       
    49     * Two-phased constructor.
       
    50     * @param aSdpName sdp name
       
    51     */
       
    52     static CMceComVideoCodec* NewLC( TBuf8<KMceMaxSdpNameLength> aSdpName );
       
    53     
       
    54     /**
       
    55     * Destructor.
       
    56     */
       
    57     ~CMceComVideoCodec();
       
    58 
       
    59 
       
    60 public: // from CMceComCodec
       
    61 
       
    62     /**
       
    63     * Internalizes flat data
       
    64     * @param aReadStream read stream
       
    65     */
       
    66     void InternalizeFlatL( RReadStream& aReadStream );
       
    67 
       
    68     /**
       
    69     * Externalizes flat data
       
    70     * @param aWriteStream write stream
       
    71     */
       
    72     void ExternalizeFlatL( RWriteStream& aWriteStream );
       
    73 
       
    74     /**
       
    75     * Updates this object
       
    76     * @param aUpdate object updates this
       
    77     */
       
    78     void UpdateL( CMceComCodec& aCodec );
       
    79 
       
    80     /**
       
    81     * Returns max bit rate
       
    82     * @return max bit rate
       
    83     */
       
    84     TUint GetMaxBitRate();
       
    85 
       
    86     static TInt CompareSdpIndex( const CMceComVideoCodec& aIndex1, 
       
    87                                  const CMceComVideoCodec& aIndex2 );
       
    88                                  
       
    89 public: //new functions 
       
    90     
       
    91     /**
       
    92     * Clones
       
    93     */
       
    94     virtual CMceComVideoCodec* CloneL();
       
    95 
       
    96     /**
       
    97     * Sets maximum bitrate of the codec.
       
    98     * @param aMaxBitrate value of maximum bitrate used for encoding
       
    99     * @return KErrNotSupported if codec doesn't support bitrate
       
   100     *         values issued
       
   101     */
       
   102     virtual TInt SetMaxBitrate( TUint aMaxBitrate );
       
   103 
       
   104     /**
       
   105     * Factory
       
   106     * @return factory
       
   107     */
       
   108     static TMceComVideoCodecFactory Factory();
       
   109     
       
   110     /**
       
   111     * Set codec config key
       
   112     * @param aConfigKey can be also NULL, ownership is not transferred
       
   113     * @return ETrue if key was set, otherwise EFalse (input key not valid or
       
   114     *   same key was set already)
       
   115     */
       
   116     TBool SetConfigKeyL( HBufC8* aConfigKey );
       
   117     
       
   118     TBool IsConfigKeyValid() const;
       
   119     
       
   120     static TBool IsConfigKeyValid( HBufC8* aConfigKey );
       
   121 
       
   122     
       
   123 #ifdef MCE_COMMON_SERVER_SIDE
       
   124 
       
   125 public:     
       
   126 
       
   127     /**
       
   128     * Assigns mcc codec
       
   129     * @param aMccCodec mcc codec
       
   130     * @return assigned codecs
       
   131     */
       
   132     CMceComCodec& operator=( CMccCodecInformation& aMccCodec );
       
   133 
       
   134     /**
       
   135     * Decodes to mcc codec
       
   136     * @param aMccCodec mcc codec
       
   137     */
       
   138     void DoMccDecodeL( CMccCodecInformation& aMccCodec );
       
   139 
       
   140     /**
       
   141     * Encodes from mcc codec
       
   142     * @param aMccCodec mcc codec
       
   143     * @param aStream stream
       
   144     */
       
   145     void DoMccEncodeL( CMccCodecInformation& aMccCodec,
       
   146                        CMceSrvStream& aStream );
       
   147     
       
   148     /**
       
   149     * Validates codec values based on mcc codec
       
   150     * @param aMccCodec mcc codec
       
   151     * @param aStream stream
       
   152     * @param aRole role
       
   153     */
       
   154     CMceComCodec* DoMccValidateL( CMccCodecInformation& aMccCodec,
       
   155                                   CMceSrvStream& aStream,
       
   156                                   TMceNegotiationRole aRole );
       
   157                                
       
   158     /**
       
   159     * Adjust codec values based on mcc codec
       
   160     * @param aMccCodec mcc codec
       
   161     * @param aStream stream
       
   162     */
       
   163     void DoMccAdjustL( CMccCodecInformation& aMccCodec, 
       
   164                                CMceSrvStream& aStream );
       
   165                              
       
   166     /**
       
   167     * Checks, if signalling is required
       
   168     * @param aStream stream
       
   169     * @param aMccCurentCodec current mcc codec
       
   170     * @param aMccUpdateCodec to be used mcc codec
       
   171     */
       
   172     TInt DoMccRequireSignalling( 
       
   173                                 const CMceSrvStream& aStream,
       
   174                                 const CMccCodecInformation& aMccCurentCodec, 
       
   175                                 const CMccCodecInformation& aMccUpdateCodec ) const;
       
   176     
       
   177 protected: // from CMceComCodec
       
   178     
       
   179     /**
       
   180     * Set default fmtp line
       
   181     */                                    
       
   182     void DoSetDefaultFmtpAttributeL(); 
       
   183     
       
   184 #endif//MCE_COMMON_SERVER_SIDE
       
   185   
       
   186 protected:
       
   187 
       
   188     /**
       
   189     * C++ default constructor.
       
   190     */
       
   191     CMceComVideoCodec();
       
   192     
       
   193      /**
       
   194      * second-phase copy constructor
       
   195      */
       
   196 	void ConstructL( CMceComVideoCodec& aCodec );
       
   197     
       
   198     
       
   199     /**
       
   200      * second-phase copy constructor
       
   201      */
       
   202 	void ConstructL( TBuf8<KMceMaxSdpNameLength> aSdpName );
       
   203     
       
   204         
       
   205         
       
   206 public:  // Owned serialized Data
       
   207 
       
   208     TReal iFrameRate;
       
   209     TUint iMaxBitRate;
       
   210     TUint iAllowedResolutions;
       
   211     TInt iResolutionWidth;
       
   212     TInt iResolutionHeight;
       
   213     TUint iAllowedFrameRates;
       
   214     TUint iClockRate;
       
   215     TReal iReceiveFrameRate;
       
   216     HBufC8* iConfigKey;
       
   217 	TUid iEncodingDecodingDevice;
       
   218 	
       
   219     };
       
   220 
       
   221 
       
   222 
       
   223 #endif // CMCECOMVIDEOCODEC_H
       
   224 
       
   225 // End of File