307 lines
10 KiB
C++
307 lines
10 KiB
C++
/*!
|
|
* \copy
|
|
* Copyright (c) 2004-2013, Cisco Systems
|
|
* All rights reserved.
|
|
*
|
|
* Redistribution and use in source and binary forms, with or without
|
|
* modification, are permitted provided that the following conditions
|
|
* are met:
|
|
*
|
|
* * Redistributions of source code must retain the above copyright
|
|
* notice, this list of conditions and the following disclaimer.
|
|
*
|
|
* * Redistributions in binary form must reproduce the above copyright
|
|
* notice, this list of conditions and the following disclaimer in
|
|
* the documentation and/or other materials provided with the
|
|
* distribution.
|
|
*
|
|
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
|
|
* "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
|
|
* LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
|
|
* FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
|
|
* COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
|
|
* INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
|
|
* BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
|
|
* LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
|
|
* CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
|
|
* LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
|
|
* ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
|
|
* POSSIBILITY OF SUCH DAMAGE.
|
|
*
|
|
*
|
|
* \file : IWelsVP.h
|
|
*
|
|
* \brief : Interface of wels video processor class
|
|
*
|
|
* \date : 2011/01/04
|
|
*
|
|
* \description : 1. should support both C/C++ style interface
|
|
* 2. should concern with the feature extension requirement
|
|
* 3. should care the usage of "char"==>
|
|
* 1) value char : signed char/unsigned char
|
|
* 2) string char : char
|
|
*
|
|
*************************************************************************************
|
|
*/
|
|
|
|
#ifndef IWELSVP_H_
|
|
#define IWELSVP_H_
|
|
|
|
#define WELSVP_MAJOR_VERSION 1
|
|
#define WELSVP_MINOR_VERSION 1
|
|
#define WELSVP_VERSION ((WELSVP_MAJOR_VERSION << 8) + WELSVP_MINOR_VERSION)
|
|
|
|
typedef enum {
|
|
RET_SUCCESS = 0,
|
|
RET_FAILED = -1,
|
|
RET_INVALIDPARAM = -2,
|
|
RET_OUTOFMEMORY = -3,
|
|
RET_NOTSUPPORTED = -4,
|
|
RET_UNEXPECTED = -5,
|
|
RET_NEEDREINIT = -6
|
|
} EResult;
|
|
|
|
typedef enum {
|
|
VIDEO_FORMAT_NULL = 0, /* invalid format */
|
|
/*rgb color formats*/
|
|
VIDEO_FORMAT_RGB = 1, /* rgb 24bits */
|
|
VIDEO_FORMAT_RGBA = 2, /* rgba */
|
|
VIDEO_FORMAT_RGB555 = 3, /* rgb555 */
|
|
VIDEO_FORMAT_RGB565 = 4, /* rgb565 */
|
|
VIDEO_FORMAT_BGR = 5, /* bgr 24bits */
|
|
VIDEO_FORMAT_BGRA = 6, /* bgr 32bits */
|
|
VIDEO_FORMAT_ABGR = 7, /* abgr */
|
|
VIDEO_FORMAT_ARGB = 8, /* argb */
|
|
|
|
/*yuv color formats*/
|
|
VIDEO_FORMAT_YUY2 = 20, /* yuy2 */
|
|
VIDEO_FORMAT_YVYU = 21, /* yvyu */
|
|
VIDEO_FORMAT_UYVY = 22, /* uyvy */
|
|
VIDEO_FORMAT_I420 = 23, /* yuv 4:2:0 planar */
|
|
VIDEO_FORMAT_YV12 = 24, /* yuv 4:2:0 planar */
|
|
VIDEO_FORMAT_INTERNAL = 25, /* Only Used for SVC decoder testbed */
|
|
VIDEO_FORMAT_NV12 = 26, /* y planar + uv packed */
|
|
VIDEO_FORMAT_I422 = 27, /* yuv 4:2:2 planar */
|
|
VIDEO_FORMAT_I444 = 28, /* yuv 4:4:4 planar */
|
|
VIDEO_FORMAT_YUYV = 20, /* yuv 4:2:2 packed */
|
|
|
|
VIDEO_FORMAT_RGB24 = 1,
|
|
VIDEO_FORMAT_RGB32 = 2,
|
|
VIDEO_FORMAT_RGB24_INV = 5,
|
|
VIDEO_FORMAT_RGB32_INV = 6,
|
|
VIDEO_FORMAT_RGB555_INV = 7,
|
|
VIDEO_FORMAT_RGB565_INV = 8,
|
|
VIDEO_FORMAT_YUV2 = 21,
|
|
VIDEO_FORMAT_420 = 23,
|
|
|
|
VIDEO_FORMAT_VFlip = 0x80000000
|
|
} EVideoFormat;
|
|
|
|
typedef enum {
|
|
BUFFER_HOSTMEM = 0,
|
|
BUFFER_SURFACE
|
|
} EPixMapBufferProperty;
|
|
|
|
typedef struct {
|
|
int iRectTop;
|
|
int iRectLeft;
|
|
int iRectWidth;
|
|
int iRectHeight;
|
|
} SRect;
|
|
|
|
typedef struct {
|
|
void* pPixel[3];
|
|
int iSizeInBits;
|
|
int iStride[3];
|
|
SRect sRect;
|
|
EVideoFormat eFormat;
|
|
EPixMapBufferProperty eProperty;//not use? to remove? but how about the size of SPixMap?
|
|
} SPixMap;
|
|
|
|
typedef enum {
|
|
METHOD_NULL = 0,
|
|
METHOD_COLORSPACE_CONVERT ,//not support yet
|
|
METHOD_DENOISE ,
|
|
METHOD_SCENE_CHANGE_DETECTION_VIDEO ,
|
|
METHOD_SCENE_CHANGE_DETECTION_SCREEN ,
|
|
METHOD_DOWNSAMPLE ,
|
|
METHOD_VAA_STATISTICS ,
|
|
METHOD_BACKGROUND_DETECTION ,
|
|
METHOD_ADAPTIVE_QUANT ,
|
|
METHOD_COMPLEXITY_ANALYSIS ,
|
|
METHOD_IMAGE_ROTATE ,
|
|
METHOD_MASK
|
|
} EMethods;
|
|
|
|
//-----------------------------------------------------------------//
|
|
// Algorithm parameters define
|
|
//-----------------------------------------------------------------//
|
|
|
|
typedef enum {
|
|
SIMILAR_SCENE, //similar scene
|
|
MEDIUM_CHANGED_SCENE, //medium changed scene
|
|
LARGE_CHANGED_SCENE, //large changed scene
|
|
} ESceneChangeIdc;
|
|
|
|
typedef enum {
|
|
NO_STATIC, // motion block
|
|
COLLOCATED_STATIC, // collocated static block
|
|
SCROLLED_STATIC, // scrolled static block
|
|
} EStaticBlockIdc;
|
|
|
|
typedef struct {
|
|
ESceneChangeIdc eSceneChangeIdc; // SIMILAR_SCENE, MEDIUM_CHANGED_SCENE, LARGE_CHANGED_SCENE
|
|
int iMotionBlockNum; // Number of motion blocks
|
|
int iFrameComplexity; // frame complexity
|
|
unsigned char * pStaticBlockIdc; // static block idc
|
|
} SSceneChangeResult;
|
|
|
|
typedef struct {
|
|
unsigned char* pCurY; // Y data of current frame
|
|
unsigned char* pRefY; // Y data of pRef frame for diff calc
|
|
int (*pSad8x8)[4]; // sad of 8x8, every 4 in the same 16x16 get together
|
|
int* pSsd16x16; // sum of square difference of 16x16
|
|
int* pSum16x16; // sum of 16x16
|
|
int* pSumOfSquare16x16; // sum of square of 16x16
|
|
int (*pSumOfDiff8x8)[4];
|
|
unsigned char (*pMad8x8)[4];
|
|
int iFrameSad; // sad of frame
|
|
} SVAACalcResult;
|
|
|
|
typedef struct {
|
|
int iCalcVar;
|
|
int iCalcBgd;
|
|
int iCalcSsd;
|
|
int iReserved;
|
|
SVAACalcResult* pCalcResult;
|
|
} SVAACalcParam;
|
|
|
|
typedef struct {
|
|
signed char* pBackgroundMbFlag;
|
|
SVAACalcResult* pCalcRes;
|
|
} SBGDInterface;
|
|
|
|
typedef enum {
|
|
AQ_QUALITY_MODE, //Quality mode
|
|
AQ_BITRATE_MODE, //Bitrate mode
|
|
} EAQModes;
|
|
|
|
typedef struct {
|
|
unsigned short uiMotionIndex;
|
|
unsigned short uiTextureIndex;
|
|
} SMotionTextureUnit;
|
|
|
|
typedef struct {
|
|
int iAdaptiveQuantMode; // 0:quality mode, 1:bitrates mode
|
|
SVAACalcResult* pCalcResult;
|
|
SMotionTextureUnit* pMotionTextureUnit;
|
|
|
|
signed char* pMotionTextureIndexToDeltaQp;
|
|
double dAverMotionTextureIndexToDeltaQp;
|
|
} SAdaptiveQuantizationParam;
|
|
|
|
typedef enum {
|
|
FRAME_SAD = 0,
|
|
GOM_SAD = -1,
|
|
GOM_VAR = -2
|
|
} EComplexityAnalysisMode;
|
|
|
|
typedef struct
|
|
{
|
|
int iScrollMvX;
|
|
int iScrollMvY;
|
|
bool bScrollDetectFlag; // 0:false ; 1:ltr; 2: scene change
|
|
} SScrollDetectionResult;
|
|
|
|
typedef struct {
|
|
int iComplexityAnalysisMode;
|
|
int iCalcBgd;
|
|
int iMbNumInGom;
|
|
int iFrameComplexity;
|
|
int* pGomComplexity;
|
|
int* pGomForegroundBlockNum;
|
|
signed char* pBackgroundMbFlag;
|
|
unsigned int* uiRefMbType;
|
|
SVAACalcResult* pCalcResult;
|
|
} SComplexityAnalysisParam;
|
|
|
|
typedef struct
|
|
{
|
|
int iMbRowInGom;
|
|
int *pGomComplexity;
|
|
int iGomNumInFrame;
|
|
int iFrameComplexity;
|
|
int iIdrFlag;
|
|
SScrollDetectionResult sScrollResult;
|
|
} SComplexityAnalysisScreenParam;
|
|
/////////////////////////////////////////////////////////////////////////////////////////////
|
|
|
|
typedef struct {
|
|
void* pCtx;
|
|
EResult (*Init) (void* pCtx, int iType, void* pCfg);
|
|
EResult (*Uninit) (void* pCtx, int iType);
|
|
EResult (*Flush) (void* pCtx, int iType);
|
|
EResult (*Process) (void* pCtx, int iType, SPixMap* pSrc, SPixMap* dst);
|
|
EResult (*Get) (void* pCtx, int iType, void* pParam);
|
|
EResult (*Set) (void* pCtx, int iType, void* pParam);
|
|
EResult (*SpecialFeature) (void* pCtx, int iType, void* pIn, void* pOut);
|
|
} IWelsVPc;
|
|
|
|
#if defined(__cplusplus) && !defined(CINTERFACE) /* C++ style interface */
|
|
|
|
class IWelsVP {
|
|
public:
|
|
virtual ~IWelsVP() {}
|
|
|
|
public:
|
|
virtual EResult Init (int iType, void* pCfg) = 0;
|
|
virtual EResult Uninit (int iType) = 0;
|
|
virtual EResult Flush (int iType) = 0;
|
|
virtual EResult Process (int iType, SPixMap* pSrc, SPixMap* dst) = 0;
|
|
virtual EResult Get (int iType, void* pParam) = 0;
|
|
virtual EResult Set (int iType, void* pParam) = 0;
|
|
virtual EResult SpecialFeature (int iType, void* pIn, void* pOut) = 0;
|
|
};
|
|
|
|
/* Recommend to invoke the interface via the micro for convenient */
|
|
#define IWelsVPFunc_Init(p, a, b) (p)->Init(a, b)
|
|
#define IWelsVPFunc_Uninit(p, a) (p)->Uninit(a)
|
|
#define IWelsVPFunc_Flush(p, a) (p)->Flush(a)
|
|
#define IWelsVPFunc_Process(p, a, b, c) (p)->Process(a, b, c)
|
|
#define IWelsVPFunc_Get(p, a, b) (p)->Get(a, b)
|
|
#define IWelsVPFunc_Set(p, a, b) (p)->Set(a, b)
|
|
#define IWelsVPFunc_SpecialFeature(p, a, b, c) (p)->SpecialFeature(a, b, c)
|
|
|
|
/* C++ interface version */
|
|
#define WELSVP_INTERFACE_VERION (0x8000 + (WELSVP_VERSION & 0x7fff))
|
|
#define WELSVP_EXTERNC_BEGIN extern "C" {
|
|
#define WELSVP_EXTERNC_END }
|
|
|
|
#else /* C style interface */
|
|
|
|
/* Recommend to invoke the interface via the micro for convenient */
|
|
#define IWelsVPFunc_Init(p, a, b) (p)->Init(p->h, a, b)
|
|
#define IWelsVPFunc_Uninit(p, a) (p)->Uninit(p->h, a)
|
|
#define IWelsVPFunc_Flush(p, a) (p)->Flush(p->h, a)
|
|
#define IWelsVPFunc_Process(p, a, b, c) (p)->Process(p->h, a, b, c)
|
|
#define IWelsVPFunc_Get(p, a, b) (p)->Get(p->h, a, b)
|
|
#define IWelsVPFunc_Set(p, a, b) (p)->Set(p->h, a, b)
|
|
#define IWelsVPFunc_SpecialFeature(p, a, b, c) (p)->SpecialFeature(p->h, a, b, c)
|
|
|
|
/* C interface version */
|
|
#define WELSVP_INTERFACE_VERION (0x0001 + (WELSVP_VERSION & 0x7fff))
|
|
#define WELSVP_EXTERNC_BEGIN
|
|
#define WELSVP_EXTERNC_END
|
|
|
|
#endif
|
|
|
|
WELSVP_EXTERNC_BEGIN
|
|
EResult CreateVpInterface (void** ppCtx, int iVersion /*= WELSVP_INTERFACE_VERION*/);
|
|
EResult DestroyVpInterface (void* pCtx , int iVersion /*= WELSVP_INTERFACE_VERION*/);
|
|
WELSVP_EXTERNC_END
|
|
|
|
//////////////////////////////////////////////////////////////////////////////////////////////
|
|
#endif // IWELSVP_H_
|
|
|
|
|