imp_encoder.h

Go to the documentation of this file.

/*
 * IMP Encoder func header file.
 *
 * Copyright (C) 2014 Ingenic Semiconductor Co.,Ltd
 */

#ifndef __IMP_ENCODER_H__
#define __IMP_ENCODER_H__

#include <stdint.h>
#include <stdbool.h>

#ifdef __cplusplus
#if __cplusplus
extern "C"
{
#endif
#endif /* __cplusplus */

typedef enum {
        ENC_RC_MODE_FIXQP               = 0,    
        ENC_RC_MODE_CBR                 = 1,    
        ENC_RC_MODE_VBR                 = 2,    
        ENC_RC_MODE_SMART               = 3,    
        ENC_RC_MODE_INV                 = 4,    
} IMPEncoderRcMode;

typedef struct {
        uint32_t        frmRateNum;                             
        uint32_t        frmRateDen;                             
} IMPEncoderFrmRate;

typedef struct {
        uint32_t                        qp;                     
} IMPEncoderAttrH264FixQP;

typedef struct {
        uint32_t                        maxQp;                  
        uint32_t                        minQp;                  
        uint32_t                        outBitRate;             
        int                                     iBiasLvl;               
        uint32_t                        frmQPStep;              
        uint32_t                        gopQPStep;              
        bool                            adaptiveMode;   
        bool                            gopRelation;    
} IMPEncoderAttrH264CBR;

typedef struct {
        uint32_t                        maxQp;                  
        uint32_t                        minQp;                  
        uint32_t                        staticTime;             
        uint32_t                        maxBitRate;             
    int32_t             iBiasLvl;       
        uint32_t                        changePos;              
    uint32_t            qualityLvl;     
        uint32_t                        frmQPStep;              
        uint32_t                        gopQPStep;              
        bool                            gopRelation;    
} IMPEncoderAttrH264VBR;

typedef struct {
        uint32_t                        maxQp;                  
        uint32_t                        minQp;                  
        uint32_t                        staticTime;             
        uint32_t                        maxBitRate;             
    int32_t             iBiasLvl;       
        uint32_t                        changePos;              
    uint32_t            qualityLvl;     
        uint32_t                        frmQPStep;              
        uint32_t                        gopQPStep;              
        bool                            gopRelation;    
} IMPEncoderAttrH264Smart;

typedef struct {
        bool                            enable;                 
        bool                            isAutoMode;             
        int                             demaskCnt;              
        int                             demaskThresd;           
} IMPEncoderAttrDemask;

typedef struct {
        bool                            enable;                 
        int                                     dnType;                 
        int                                     dnIQp;                  
        int                                     dnPQp;                  
} IMPEncoderAttrDenoise;

typedef enum {
        ENC_FRM_BYPASS  = 0,            
        ENC_FRM_REUSED  = 1,            
        ENC_FRM_SKIP    = 2,            
} EncFrmUsedMode;

typedef struct {
        bool                            enable;                 
        EncFrmUsedMode          frmUsedMode;    
        uint32_t                        frmUsedTimes;   
} IMPEncoderAttrFrmUsed;

typedef enum {
        IMP_Encoder_STYPE_N1X                   = 0,    
        IMP_Encoder_STYPE_N2X                   = 1,    
        IMP_Encoder_STYPE_N4X                   = 2,    
        IMP_Encoder_STYPE_HN1_FALSE     = 3,    
        IMP_Encoder_STYPE_HN1_TRUE              = 4,    
        IMP_Encoder_STYPE_H1M_FALSE     = 5,    
        IMP_Encoder_STYPE_H1M_TRUE              = 6,    
} IMPSkipType;

typedef enum {
        IMP_Encoder_FSTYPE_IDR          = 0,    
        IMP_Encoder_FSTYPE_LBASE        = 1,    
        IMP_Encoder_FSTYPE_SBASE        = 2,    
        IMP_Encoder_FSTYPE_ENHANCE      = 3,    
} IMPRefType;

typedef struct {
        IMPSkipType     skipType;       
        int                     m;                                      
        int                     n;                                      
        int                     maxSameSceneCnt;        
        int                     bEnableScenecut;        
        int                     bBlackEnhance;          
} IMPEncoderAttrHSkip;

typedef struct {
        IMPEncoderAttrHSkip     hSkipAttr;      
        IMPSkipType                     maxHSkipType;
} IMPEncoderAttrInitHSkip;

typedef struct {
        IMPEncoderRcMode rcMode;                                                
        union {
                IMPEncoderAttrH264FixQP  attrH264FixQp;         
                IMPEncoderAttrH264CBR    attrH264Cbr;           
                IMPEncoderAttrH264VBR    attrH264Vbr;           
                IMPEncoderAttrH264Smart  attrH264Smart;         
        };
} IMPEncoderAttrRcMode;

typedef struct {
    IMPEncoderFrmRate           outFrmRate;                     
    uint32_t                            maxGop;                 
    IMPEncoderAttrRcMode        attrRcMode;     
        IMPEncoderAttrFrmUsed       attrFrmUsed;        
        IMPEncoderAttrDemask        attrDemask;         
        IMPEncoderAttrDenoise       attrDenoise;        
        IMPEncoderAttrInitHSkip     attrHSkip;          
} IMPEncoderRcAttr;

typedef enum {
        IMP_H264_NAL_UNKNOWN    = 0,    
        IMP_H264_NAL_SLICE              = 1,    
        IMP_H264_NAL_SLICE_DPA  = 2,    
        IMP_H264_NAL_SLICE_DPB  = 3,    
        IMP_H264_NAL_SLICE_DPC  = 4,    
        IMP_H264_NAL_SLICE_IDR  = 5,    
        IMP_H264_NAL_SEI                = 6,    
        IMP_H264_NAL_SPS                = 7,    
        IMP_H264_NAL_PPS                = 8,    
        IMP_H264_NAL_AUD                = 9,    
        IMP_H264_NAL_FILLER             = 12,   
} IMPEncoderH264NaluType;

typedef union {
        IMPEncoderH264NaluType          h264Type;               
} IMPEncoderDataType;

typedef struct {
        uint32_t        phyAddr;                        
        uint32_t        virAddr;                        
        uint32_t        length;                         
        int64_t         timestamp;                      
        bool            frameEnd;                       
        IMPEncoderDataType      dataType;               
} IMPEncoderPack;

typedef struct {
        IMPEncoderPack  *pack;                          
        uint32_t        packCount;                      
        uint32_t        seq;                            
        union {
                IMPRefType refType;             
        };
} IMPEncoderStream;

typedef struct {
    bool        enable;                 
    uint32_t    x;                      
    uint32_t    y;                      
    uint32_t    w;                      
    uint32_t    h;                      
} IMPEncoderCropCfg;

typedef struct {
        uint32_t                        maxUserDataCnt;         
        uint32_t                        maxUserDataSize;        
} IMPEncoderUserDataCfg;

typedef struct {
        IMPPayloadType                  enType;                 
        uint32_t                                bufSize;                
        uint32_t                                profile;                
        uint32_t                                picWidth;               
        uint32_t                                picHeight;              
        IMPEncoderCropCfg               crop;                   
        IMPEncoderUserDataCfg   userData;               
} IMPEncoderAttr;

typedef struct {
        IMPEncoderAttr          encAttr;        
        IMPEncoderRcAttr        rcAttr;         
} IMPEncoderCHNAttr;

typedef struct {
        bool            registered;                     
        uint32_t        leftPics;                       
        uint32_t        leftStreamBytes;                
        uint32_t        leftStreamFrames;               
        uint32_t        curPacks;                       
        uint32_t        work_done;                      
} IMPEncoderCHNStat;

typedef struct {
    bool        enable;                 
} IMPEncoderColor2GreyCfg;

typedef struct {
    bool        enable;                 
} IMPEncoderEnIDRCfg;

typedef struct {
        int             gopsize;                
} IMPEncoderGOPSizeCfg;

typedef struct {
        uint32_t        u32Index;       
        bool            bEnable;        
        bool            bRelatedQp;     
        int             s32Qp;          
        IMPRect         rect;           
} IMPEncoderROICfg;

typedef enum {
    IMP_RC_SUPERFRM_NONE        = 0,    
    IMP_RC_SUPERFRM_DISCARD     = 1,    
    IMP_RC_SUPERFRM_REENCODE    = 2,    
    IMP_RC_SUPERFRM_BUTT        = 3,
} IMPEncoderSuperFrmMode;

typedef enum {
    IMP_RC_PRIORITY_RDO                 = 0,    
    IMP_RC_PRIORITY_BITRATE_FIRST       = 1,    
    IMP_RC_PRIORITY_FRAMEBITS_FIRST     = 2,    
    IMP_RC_PRIORITY_BUTT                = 3,
} IMPEncoderRcPriority;

typedef struct {
    IMPEncoderSuperFrmMode      superFrmMode;       
    uint32_t                    superIFrmBitsThr;   
    uint32_t                    superPFrmBitsThr;   
    uint32_t                    superBFrmBitsThr;   
    IMPEncoderRcPriority        rcPriority;         
} IMPEncoderSuperFrmCfg;

typedef struct {
    uint32_t    intraTransMode;             
    uint32_t    interTransMode;             
    bool        bScalingListValid;          
    uint8_t     interScalingList8X8[64];    
    uint8_t     intraScalingList8X8[64];    
    int         chroma_qp_index_offset;     
} IMPEncoderH264TransCfg;

typedef struct {
    bool user_ql_en;
    uint8_t qmem_table[256];
} IMPEncoderJpegeQl;

int IMP_Encoder_CreateGroup(int encGroup);

int IMP_Encoder_DestroyGroup(int encGroup);

int IMP_Encoder_CreateChn(int encChn, const IMPEncoderCHNAttr *attr);

int IMP_Encoder_DestroyChn(int encChn);

int IMP_Encoder_GetChnAttr(int encChn, IMPEncoderCHNAttr * const attr);

int IMP_Encoder_RegisterChn(int encGroup, int encChn);
int IMP_Encoder_UnRegisterChn(int encChn);

int IMP_Encoder_StartRecvPic(int encChn);

int IMP_Encoder_StopRecvPic(int encChn);

int IMP_Encoder_Query(int encChn, IMPEncoderCHNStat *stat);

int IMP_Encoder_GetStream(int encChn, IMPEncoderStream *stream, bool blockFlag);

int IMP_Encoder_ReleaseStream(int encChn, IMPEncoderStream *stream);

int IMP_Encoder_PollingStream(int encChn, uint32_t timeoutMsec);

int IMP_Encoder_SetMaxStreamCnt(int encChn, int nrMaxStream);

int IMP_Encoder_GetMaxStreamCnt(int encChn, int *nrMaxStream);

int IMP_Encoder_RequestIDR(int encChn);

int IMP_Encoder_FlushStream(int encChn);

int IMP_Encoder_SetChnColor2Grey(int encChn, const IMPEncoderColor2GreyCfg *pstColor2Grey);

int IMP_Encoder_GetChnColor2Grey(int encChn, IMPEncoderColor2GreyCfg *pstColor2Grey);

int IMP_Encoder_SetChnAttrRcMode(int encChn, const IMPEncoderAttrRcMode *pstRcModeCfg);

int IMP_Encoder_GetChnAttrRcMode(int encChn, IMPEncoderAttrRcMode *pstRcModeCfg);

int IMP_Encoder_SetChnFrmRate(int encChn, const IMPEncoderFrmRate *pstFps);

int IMP_Encoder_GetChnFrmRate(int encChn, IMPEncoderFrmRate *pstFps);

int IMP_Encoder_SetChnROI(int encChn, const IMPEncoderROICfg *pstVencRoiCfg);

int IMP_Encoder_GetChnROI(int encChn, IMPEncoderROICfg *pstVencRoiCfg);

int IMP_Encoder_GetGOPSize(int encChn, IMPEncoderGOPSizeCfg *pstGOPSizeCfg);

int IMP_Encoder_SetGOPSize(int encChn, const IMPEncoderGOPSizeCfg *pstGOPSizeCfg);

int IMP_Encoder_SetChnDemask(int encChn, const IMPEncoderAttrDemask *pdemaskAttr);

int IMP_Encoder_GetChnDemask(int encChn, IMPEncoderAttrDemask *pdemaskAttr);

int IMP_Encoder_SetChnFrmUsedMode(int encChn, const IMPEncoderAttrFrmUsed *pfrmUsedAttr);

int IMP_Encoder_GetChnFrmUsedMode(int encChn, IMPEncoderAttrFrmUsed *pfrmUsedAttr);

int IMP_Encoder_SetChnDenoise(int encChn, const IMPEncoderAttrDenoise *pdenoiseAttr);

int IMP_Encoder_GetChnDenoise(int encChn, IMPEncoderAttrDenoise *pdenoiseAttr);

int IMP_Encoder_SetChnHSkip(int encChn, const IMPEncoderAttrHSkip *phSkipAttr);

int IMP_Encoder_GetChnHSkip(int encChn, IMPEncoderAttrHSkip *phSkipAttr);

int IMP_Encoder_SetChnHSkipBlackEnhance(int encChn, const int bBlackEnhance);

int IMP_Encoder_InsertUserData(int encChn, void *userData, uint32_t userDataLen);

int IMP_Encoder_SetFisheyeEnableStatus(int encChn, int enable);

int IMP_Encoder_GetFisheyeEnableStatus(int encChn, int *enable);

int IMP_Encoder_SetChangeRef(int encChn, int bEnable);

int IMP_Encoder_GetChangeRef(int encChn, int *bEnable);

int IMP_Encoder_SetMbRC(int encChn, int bEnable);

int IMP_Encoder_GetMbRC(int encChn, int *bEnable);

int IMP_Encoder_SetSuperFrameCfg(int encChn, const IMPEncoderSuperFrmCfg *pstSuperFrmParam);

int IMP_Encoder_GetSuperFrameCfg(int encChn, IMPEncoderSuperFrmCfg *pstSuperFrmParam);

int IMP_Encoder_SetH264TransCfg(int encChn, const IMPEncoderH264TransCfg *pstH264TransCfg);

int IMP_Encoder_GetH264TransCfg(int encChn, IMPEncoderH264TransCfg *pstH264TransCfg);

int IMP_Encoder_SetJpegeQl(int encChn, const IMPEncoderJpegeQl *pstJpegeQl);

int IMP_Encoder_GetJpegeQl(int encChn, IMPEncoderJpegeQl *pstJpegeQl);

#ifdef __cplusplus
#if __cplusplus
}
#endif
#endif /* __cplusplus */

#endif /* __IMP_ENCODER_H__ */