x265-1.7版本-common/frame.cpp注释

最新推荐文章于 2022-09-09 02:19:32 发布

cabbage2008

最新推荐文章于 2022-09-09 02:19:32 发布

阅读量1.1w

点赞数 1

分类专栏： x265代码注释

本文链接：https://blog.csdn.net/cabbage2008/article/details/50564495

版权

x265代码注释专栏收录该内容

74 篇文章 53 订阅

订阅专栏

注：问号以及未注释部分会在x265-1.8版本内更新

/*****************************************************************************
* Copyright (C) 2013 x265 project
*
* Author: Steve Borho <steve@borho.org>
*
* This program is free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation; either version 2 of the License, or
* (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with this program; if not, write to the Free Software
* Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02111, USA.
*
* This program is also available under a commercial proprietary license.
* For more information, contact us at license @ x265.com.
*****************************************************************************/

#include "common.h"
#include "frame.h"
#include "picyuv.h"
#include "framedata.h"

using namespace x265;

/** 函数功能    ：初始化Frmae
/*  调用范围    ：只在Encoder::encode函数中被调用
* \返回值       ：null **/
Frame::Frame()
{
    m_bChromaExtended = false;
    m_lowresInit = false;
    m_reconRowCount.set(0);
    m_countRefEncoders = 0;
    m_encData = NULL;
    m_reconPic = NULL;
    m_next = NULL;
    m_prev = NULL;
    m_param = NULL;
    memset(&m_lowres, 0, sizeof(m_lowres));
}

/** 函数功能    ：申请原始帧m_fencPic与1/2下采样帧空间并将其初始化
/*  调用范围    ：只在Encoder::encode函数中被调用
* \返回值       ：申请空间成功为ture，否则为false
*/
bool Frame::create(x265_param *param)
{
    m_fencPic = new PicYuv;
    m_param = param;

    return m_fencPic->create(param->sourceWidth, param->sourceHeight, param->internalCsp) &&
           m_lowres.create(m_fencPic, param->bframes, !!param->rc.aqMode); //申请原始帧m_fencPic与1/2下采样帧空间并将其初始化
}
/** 函数功能    ：申请重构帧内存并初始化为0，申请一帧CTU的存储空间，初始化CTU、初始化统计信息
/*  调用范围    ：只在Encoder::encode函数中被调用
* \返回值       ：申请空间成功为ture，否则为false
*/
bool Frame::allocEncodeData(x265_param *param, const SPS& sps)
{
    m_encData = new FrameData;//实例化
    m_reconPic = new PicYuv; //实例化
    m_encData->m_reconPic = m_reconPic;//获取存储重构帧的指针
    bool ok = m_encData->create(param, sps) && m_reconPic->create(param->sourceWidth, param->sourceHeight, param->internalCsp);//申请内存空间
    if (ok)
    {
        /* initialize right border of m_reconpicYuv as SAO may read beyond the
         * end of the picture accessing uninitialized pixels */
        int maxHeight = sps.numCuInHeight * g_maxCUSize;
        memset(m_reconPic->m_picOrg[0], 0, sizeof(pixel) * m_reconPic->m_stride * maxHeight);
        memset(m_reconPic->m_picOrg[1], 0, sizeof(pixel) * m_reconPic->m_strideC * (maxHeight >> m_reconPic->m_vChromaShift));
        memset(m_reconPic->m_picOrg[2], 0, sizeof(pixel) * m_reconPic->m_strideC * (maxHeight >> m_reconPic->m_vChromaShift));
    }
    return ok;
}

/* prepare to re-use a FrameData instance to encode a new picture */
void Frame::reinit(const SPS& sps)
{
    m_bChromaExtended = false;
    m_reconPic = m_encData->m_reconPic;
    m_encData->reinit(sps);
}

/** 函数功能    ：释放内存
/*  调用范围    ：只在Encoder::encode、Lookahead::destroy()和~DPB()函数中被调用
* \返回值       ：null
*/
void Frame::destroy()
{
    //在Encoder::encode 申请内存失败时才会调用
    //在Lookahead::destroy()中：
    //在~DPB()中：
    if (m_encData)
    {
        m_encData->destroy();
        delete m_encData;
        m_encData = NULL;
    }

    if (m_fencPic)
    {
        m_fencPic->destroy();
        delete m_fencPic;
        m_fencPic = NULL;
    }

    if (m_reconPic)
    {
        m_reconPic->destroy();
        delete m_reconPic;
        m_reconPic = NULL;
    }

    m_lowres.destroy();
}