/*

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

* Header for picture header decoding functions.

*

*/

#ifndef _DECPICH_H_

#define _DECPICH_H_

/*

 * Includes

 */

#include "core.h"

#include "biblin.h"

/*

 * Defines

 */

// unify error codes

#define DPH_OK            H263D_OK  /* everything ok */

#define DPH_OK_BUT_BIT_ERROR     H263D_OK_BUT_BIT_ERROR  /* bitstream corruption was detected */

#define DPH_OK_BUT_NOT_CODED     H263D_OK_BUT_NOT_CODED  /* the VOP is not_coded: no video data sent, 

                                       only the timestamp -> skip the frame */

#define DPH_ERR         H263D_ERROR /* a general error */

#define DPH_ERR_NO_INTRA H263D_ERROR_NO_INTRA /* no INTRA frame has been received */

#define DPH_ERR_FORMAT_CHANGE H263D_ERROR /* picture size change in bitstream */

/*

 * Structs and typedefs

 */

/* {{-output"dphInParam_t_info.txt" -ignore"*" -noCR}}

   This structure is used to pass input parameters to

   the dphGetPictureHeader function.

   {{-output"dphInParam_t_info.txt"}} */

/* {{-output"dphInParam_t.txt"}} */

typedef struct {

   int numStuffBits;             /* Number of stuffing bits before PSC */

   int fReadBits;                /* 0, if picture header should not be read (use previous 

                                    picture header but decode it using dphGetPictureHeader) */

   int fNeedDecodedFrame;                                    

} dphInParam_t;

/* {{-output"dphInParam_t.txt"}} */

/* {{-output"dphInOutParam_t_info.txt" -ignore"*" -noCR}}

   This structure is used to pass input parameters to

   the dphGetPictureHeader function. The function may modify

   the parameters (or the structures pointed by the parameters).

   {{-output"dphInOutParam_t_info.txt"}} */

/* {{-output"dphInOutParam_t.txt"}} */

typedef struct {

   vdcInstance_t *vdcInstance;   /* Video Decoder Core instance */

   bibBuffer_t *inBuffer;        /* Bit Buffer instance */

   bibBuffer_t *outBuffer;        /* Out Bit Buffer instance data */

} dphInOutParam_t;

/* {{-output"dphInOutParam_t.txt"}} */

/* {{-output"dphOutParam_t_info.txt" -ignore"*" -noCR}}

   The dphGetPictureHeader function uses this structure to return

   output parameters.

   {{-output"dphOutParam_t_info.txt"}} */

/* {{-output"dphOutParam_t.txt"}} */

typedef struct {

   int pquant;                   /* Initial quantizer */

   int trp;                      /* Temporal Reference for Prediction,

                                    -1 if not indicated in the bitstream */

   u_char *currYFrame;           /* Memory buffer for new Y frame */

   u_char *currUFrame;           /* Memory buffer for new U frame */

   u_char *currVFrame;           /* Memory buffer for new V frame */

   u_char *currYBFrame;          /* New Y frame of B part of PB-frame */

   u_char *currUBFrame;          /* New U frame of B part of PB-frame */

   u_char *currVBFrame;          /* New V frame of B part of PB-frame */

} dphOutParam_t;

/* {{-output"dphOutParam_t.txt"}} */

/*

 * Function prototypes

 */

int dphGetPictureHeader(

   const dphInParam_t *inParam,

   dphInOutParam_t *inOutParam,

   dphOutParam_t *outParam,

   int *bitErrorIndication);

int dphGetSEI(

   vdcInstance_t *vdcInstance,   /* Video Decoder Core instance */

   bibBuffer_t *inBuffer,        /* Bit Buffer instance */

   int *bitErrorIndication);

class CMPEG4Transcoder;

int dphGetMPEGVolHeader(dphInOutParam_t *inOutParam, CMPEG4Transcoder *hTranscoder);

int dphGetMPEGVopHeader(

   const dphInParam_t *inParam,

   dphInOutParam_t *inOutParam,

   dphOutParam_t *outParam,

   int *bitErrorIndication);

#endif

// End of file