source: SHVCSoftware/branches/SHM-dev/source/Lib/TLibEncoder/TEncTop.h @ 1005

Last change on this file since 1005 was 978, checked in by nokia, 10 years ago

Implementation of JCTVC-R0071 - IRAP and EOS cross-layer impacts

  • Property svn:eol-style set to native
File size: 17.9 KB
RevLine 
[313]1/* The copyright in this software is being made available under the BSD
2 * License, included below. This software may be subject to other third party
3 * and contributor rights, including patent rights, and no such rights are
4 * granted under this license. 
5 *
[595]6 * Copyright (c) 2010-2014, ITU/ISO/IEC
[313]7 * All rights reserved.
8 *
9 * Redistribution and use in source and binary forms, with or without
10 * modification, are permitted provided that the following conditions are met:
11 *
12 *  * Redistributions of source code must retain the above copyright notice,
13 *    this list of conditions and the following disclaimer.
14 *  * Redistributions in binary form must reproduce the above copyright notice,
15 *    this list of conditions and the following disclaimer in the documentation
16 *    and/or other materials provided with the distribution.
17 *  * Neither the name of the ITU/ISO/IEC nor the names of its contributors may
18 *    be used to endorse or promote products derived from this software without
19 *    specific prior written permission.
20 *
21 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
22 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
23 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
24 * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS
25 * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
26 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
27 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
28 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
29 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
30 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF
31 * THE POSSIBILITY OF SUCH DAMAGE.
32 */
33
34/** \file     TEncTop.h
35    \brief    encoder class (header)
36*/
37
38#ifndef __TENCTOP__
39#define __TENCTOP__
40
41// Include files
42#include "TLibCommon/TComList.h"
43#include "TLibCommon/TComPrediction.h"
44#include "TLibCommon/TComTrQuant.h"
45#include "TLibCommon/AccessUnit.h"
46
47#include "TLibVideoIO/TVideoIOYuv.h"
48
49#include "TEncCfg.h"
50#include "TEncGOP.h"
51#include "TEncSlice.h"
52#include "TEncEntropy.h"
53#include "TEncCavlc.h"
54#include "TEncSbac.h"
55#include "TEncSearch.h"
56#include "TEncSampleAdaptiveOffset.h"
57#include "TEncPreanalyzer.h"
58#include "TEncRateCtrl.h"
59//! \ingroup TLibEncoder
60//! \{
61
62// ====================================================================================================================
63// Class definition
64// ====================================================================================================================
65
66/// encoder class
67class TEncTop : public TEncCfg
68{
69private:
70  // picture
71  Int                     m_iPOCLast;                     ///< time index (POC)
72  Int                     m_iNumPicRcvd;                  ///< number of received pictures
73  UInt                    m_uiNumAllPicCoded;             ///< number of coded pictures
74  TComList<TComPic*>      m_cListPic;                     ///< dynamic list of pictures
[595]75 
[313]76  // encoder search
77  TEncSearch              m_cSearch;                      ///< encoder search class
[540]78  //TEncEntropy*            m_pcEntropyCoder;                     ///< entropy encoder
[313]79  TEncCavlc*              m_pcCavlcCoder;                       ///< CAVLC encoder 
80  // coding tool
81  TComTrQuant             m_cTrQuant;                     ///< transform & quantization class
82  TComLoopFilter          m_cLoopFilter;                  ///< deblocking filter class
83  TEncSampleAdaptiveOffset m_cEncSAO;                     ///< sample adaptive offset class
84  TEncEntropy             m_cEntropyCoder;                ///< entropy encoder
85  TEncCavlc               m_cCavlcCoder;                  ///< CAVLC encoder
86  TEncSbac                m_cSbacCoder;                   ///< SBAC encoder
87  TEncBinCABAC            m_cBinCoderCABAC;               ///< bin coder CABAC
88  TEncSbac*               m_pcSbacCoders;                 ///< SBAC encoders (to encode substreams )
89  TEncBinCABAC*           m_pcBinCoderCABACs;             ///< bin coders CABAC (one per substream)
90 
91  // processing unit
92  TEncGOP                 m_cGOPEncoder;                  ///< GOP encoder
93  TEncSlice               m_cSliceEncoder;                ///< slice encoder
94  TEncCu                  m_cCuEncoder;                   ///< CU encoder
95  // SPS
96  TComSPS                 m_cSPS;                         ///< SPS
97  TComPPS                 m_cPPS;                         ///< PPS
98  // RD cost computation
99  TComBitCounter          m_cBitCounter;                  ///< bit counter for RD optimization
100  TComRdCost              m_cRdCost;                      ///< RD cost computation class
101  TEncSbac***             m_pppcRDSbacCoder;              ///< temporal storage for RD computation
102  TEncSbac                m_cRDGoOnSbacCoder;             ///< going on SBAC model for RD stage
103#if FAST_BIT_EST
104  TEncBinCABACCounter***  m_pppcBinCoderCABAC;            ///< temporal CABAC state storage for RD computation
105  TEncBinCABACCounter     m_cRDGoOnBinCoderCABAC;         ///< going on bin coder CABAC for RD stage
106#else
107  TEncBinCABAC***         m_pppcBinCoderCABAC;            ///< temporal CABAC state storage for RD computation
108  TEncBinCABAC            m_cRDGoOnBinCoderCABAC;         ///< going on bin coder CABAC for RD stage
109#endif
110  Int                     m_iNumSubstreams;                ///< # of top-level elements allocated.
111  TComBitCounter*         m_pcBitCounters;                 ///< bit counters for RD optimization per substream
112  TComRdCost*             m_pcRdCosts;                     ///< RD cost computation class per substream
113  TEncSbac****            m_ppppcRDSbacCoders;             ///< temporal storage for RD computation per substream
114  TEncSbac*               m_pcRDGoOnSbacCoders;            ///< going on SBAC model for RD stage per substream
115  TEncBinCABAC****        m_ppppcBinCodersCABAC;           ///< temporal CABAC state storage for RD computation per substream
116  TEncBinCABAC*           m_pcRDGoOnBinCodersCABAC;        ///< going on bin coder CABAC for RD stage per substream
117
118  // quality control
119  TEncPreanalyzer         m_cPreanalyzer;                 ///< image characteristics analyzer for TM5-step3-like adaptive QP
120
121  TComScalingList         m_scalingList;                 ///< quantization matrix information
122  TEncRateCtrl            m_cRateCtrl;                    ///< Rate control class
123 
124#if SVC_EXTENSION
[595]125  static Int              m_iSPSIdCnt;                    ///< next Id number for SPS   
126  static Int              m_iPPSIdCnt;                    ///< next Id number for PPS   
[313]127  TEncTop**               m_ppcTEncTop;
128  TEncTop*                getLayerEnc(UInt layer)   { return m_ppcTEncTop[layer]; }
129  TComPic*                m_cIlpPic[MAX_NUM_REF];                    ///<  Inter layer Prediction picture =  upsampled picture
130#if REF_IDX_MFM
131  Bool                    m_bMFMEnabledFlag;
132#endif
133  UInt                    m_numScaledRefLayerOffsets;
[540]134#if O0098_SCALED_REF_LAYER_ID
135  UInt                    m_scaledRefLayerId[MAX_LAYERS];
136#endif
[313]137  Window                  m_scaledRefLayerWindow[MAX_LAYERS];
[849]138#if REF_REGION_OFFSET
139  UInt                    m_numRefLayerOffsets;
140  UInt                    m_refLayerId[MAX_LAYERS];
141  Window                  m_refLayerWindow[MAX_LAYERS];
142  Bool                    m_scaledRefLayerOffsetPresentFlag[MAX_LAYERS];
143  Bool                    m_refRegionOffsetPresentFlag[MAX_LAYERS];
144#endif
145#if R0209_GENERIC_PHASE
146  Int                     m_phaseHorLuma  [MAX_LAYERS];
147  Int                     m_phaseVerLuma  [MAX_LAYERS];
148  Int                     m_phaseHorChroma[MAX_LAYERS];
149  Int                     m_phaseVerChroma[MAX_LAYERS];
150  Int                     m_resamplePhaseSetPresentFlag[MAX_LAYERS];
151#endif
[644]152#if P0312_VERT_PHASE_ADJ
153  Bool                    m_vertPhasePositionEnableFlag[MAX_LAYERS];
154#endif
[815]155#if POC_RESET_FLAG || POC_RESET_IDC_ENCODER
[442]156  Int                     m_pocAdjustmentValue;
157#endif
[540]158#if NO_CLRAS_OUTPUT_FLAG
159  Bool                    m_noClrasOutputFlag;
160  Bool                    m_layerInitializedFlag;
161  Bool                    m_firstPicInLayerDecodedFlag;
162  Bool                    m_noOutputOfPriorPicsFlags;
163#endif
[588]164#if O0194_WEIGHTED_PREDICTION_CGS
165  Bool                    m_interLayerWeightedPredFlag;
166#endif
[815]167#if Q0078_ADD_LAYER_SETS
168  int                     m_numAddLayerSets;
169#endif
[903]170#if P0297_VPS_POC_LSB_ALIGNED_FLAG
171  Bool                    m_pocDecrementedInDPBFlag;
172  Int                     m_currPocMsb;
173#endif
[978]174#if R0071_IRAP_EOS_CROSS_LAYER_IMPACTS
175  Bool                    m_prevPicHasEos;
176#endif
[494]177#endif //SVC_EXTENSION
[313]178protected:
179  Void  xGetNewPicBuffer  ( TComPic*& rpcPic );           ///< get picture buffer which will be processed
180  Void  xInitSPS          ();                             ///< initialize SPS from encoder options
181  Void  xInitPPS          ();                             ///< initialize PPS from encoder options
182 
183  Void  xInitPPSforTiles  ();
[442]184  Void  xInitRPS          (Bool isFieldCoding);           ///< initialize PPS from encoder options
185#if SVC_EXTENSION
[595]186  Void  xInitILRP();
[313]187#endif
188public:
189  TEncTop();
190  virtual ~TEncTop();
191 
192  Void      create          ();
193  Void      destroy         ();
[442]194  Void      init            (Bool isFieldCoding);
[313]195  Void      deletePicBuffer ();
196
197  Void      createWPPCoders(Int iNumSubstreams);
198 
199  // -------------------------------------------------------------------------------------------------------------------
200  // member access functions
201  // -------------------------------------------------------------------------------------------------------------------
202 
203  TComList<TComPic*>*     getListPic            () { return  &m_cListPic;             }
204  TEncSearch*             getPredSearch         () { return  &m_cSearch;              }
205 
206  TComTrQuant*            getTrQuant            () { return  &m_cTrQuant;             }
207  TComLoopFilter*         getLoopFilter         () { return  &m_cLoopFilter;          }
208  TEncSampleAdaptiveOffset* getSAO              () { return  &m_cEncSAO;              }
209  TEncGOP*                getGOPEncoder         () { return  &m_cGOPEncoder;          }
210  TEncSlice*              getSliceEncoder       () { return  &m_cSliceEncoder;        }
211  TEncCu*                 getCuEncoder          () { return  &m_cCuEncoder;           }
212  TEncEntropy*            getEntropyCoder       () { return  &m_cEntropyCoder;        }
213  TEncCavlc*              getCavlcCoder         () { return  &m_cCavlcCoder;          }
214  TEncSbac*               getSbacCoder          () { return  &m_cSbacCoder;           }
215  TEncBinCABAC*           getBinCABAC           () { return  &m_cBinCoderCABAC;       }
216  TEncSbac*               getSbacCoders     () { return  m_pcSbacCoders;      }
217  TEncBinCABAC*           getBinCABACs          () { return  m_pcBinCoderCABACs;      }
218 
219  TComBitCounter*         getBitCounter         () { return  &m_cBitCounter;          }
220  TComRdCost*             getRdCost             () { return  &m_cRdCost;              }
221  TEncSbac***             getRDSbacCoder        () { return  m_pppcRDSbacCoder;       }
222  TEncSbac*               getRDGoOnSbacCoder    () { return  &m_cRDGoOnSbacCoder;     }
223  TComBitCounter*         getBitCounters        () { return  m_pcBitCounters;         }
224  TComRdCost*             getRdCosts            () { return  m_pcRdCosts;             }
225  TEncSbac****            getRDSbacCoders       () { return  m_ppppcRDSbacCoders;     }
226  TEncSbac*               getRDGoOnSbacCoders   () { return  m_pcRDGoOnSbacCoders;   }
227  TEncRateCtrl*           getRateCtrl           () { return &m_cRateCtrl;             }
228  TComSPS*                getSPS                () { return  &m_cSPS;                 }
229  TComPPS*                getPPS                () { return  &m_cPPS;                 }
230  Void selectReferencePictureSet(TComSlice* slice, Int POCCurr, Int GOPid );
231  Int getReferencePictureSetIdxForSOP(TComSlice* slice, Int POCCurr, Int GOPid );
232  TComScalingList*        getScalingList        () { return  &m_scalingList;         }
[595]233  // -------------------------------------------------------------------------------------------------------------------
234  // encoder function
235  // -------------------------------------------------------------------------------------------------------------------
236
237  /// encode several number of pictures until end-of-sequence
[313]238#if SVC_EXTENSION
[644]239  Void      setLayerEnc(TEncTop** p)            { m_ppcTEncTop = p;                  }
240  TEncTop** getLayerEnc()                       { return m_ppcTEncTop;               }
241  Int       getPOCLast            ()            { return m_iPOCLast;                 }
242  Int       getNumPicRcvd         ()            { return m_iNumPicRcvd;              }
243  Void      setNumPicRcvd         ( Int num )   { m_iNumPicRcvd = num;               }
244  Void      setNumScaledRefLayerOffsets(Int x)  { m_numScaledRefLayerOffsets = x;    }
245  UInt      getNumScaledRefLayerOffsets()       { return m_numScaledRefLayerOffsets; }
[540]246#if O0098_SCALED_REF_LAYER_ID
[644]247  Void      setScaledRefLayerId(Int x, UInt id) { m_scaledRefLayerId[x] = id;   }
248  UInt      getScaledRefLayerId(Int x)          { return m_scaledRefLayerId[x]; }
249  Window&   getScaledRefLayerWindowForLayer(Int layerId);
[540]250#endif
[644]251  Window&   getScaledRefLayerWindow(Int x)                 { return m_scaledRefLayerWindow[x];        }
[849]252#if REF_REGION_OFFSET
253  Void      setNumRefLayerOffsets(Int x) { m_numRefLayerOffsets = x; }
254  UInt      getNumRefLayerOffsets() { return m_numRefLayerOffsets; }
255  Void      setRefLayerId(Int x, UInt id) { m_refLayerId[x] = id;   }
256  UInt      getRefLayerId(Int x)          { return m_refLayerId[x]; }
257  Window&   getRefLayerWindowForLayer(Int layerId);
258  Window&   getRefLayerWindow(Int x)            { return m_refLayerWindow[x]; }
259  Bool      getScaledRefLayerOffsetPresentFlag(Int x) { return m_scaledRefLayerOffsetPresentFlag[x]; }
260  Void      setScaledRefLayerOffsetPresentFlag(Int x, Bool b) { m_scaledRefLayerOffsetPresentFlag[x] = b; }
261  Bool      getRefRegionOffsetPresentFlag(Int x) { return m_refRegionOffsetPresentFlag[x]; }
262  Void      setRefRegionOffsetPresentFlag(Int x, Bool b) { m_refRegionOffsetPresentFlag[x] = b; }
263#endif
[644]264#if P0312_VERT_PHASE_ADJ
265  Void      setVertPhasePositionEnableFlag(Int x, Bool b)  { m_vertPhasePositionEnableFlag[x] = b;    }
266  UInt      getVertPhasePositionEnableFlag(Int x)          { return m_vertPhasePositionEnableFlag[x]; }
267#endif
[849]268#if R0209_GENERIC_PHASE
269  Int getPhaseHorLuma(Int x) { return m_phaseHorLuma[x]; }
270  Int getPhaseVerLuma(Int x) { return m_phaseVerLuma[x]; }
271  Int getPhaseHorChroma(Int x) { return m_phaseHorChroma[x]; }
272  Int getPhaseVerChroma(Int x) { return m_phaseVerChroma[x]; }
273  Void setPhaseHorLuma(Int x, Int val) { m_phaseHorLuma[x] = val; }
274  Void setPhaseVerLuma(Int x, Int val) { m_phaseVerLuma[x] = val; }
275  Void setPhaseHorChroma(Int x, Int val) { m_phaseHorChroma[x] = val; }
276  Void setPhaseVerChroma(Int x, Int val) { m_phaseVerChroma[x] = val; }
277  Bool getResamplePhaseSetPresentFlag(Int x) { return m_resamplePhaseSetPresentFlag[x]; }
278  Void setResamplePhaseSetPresentFlag(Int x, Bool b) { m_resamplePhaseSetPresentFlag[x] = b; }
279#endif
[644]280
[313]281  TComPic** getIlpList() { return m_cIlpPic; }
282#if REF_IDX_MFM
[644]283  Void      setMFMEnabledFlag       (Bool flag)   { m_bMFMEnabledFlag = flag; }
284  Bool      getMFMEnabledFlag()                   { return m_bMFMEnabledFlag; }   
[313]285#endif
[588]286#if O0194_WEIGHTED_PREDICTION_CGS
287  Void      setInterLayerWeightedPredFlag(Bool flag)   { m_interLayerWeightedPredFlag = flag; }
288  Bool      getInterLayerWeightedPredFlag()            { return m_interLayerWeightedPredFlag; }
[313]289#endif
[442]290  Void      encode( TComPicYuv* pcPicYuvOrg, TComList<TComPicYuv*>& rcListPicYuvRecOut, std::list<AccessUnit>& accessUnitsOut, Int iPicIdInGOP );
[313]291  Void      encodePrep( TComPicYuv* pcPicYuvOrg );
[442]292  Void      encode( TComPicYuv* pcPicYuvOrg, TComList<TComPicYuv*>& rcListPicYuvRecOut, std::list<AccessUnit>& accessUnitsOut, Int iPicIdInGOP, Bool isTff );
293  Void      encodePrep( TComPicYuv* pcPicYuvOrg, Bool isTff );
[313]294#if VPS_EXTN_DIRECT_REF_LAYERS
295  TEncTop*  getRefLayerEnc(UInt refLayerIdc);
296#endif
[815]297#if POC_RESET_FLAG || POC_RESET_IDC_ENCODER
[644]298  Int       getPocAdjustmentValue()      { return m_pocAdjustmentValue;}
299  Void      setPocAdjustmentValue(Int x) { m_pocAdjustmentValue = x;   }
[442]300#endif
[540]301#if NO_CLRAS_OUTPUT_FLAG
302  Int  getNoClrasOutputFlag()                { return m_noClrasOutputFlag;}
303  Void setNoClrasOutputFlag(Bool x)          { m_noClrasOutputFlag = x;   }
304  Int  getLayerInitializedFlag()             { return m_layerInitializedFlag;}
305  Void setLayerInitializedFlag(Bool x)       { m_layerInitializedFlag = x;   }
306  Int  getFirstPicInLayerDecodedFlag()       { return m_firstPicInLayerDecodedFlag;}
307  Void setFirstPicInLayerDecodedFlag(Bool x) { m_firstPicInLayerDecodedFlag = x;   }
308  Int  getNoOutputOfPriorPicsFlags()         { return m_noOutputOfPriorPicsFlags;}
309  Void setNoOutputOfPriorPicsFlags(Bool x)   { m_noOutputOfPriorPicsFlags = x;   }
310#endif
[815]311#if Q0078_ADD_LAYER_SETS
312  Void setNumAddLayerSets(Int x)             { m_numAddLayerSets = x; }
313  Int  getNumAddLayerSets()                  { return m_numAddLayerSets; }
314#endif
[903]315#if P0297_VPS_POC_LSB_ALIGNED_FLAG
316  Void setPocDecrementedInDPBFlag(Bool x)    { m_pocDecrementedInDPBFlag = x; }
317  Bool getPocDecrementedInDPBFlag()          { return m_pocDecrementedInDPBFlag; }
318  Void setCurrPocMsb(Int poc)                { m_currPocMsb = poc; }
319  Int  getCurrPocMsb()                       { return m_currPocMsb; }
320#endif
[442]321#else //SVC_EXTENSION
[313]322  Void encode( Bool bEos, TComPicYuv* pcPicYuvOrg, TComList<TComPicYuv*>& rcListPicYuvRecOut,
[442]323              std::list<AccessUnit>& accessUnitsOut, Int& iNumEncoded );
[313]324
[442]325  /// encode several number of pictures until end-of-sequence
[713]326  Void encode( Bool bEos, TComPicYuv* pcPicYuvOrg, TComList<TComPicYuv*>& rcListPicYuvRecOut,
[442]327              std::list<AccessUnit>& accessUnitsOut, Int& iNumEncoded, Bool isTff);
328
329  Void printSummary(Bool isField) { m_cGOPEncoder.printOutSummary (m_uiNumAllPicCoded, isField); }
330#endif //#if SVC_EXTENSION
[313]331};
332
333//! \}
334
335#endif // __TENCTOP__
[595]336
Note: See TracBrowser for help on using the repository browser.