ref: 3316938ae4ef66da2ae39267ffa7b8d5371066cb
dir: /codec/encoder/core/inc/extern.h/
/*! * \copy * Copyright (c) 2009-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 extern.h * * \brief extern interfaces between core and plus of wels encoder * * \date 4/21/2009 Created * ************************************************************************************* */ #if !defined(WELS_ENCODER_EXTERN_H__) #define WELS_ENCODER_EXTERN_H__ #include "typedefs.h" #include "encoder_context.h" namespace WelsSVCEnc { /*! * \brief initialize source picture body * \param kpSrc SSourcePicture* * \param kiCsp internal csp format * \param kiWidth widht of picture in pixels * \param kiHeight height of picture in pixels * \return successful - 0; otherwise none 0 for failed */ int32_t InitPic (const void* kpSrc, const int32_t kiCsp, const int32_t kiWidth, const int32_t kiHeight); /* * SVC core encoder external interfaces */ /*! * \brief validate checking in parameter configuration * \pParam pParam SWelsSvcCodingParam* * \return successful - 0; otherwise none 0 for failed */ int32_t ParamValidationExt (void* pParam); // GOM based RC related for uiSliceNum decision void GomValidCheck (const int32_t kiMbWidth, const int32_t kiMbHeight, int32_t* pSliceNum); /*! * \brief initialize Wels avc encoder core library * \param ppCtx sWelsEncCtx** * \param para SWelsSvcCodingParam* * \return successful - 0; otherwise none 0 for failed */ int32_t WelsInitEncoderExt (sWelsEncCtx** ppCtx, SWelsSvcCodingParam* pPara); /*! * \brief uninitialize Wels encoder core library * \param pEncCtx sWelsEncCtx* * \return none */ void WelsUninitEncoderExt (sWelsEncCtx** ppCtx); /*! * \brief core svc encoding process * * \param h sWelsEncCtx*, encoder context * \param dst FrameBSInfo* * \param pSrc SSourcePicture* for need_ds = true or SSourcePicture** for need_ds = false * \param kiConfiguredLayerNum =1 in case need_ds = true or >1 in case need_ds = false * \param need_ds Indicate whether need down sampling desired * [NO in picture list case, YES in console aplication based] * \return EFrameType (WELS_FRAME_TYPE_IDR/WELS_FRAME_TYPE_I/WELS_FRAME_TYPE_P) */ int32_t WelsEncoderEncodeExt (sWelsEncCtx*, void* pDst, const SSourcePicture** kppSrcList, const int32_t kiConfiguredLayerNum); int32_t WelsEncoderEncodeParameterSets (sWelsEncCtx* pCtx, void* pDst); /* * Force coding IDR as follows */ int32_t ForceCodingIDR (sWelsEncCtx* pCtx); /*! * \brief Wels SVC encoder parameters adjustment * SVC adjustment results in new requirement in memory blocks adjustment */ int32_t WelsEncoderParamAdjust (sWelsEncCtx** ppCtx, SWelsSvcCodingParam* pNew); void WelsEncoderApplyFrameRate (SWelsSvcCodingParam* pParam); void WelsEncoderApplyBitRate(SWelsSvcCodingParam* pParam); int32_t FilterLTRRecoveryRequest (sWelsEncCtx* pCtx, SLTRRecoverRequest* pLTRRecoverRequest); void FilterLTRMarkingFeedback (sWelsEncCtx* pCtx, SLTRMarkingFeedback* pLTRMarkingFeedback); } #endif//WELS_ENCODER_CALLBACK_H__