source: SHVCSoftware/branches/SHM-1.0-dev/source/Lib/TLibCommon/TComPic.h @ 26

Last change on this file since 26 was 25, checked in by qualcomm, 12 years ago

L0336: motion field mapping of inter-layer reference picture from Qualcomm, cjianle@…
File size: 12.2 KB
Line 
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 *
6 * Copyright (c) 2010-2012, ITU/ISO/IEC
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     TComPic.h
35    \brief    picture class (header)
36*/
37
38#ifndef __TCOMPIC__
39#define __TCOMPIC__
40
41// Include files
42#include "CommonDef.h"
43#include "TComPicSym.h"
44#include "TComPicYuv.h"
45#include "TComBitStream.h"
46
47//! \ingroup TLibCommon
48//! \{
49
50class SEImessages;
51
52// ====================================================================================================================
53// Class definition
54// ====================================================================================================================
55
56/// picture class (symbol + YUV buffers)
57class TComPic
58{
59private:
60  UInt                  m_uiTLayer;               //  Temporal layer
61#if SVC_EXTENSION
62  UInt                  m_layerId;              //  Layer ID
63#endif
64  Bool                  m_bUsedByCurr;            //  Used by current picture
65  Bool                  m_bIsLongTerm;            //  IS long term picture
66  Bool                  m_bIsUsedAsLongTerm;      //  long term picture is used as reference before
67  TComPicSym*           m_apcPicSym;              //  Symbol
68 
69  TComPicYuv*           m_apcPicYuv[2];           //  Texture,  0:org / 1:rec
70 
71  TComPicYuv*           m_pcPicYuvPred;           //  Prediction
72  TComPicYuv*           m_pcPicYuvResi;           //  Residual
73  Bool                  m_bReconstructed;
74  Bool                  m_bNeededForOutput;
75  UInt                  m_uiCurrSliceIdx;         // Index of current slice 
76  Int*                  m_pSliceSUMap;
77  Bool*                 m_pbValidSlice;
78  Int                   m_sliceGranularityForNDBFilter;
79  Bool                  m_bIndependentSliceBoundaryForNDBFilter;
80  Bool                  m_bIndependentTileBoundaryForNDBFilter;
81  TComPicYuv*           m_pNDBFilterYuvTmp;    //!< temporary picture buffer when non-cross slice/tile boundary in-loop filtering is enabled
82  Bool                  m_bCheckLTMSB;
83  std::vector<std::vector<TComDataCU*> > m_vSliceCUDataLink;
84
85  SEImessages* m_SEIs; ///< Any SEI messages that have been received.  If !NULL we own the object.
86
87#if SVC_EXTENSION
88  Bool                  m_bSpatialEnhLayer;       // whether current layer is a spatial enhancement layer,
89  TComPicYuv*           m_pcFullPelBaseRec;    // upsampled base layer recontruction for difference domain inter prediction
90#if REF_IDX_ME_AROUND_ZEROMV || REF_IDX_ME_ZEROMV || ENCODER_FAST_MODE || REF_IDX_MFM
91  Bool                  m_bIsILR;                 //  Is ILR picture
92#endif
93#if REF_IDX_MFM
94  Bool                          m_bIsUpsampledMvField;
95  TComUpsampledMvFieldCU**      m_apcTComUpsampledMvFieldCU;
96  Char**                        m_peUpsampledPredMode;
97  Int                           m_iNumCUInUpsampledPic;
98#endif
99#endif
100
101public:
102  TComPic();
103  virtual ~TComPic();
104 
105#if SVC_UPSAMPLING
106  Void          create( Int iWidth, Int iHeight, UInt uiMaxWidth, UInt uiMaxHeight, UInt uiMaxDepth, TComSPS* pcSps = NULL, Bool bIsVirtual = false );
107#if REF_IDX_FRAMEWORK
108  Void          createWithOutYuv( Int iWidth, Int iHeight, UInt uiMaxWidth, UInt uiMaxHeight, UInt uiMaxDepth, TComSPS* pcSps = NULL, Bool bIsVirtual = false ); 
109  Void          setPicYuvRec(TComPicYuv *pPicYuv) { m_apcPicYuv[1]=pPicYuv; }
110#endif
111#else
112  Void          create( Int iWidth, Int iHeight, UInt uiMaxWidth, UInt uiMaxHeight, UInt uiMaxDepth, Bool bIsVirtual = false );
113#endif
114  virtual Void  destroy();
115 
116  UInt          getTLayer()                { return m_uiTLayer;   }
117  Void          setTLayer( UInt uiTLayer ) { m_uiTLayer = uiTLayer; }
118#if SVC_EXTENSION
119  Void          setLayerId (UInt layerId) { m_layerId = layerId; }
120  UInt          getLayerId ()               { return m_layerId; }
121  Bool          isSpatialEnhLayer()             { return m_bSpatialEnhLayer; }
122  Void          setSpatialEnhLayerFlag (Bool b) { m_bSpatialEnhLayer = b; }
123  Void          setFullPelBaseRec   ( TComPicYuv* p) { m_pcFullPelBaseRec = p; }
124  TComPicYuv*   getFullPelBaseRec   ()  { return  m_pcFullPelBaseRec;  }
125#endif
126#if REF_IDX_ME_AROUND_ZEROMV || REF_IDX_ME_ZEROMV || ENCODER_FAST_MODE || REF_IDX_MFM
127  Void          setIsILR( Bool bIsILR)      {m_bIsILR = bIsILR;}
128  Bool          getIsILR()                  {return m_bIsILR;}
129#endif
130#if REF_IDX_MFM
131  Bool          IsUpsampledMvField()                         { return m_bIsUpsampledMvField; }
132  Void          setUpsampledMvField(Bool isUpsampledMvField) { m_bIsUpsampledMvField = isUpsampledMvField; }
133  Bool          upsampledMvFieldIsNull()     
134                {
135                  if (m_apcTComUpsampledMvFieldCU == NULL) 
136                    return true; 
137                  else 
138                    return false; 
139                }
140  Void          createUpSampledMvField(  Int upSampledHeight, Int upSampledWidth, UInt uiMaxWidth, UInt uiMaxHeight, UInt uiMaxDepth );
141  Void          doTheUpSampleMvField  (  UInt upSampleRatio );
142  Void          copyUpsampledMvField  (  TComPic* pcPicBase );
143  Void deriveUnitIdxBase(UInt uiUpsamplePelX, UInt uiUpsamplePelY, float ratio, UInt& uiBaseCUAddr, UInt& uiBaseAbsPartIdx);
144
145  Int           getNumCUInUpsampledPic()       { return m_iNumCUInUpsampledPic; }
146  TComUpsampledMvFieldCU*&  getUpsampledMvFieldCU( UInt uiCUAddr )  { return m_apcTComUpsampledMvFieldCU[uiCUAddr]; }
147  char*  getUpsampledPreModeCU( UInt uiCUAddr )  { return m_peUpsampledPredMode[uiCUAddr]; }
148
149
150#endif
151
152  Bool          getUsedByCurr()             { return m_bUsedByCurr; }
153  Void          setUsedByCurr( Bool bUsed ) { m_bUsedByCurr = bUsed; }
154  Bool          getIsLongTerm()             { return m_bIsLongTerm; }
155  Void          setIsLongTerm( Bool lt ) { m_bIsLongTerm = lt; }
156  Bool          getIsUsedAsLongTerm()          { return m_bIsUsedAsLongTerm; }
157  Void          setIsUsedAsLongTerm( Bool lt ) { m_bIsUsedAsLongTerm = lt; }
158  Void          setCheckLTMSBPresent     (Bool b ) {m_bCheckLTMSB=b;}
159  Bool          getCheckLTMSBPresent     () { return m_bCheckLTMSB;}
160
161  TComPicSym*   getPicSym()           { return  m_apcPicSym;    }
162  TComSlice*    getSlice(Int i)       { return  m_apcPicSym->getSlice(i);  }
163  Int           getPOC()              { return  m_apcPicSym->getSlice(m_uiCurrSliceIdx)->getPOC();  }
164  TComDataCU*&  getCU( UInt uiCUAddr )  { return  m_apcPicSym->getCU( uiCUAddr ); }
165 
166  TComPicYuv*   getPicYuvOrg()        { return  m_apcPicYuv[0]; }
167  TComPicYuv*   getPicYuvRec()        { return  m_apcPicYuv[1]; }
168 
169  TComPicYuv*   getPicYuvPred()       { return  m_pcPicYuvPred; }
170  TComPicYuv*   getPicYuvResi()       { return  m_pcPicYuvResi; }
171  Void          setPicYuvPred( TComPicYuv* pcPicYuv )       { m_pcPicYuvPred = pcPicYuv; }
172  Void          setPicYuvResi( TComPicYuv* pcPicYuv )       { m_pcPicYuvResi = pcPicYuv; }
173 
174  UInt          getNumCUsInFrame()      { return m_apcPicSym->getNumberOfCUsInFrame(); }
175  UInt          getNumPartInWidth()     { return m_apcPicSym->getNumPartInWidth();     }
176  UInt          getNumPartInHeight()    { return m_apcPicSym->getNumPartInHeight();    }
177  UInt          getNumPartInCU()        { return m_apcPicSym->getNumPartition();       }
178  UInt          getFrameWidthInCU()     { return m_apcPicSym->getFrameWidthInCU();     }
179  UInt          getFrameHeightInCU()    { return m_apcPicSym->getFrameHeightInCU();    }
180  UInt          getMinCUWidth()         { return m_apcPicSym->getMinCUWidth();         }
181  UInt          getMinCUHeight()        { return m_apcPicSym->getMinCUHeight();        }
182 
183  UInt          getParPelX(UChar uhPartIdx) { return getParPelX(uhPartIdx); }
184  UInt          getParPelY(UChar uhPartIdx) { return getParPelX(uhPartIdx); }
185 
186  Int           getStride()           { return m_apcPicYuv[1]->getStride(); }
187  Int           getCStride()          { return m_apcPicYuv[1]->getCStride(); }
188 
189  Void          setReconMark (Bool b) { m_bReconstructed = b;     }
190  Bool          getReconMark ()       { return m_bReconstructed;  }
191  Void          setOutputMark (Bool b) { m_bNeededForOutput = b;     }
192  Bool          getOutputMark ()       { return m_bNeededForOutput;  }
193 
194
195  Void          compressMotion(); 
196  UInt          getCurrSliceIdx()            { return m_uiCurrSliceIdx;                }
197  Void          setCurrSliceIdx(UInt i)      { m_uiCurrSliceIdx = i;                   }
198  UInt          getNumAllocatedSlice()       {return m_apcPicSym->getNumAllocatedSlice();}
199  Void          allocateNewSlice()           {m_apcPicSym->allocateNewSlice();         }
200  Void          clearSliceBuffer()           {m_apcPicSym->clearSliceBuffer();         }
201
202  Void          createNonDBFilterInfo   (std::vector<Int> sliceStartAddress, Int sliceGranularityDepth
203                                        ,std::vector<Bool>* LFCrossSliceBoundary
204                                        ,Int  numTiles = 1
205                                        ,Bool bNDBFilterCrossTileBoundary = true);
206  Void          createNonDBFilterInfoLCU(Int tileID, Int sliceID, TComDataCU* pcCU, UInt startSU, UInt endSU, Int sliceGranularyDepth, UInt picWidth, UInt picHeight);
207  Void          destroyNonDBFilterInfo();
208
209  Bool          getValidSlice                                  (Int sliceID)  {return m_pbValidSlice[sliceID];}
210#if !REMOVE_FGS
211  Int           getSliceGranularityForNDBFilter                ()             {return m_sliceGranularityForNDBFilter;}
212#endif
213  Bool          getIndependentSliceBoundaryForNDBFilter        ()             {return m_bIndependentSliceBoundaryForNDBFilter;}
214  Bool          getIndependentTileBoundaryForNDBFilter         ()             {return m_bIndependentTileBoundaryForNDBFilter; }
215  TComPicYuv*   getYuvPicBufferForIndependentBoundaryProcessing()             {return m_pNDBFilterYuvTmp;}
216  std::vector<TComDataCU*>& getOneSliceCUDataForNDBFilter      (Int sliceID) { return m_vSliceCUDataLink[sliceID];}
217
218  /** transfer ownership of seis to this picture */
219  void setSEIs(SEImessages* seis) { m_SEIs = seis; }
220
221  /**
222   * return the current list of SEI messages associated with this picture.
223   * Pointer is valid until this->destroy() is called */
224  SEImessages* getSEIs() { return m_SEIs; }
225
226  /**
227   * return the current list of SEI messages associated with this picture.
228   * Pointer is valid until this->destroy() is called */
229  const SEImessages* getSEIs() const { return m_SEIs; }
230#if REF_IDX_FRAMEWORK
231  Void  copyUpsampledPictureYuv(TComPicYuv*   pcPicYuvIn, TComPicYuv*   pcPicYuvOut); 
232#endif
233};// END CLASS DEFINITION TComPic
234
235//! \}
236
237#endif // __TCOMPIC__
Note: See TracBrowser for help on using the repository browser.