/*
* 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: 
*
*/



#ifndef _MP3API_
#define    _MP3API_


#include "defines.h"
#include "mstream.h"





/*
   Purpose:     Structure interface for MP1/2/3 transport stream.
   Explanation: - */
class TMpTransportHandle
{
public:

  TMPEG_Header header;
  TMPEG_Header headerOld;

  int16 SlotTable[15];
  int16 FreeFormatSlots;      /*-- Number of bytes in free format frame.     */

  int16 mainDataSlots;        /*-- Payload size.                             */

  BOOL ms_stereo;             /* MS (Mid/Side) stereo used.                  */
  BOOL is_stereo;             /* Intensity stereo used.                      */
  BOOL lsf;                   /* MPEG-2 LSF stream present.                  */
  BOOL mpeg25;                /* MPEG-2.5 stream present.                    */

  /*-- Transport stream to be used/in use. --*/
  SYNC_STATUS transportType;
  SyncInfo syncInfo;

  /*-- Exec state when seeking next MPx frame. --*/
  int16 offsetBits;
  ExecState execState;

  /*-- CRC codeword. --*/
  TCRC_Check crc;

  /*-- Average number of bytes reserved for each frame. --*/
  int32 aveFrameLen;
  
};


/**
 * Data structure for mp3 frame search.
 */
class TMpFrameState
{
public:
  /**
   * Number of read bytes when searching start of frame. 
   * This value is within the input buffer and also the header
   * is read after start of frame has been found.
   */
  int16 readBytes;

  /**
   * Number of header bytes present for current MP3 frame.
   */
  int16 headerBytes;

  /**
   * Number of payload bytes for current MP3 frame. The total frame
   * size is 'headerBytes' + 'frameBytes'.
   */
  int16 frameBytes;

  /**
   * Total number of bytes read when searching the start of frame.
   */
  int32 totalReadBytes;

};




/*
   Purpose:     Parameters of core engine.
   Explanation: - */
class CMPAudDec : public CBase
{
public:

    IMPORT_C static CMPAudDec* NewL();
    IMPORT_C ~CMPAudDec();
    IMPORT_C void Init(TMpTransportHandle *aMpFileFormat);

    /*-- Common to all layers. --*/
    uint8 *bitReserv;
    TMPEG_Frame *frame;

    /*-- Layer III specific parameters. --*/
    TBitStream br;
    CHuffman *huffman;
    CIII_Side_Info *side_info;

    int16 PrevSlots;
    //int32 FrameStart;
    BOOL SkipBr;
    BOOL WasSeeking;

    /*-- Transport handle. --*/
    TMpTransportHandle *mpFileFormat;

  
private:

    CMPAudDec();
    void ConstructL();

};

class CMp3Edit : public CBase
    {

public:

    IMPORT_C static CMp3Edit* NewL();
    IMPORT_C ~CMp3Edit();

    IMPORT_C uint32
    FileLengthInMs(TMpTransportHandle *tHandle, int32 fileSize) const;

    IMPORT_C int32
    GetSeekOffset(TMpTransportHandle *tHandle, int32 seekPos) const;

    IMPORT_C int32
    GetFrameTime(TMpTransportHandle *tHandle) const;

    IMPORT_C void 
    InitTransport(TMpTransportHandle *tHandle) const;

    IMPORT_C int16
    SeekSync(TMpTransportHandle *tHandle, uint8 *syncBuf, 
            uint32 syncBufLen, int16 *readBytes, 
            int16 *frameBytes, int16 *headerBytes,
            uint8 initMode) const;

    IMPORT_C int16
        FreeMode(TMpTransportHandle *tHandle, uint8 *syncBuf, 
        uint32 syncBufLen, int16 *readBytes, 
        int16 *frameBytes, int16 *headerBytes) const;
    
    IMPORT_C int16
        EstimateBitrate(TMpTransportHandle *tHandle, uint8 isVbr) const;
    



    /*-- Closes MPEG Layer I/II/III decoder handle. --*/
    IMPORT_C CMPAudDec *
        DeleteMPAudDec(CMPAudDec *mpAud);
    
    /*-- Creates MPEG Layer I/II/III decoder handle. --*/
    IMPORT_C CMPAudDec *
        CreateMPAudDec(void);
    
    /*-- Initializes MPEG Layer I/II/III decoder handle. --*/
    IMPORT_C void
        InitMPAudDec(CMPAudDec *mpAud, TMpTransportHandle *mpFileFormat);
    
    /*-- Resets MPEG Layer I/II/III decoder handle. --*/
    IMPORT_C void
        ResetMPAudDec(CMPAudDec *mpAud);
    
    /*-- Stores global gain values. --*/
    IMPORT_C void
        SetMPGlobalGains(TBitStream *bs, uint8 numGains, uint8 *globalGain, uint32 *gainPos);
    
    /*-- Extracts global gain values. --*/
    IMPORT_C uint8
        GetMPGlobalGains(TBitStream *bs, TMpTransportHandle *tHandle, uint8 *globalGain, uint32 *gainPos);

private:
    
    void ConstructL();
    CMp3Edit();

    };


#endif