/*
* Copyright (c) 2010 Ixonos Plc.
* All rights reserved.
* This component and the accompanying materials are made available
* under the terms of the "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:
* Ixonos Plc
*
* Description:  
* A header file defining the AVC editing API.
*                
*
*/



#ifndef VEDAVCEDIT_H
#define VEDAVCEDIT_H

#include <e32base.h>

/**
*  CVedAVCEdit abstract base class for AVC editing class
*
*  @lib vedAVCEdit
*  @since
*/
class CVedAVCEdit : public CBase
    {

    public:  // Constants

    public:  // Constructors and destructor        	

        /**
        * Two-phased constructor.
        *
        */
        IMPORT_C static CVedAVCEdit* NewL();
        
        /**
        * Destructor.
        */
        virtual ~CVedAVCEdit();

    public:  // New functions
    
    	/*
        * Add MDF specific NAL headers to input AVC frame
        * 
        * @param aBuf Input/output buffer
        * @param aFrameLen Input/output frame length
        * @param aDecInfoSize Decoder specific info size
        * @param aFirstFrame ETrue for first frame in sequence
        */                
	    virtual void ProcessAVCBitStreamL(TDes8& aBuf, TInt& aFrameLen, TInt aDecInfoSize, TBool aFirstFrame) = 0;		

 	    /*
        * Calculate default value for no. of buffered frames according to 
        * H.264 spec Annex A
        * 
        * @param aLevel AVC level
        * @param aResolution Video resolution        
        */
	    virtual TInt GetMaxAVCFrameBuffering(TInt aLevel, TSize aResolution) = 0;
	    
	    /*
        * Get input bitstream level from SPS. Note: SPS Nal unit must be at the 
        * beginning of the input buffer
        * 
        * @param aBuf Input buffer containing SPS
        * @param aLevel Output: Baseline profile level
        */        
        virtual TInt GetLevel(TDesC8& aBuf, TInt& aLevel) = 0;
                
        /*
        * Get input bitstream video resolution from SPS. Note: SPS Nal unit must 
        * be at the beginning of the input buffer
        * 
        * @param aBuf        Input buffer containing SPS
        * @param aResolution Output: Resolution
        */        
        virtual TInt GetResolution(TDesC8& aBuf, TSize& aResolution) = 0;
     
#ifdef VIDEOEDITORENGINE_AVC_EDITING

        /*
        * Convert AVC specific decoder config info to AVCDecoderConfigurationRecord -format
        * 
        * @param aSrcBuf Source buffer containing SPS/PPS NAL units in AVC MDF buffer format
        * @param aDstBuf Destination buffer for AVCDecoderConfigurationRecord        
        */        
        virtual void ConvertAVCHeaderL(TDesC8& aSrcBuf, TDes8& aDstBuf ) = 0;	    

	    /*
        * Save SPS/PPS NAL units from AVCDecoderConfigurationRecord
        * for later use
        *  
        * @param aBuf Input buffer containing AVCDecoderConfigurationRecord        
        */                
	    virtual void SaveAVCDecoderConfigurationRecordL(TDes8& aBuf, TBool aFromEncoder) = 0;	    
	    
	    /*
        * Update slice header information: frame number and PPS id        
        * 
        * @param aBuf Buffer containing input frame
        * @param aContainsDCR ETrue if AVC decoder config. record is included
        * @param aFromEncoder ETrue if frame comes from the encoder
        */	    
        virtual TInt ParseFrame(HBufC8*& aBuf, TBool aContainsDCR, TBool aFromEncoder) = 0;
        
        /*
        * Constructs AVCDecoderConfigurationRecord for the whole sequence, taking
        * into account all input DCR's        
        *  
        * @param aDstBuf Destination buffer for AVCDecoderConfigurationRecord        
        * @param aLevel Level output sequence    
        */      
        virtual void ConstructAVCDecoderConfigurationRecordL( TDes8& aDstBuf ) = 0;

        /*
        * Set length of NAL size field of output sequence
        * 
        * @param aSize Length of size field in bytes        
        */	    
        virtual void SetNALLengthSize( TInt aSize ) = 0;
        
        /*
        * Set output level for constructing AVCDecoderConfigurationRecord
        * 
        * @param aLevel Output level
        */	   
        virtual void SetOutputLevel(TInt aLevel) = 0;
        
        /*
        * Check if encoding is required until the next IDR unit
        * 
        */	   
        virtual TBool EncodeUntilIDR() = 0;
        
        /*
        * Check if NAL unit is an IDR NAL
        * 
        * @param aNalBuf buffer containing NAL unit
        */	   
        virtual TBool IsNALUnitIDR( TDes8& aNalBuf ) = 0;
        
        /*
        * Store PPS id from the current slice
        * 
        * @param aNalBuf buffer containing NAL unit
        */	   
		virtual void StoreCurrentPPSId( TDes8& aNalBuf ) = 0;

        /*
        * Generate a not coded frame
        * 
        * @param aNalBuf buffer containing NAL unit
        */	   
		virtual TInt GenerateNotCodedFrame( TDes8& aNalBuf, TUint aFrameNumber ) = 0;

        /*
        * Modify the frame number of the NAL unit
        * 
        * @param aNalBuf buffer containing NAL unit
        */	   
		virtual void ModifyFrameNumber( TDes8& aNalBuf, TUint aFrameNumber ) = 0;
#endif

};


#endif

// End of File