source: 3DVCSoftware/branches/0.1-poznan-univ/source/App/TAppCommon/TAppComCamPara.h @ 30

Last change on this file since 30 was 2, checked in by hhi, 13 years ago

inital import
  • Property svn:eol-style set to native
File size: 12.5 KB
Line 
1
2
3#ifndef __TAPPCOMCAMPARA__
4#define __TAPPCOMCAMPARA__
5
6// Include files
7#include "../../Lib/TLibCommon/CommonDef.h"
8#include "../../Lib/TLibCommon/TComMVDRefData.h"
9#include <vector>
10
11
12#define LOG10_VIEW_NUM_PREC         5  // Precision of view numbering
13#define VIEW_NUM_PREC               pow( 10.0, (Int)LOG10_VIEW_NUM_PREC )
14
15// ====================================================================================================================
16// Class definition
17// ====================================================================================================================
18
19class TAppComCamPara
20{
21private:
22  // camera parameter data
23  std::vector< std::vector<Double> >  m_aadCameraParameters;  ///< buffer for double values from file
24
25  // miscellaneous variables
26  Double              m_dViewNumPrec;                         ///< factor for camera number to create integer representation
27  Int                 m_iLog2Precision;                       ///< shift precision in LUT
28  UInt                m_uiInputBitDepth;                      ///< bit depth of input depth maps
29  UInt                m_uiBitDepthForLUT;                     ///< bit depth used for table look-up
30  UInt                m_uiFirstFrameId;                       ///< first frame id
31  UInt                m_uiLastFrameId;                        ///< last frame id
32  UInt                m_iCurrentFrameId;                      ///< currently set frame id
33
34  Bool                m_bSetupFromCoded;                      ///< setup from coded parameter file
35  Bool                m_bCamParsCodedPrecSet;                 ///< Coded Cam Para precision set for current frame;
36
37  // view lists
38  std::vector<Int>    m_aiViewsInCfgFile;                     ///< views for which parameters are specified in cfg file (from left to right)
39  std::vector<Int>    m_aiSynthViews;                           ///< View numbers of External ViewReferences
40  std::vector<Int>    m_aiRelSynthViewsNum;                   ///< Relative view numbers of External ViewReferences
41  std::vector<Int>    m_aiBaseViews;                          ///< View numbers of Base View References (in coding order)
42  std::vector<Int>    m_aiSortedBaseViews;                    ///< View numbers of Base View References (from left to right)
43  std::vector<Int>    m_aiBaseId2SortedId;                    ///< mapping from coding order to left-right order for base views
44  std::vector<Int>    m_aiBaseSortedId2Id;                    ///< mapping from left-right order to coding order for base views
45  Int                 m_iNumberOfBaseViews;                   ///< number of base views
46  Int                 m_iNumberOfSynthViews;                  ///< number of synthesized views
47
48  // SPS and slice header related variables
49  std::vector<Int>    m_aiViewOrderIndex;                     ///< list of view order indices
50  UInt                m_uiCamParsCodedPrecision;              ///< precision for coding of camera parameters (x: max error in disparity is 2^(-x) luma samples)
51  Bool                m_bCamParsVaryOverTime;                 ///< flag specifying whether camera parameters vary for given frame numbers
52  Int**               m_aaiCodedScale;                        ///< array of coded scaling parameters [RefView][TargetView]
53  Int**               m_aaiCodedOffset;                       ///< array of coded offset  parameters [RefView][TargetView]
54  Int**               m_aaiScaleAndOffsetSet;                 ///< array indicating whether scale and offset have been set
55
56  // parameters for virtual depth map generation
57  Int                 m_iPdmPrecision;                        ///< additional precision for disparity - virtual depth conversion
58  Int**               m_aaiPdmScaleNomDelta;                  ///< [TargetView][RefView] delta for nominator of scale factor
59  Int**               m_aaiPdmOffset;                         ///< [TargetView][RefView] offset parameter
60
61  // scale and offset parameters
62  Double***           m_adBaseViewShiftParameter;                                                       ///< ShiftParameters between BaseViews e.g. [2][1][0] shift scale from view 2 to view 1; [2][1][1] shift offset from view 2 to view 1
63  Int64 ***           m_aiBaseViewShiftParameter;                                       ///< ShiftParameters between BaseViews e.g. [2][1][0] shift scale from view 2 to view 1; [2][1][1] shift offset from view 2 to view 1           /* do we need 64 bit? */
64  Double***           m_adSynthViewShiftParameter;                                        ///< ShiftParameters between BaseViews and ERViews e.g. [2][1][0] shift scale from base view 2 to er view 1;
65  Int64 ***           m_aiSynthViewShiftParameter;                              ///< ShiftParameters between BaseViews and ERViews e.g. [2][1][0] shift scale from base view 2 to er view 1;            /* do we need 64 bit? */
66
67  // look-up tables
68  Double****          m_adBaseViewShiftLUT;                                                                             ///< Disparity LUT
69  Int****             m_aiBaseViewShiftLUT;                                                                       ///< Disparity LUT
70  Double****          m_adSynthViewShiftLUT;                                                                    ///< Disparity LUT
71  Int****             m_aiSynthViewShiftLUT;                                                                    ///< Disparity LUT
72
73
74protected:
75  // create and delete arrays
76  Void                    xCreateLUTs   ( UInt uiNumberSourceViews, UInt uiNumberTargetViews, Double****& radLUT, Int****& raiLUT, Double***& radShiftParams, Int64***& raiShiftParams );
77  Void                    xCreate2dArray( UInt uiNum1Ids, UInt uiNum2Ids, Int**& raaiArray );
78  Void                    xInit2dArray  ( UInt uiNum1Ids, UInt uiNum2Ids, Int**& raaiArray, Int iValue );
79  template<class T> Void  xDeleteArray  ( T*& rpt, UInt uiSize1, UInt uiSize2, UInt uiSize3 );
80  template<class T> Void  xDeleteArray  ( T*& rpt, UInt uiSize1, UInt uiSize2 );
81  template<class T> Void  xDeleteArray  ( T*& rpt, UInt uiSize );
82
83  // functions for reading, initialization, sorting, getting data, etc.
84  Void  xReadCameraParameterFile  ( Char* pchCfgFileName );
85  Bool  xGetCameraDataRow         ( Int iView, UInt uiFrame, UInt& ruiFoundLine );
86
87  Void  xGetSortedViewList        ( const std::vector<Int>& raiViews, std::vector<Int>& raiSortedViews, std::vector<Int>& raiId2SortedId, std::vector<Int>& raiSortedId2Id );
88  Void  xGetViewOrderIndices      ( const std::vector<Int>& raiId2SortedId, std::vector<Int>& raiVOIdx );
89  Bool  xGetCamParsChangeFlag     ();
90  Int   xGetBaseViewId            ( Int iBaseView );
91  Int   xGetViewId                 ( std::vector<Int> aiViewList, Int iBaseView );
92
93  Bool  xGetLeftRightView         ( Int iView, std::vector<Int> aiSortedViews, Int& riLeftView, Int& riRightView, Int& riLeftSortedViewIdx, Int& riRightSortedViewIdx );
94  Void  xGetPrevAndNextBaseView   ( Int iSourceViewNum, Int iTargetViewNum, Int& riPrevBaseViewNum, Int& riNextBaseViewNum );
95  Void  xGetZNearZFar             ( Int iView, UInt uiFrame, Double& rdZNear, Double& rdZFar );
96  Void  xGetGeometryData          ( Int dView, UInt uiFrame, Double& rdFocalLength, Double& rdPosition, Double& rdCameraShift, Bool& rbInterpolated );
97  Void  xSetupBaseViewsFromCoded  ();
98  Void  xSetupBaseViews           ( Char* pchBaseViewNumbers, UInt uiNumBaseViews );
99
100  // functions for getting and setting scales and offsets
101  Bool  xGetShiftParameterReal    ( UInt uiSourceView, UInt uiTargetView, UInt uiFrame, Bool bExternal, Bool bByIdx, Double& rdScale, Double& rdOffset );
102  Void  xGetShiftParameterCoded   ( UInt uiSourceView, UInt uiTargetView, UInt uiFrame,                 Bool bByIdx, Int&    riScale, Int&    riOffset );
103  Void  xGetShiftParameterInt     ( UInt uiSourceView, UInt uiTargetView, UInt uiFrame, Bool bExternal, Bool bByIdx, Int64&  riScale, Int64&  riOffset );
104  Void  xGetCodedCameraData       ( UInt uiSourceView, UInt uiTargetView, Bool bByIdx,  UInt uiFrame, Int& riScale, Int& riOffset, Int& riPrecision );
105
106  Void  xSetCodedScaleOffset      ( UInt uiFrame );
107  Void  xSetShiftParametersAndLUT ( UInt uiNumViewDim1, UInt uiNumViewDim2, UInt uiFrame, Bool bExternalReference, Double****& radLUT, Int****& raiLUT, Double***& radShiftParams, Int64***& raiShiftParams );
108  Void  xSetShiftParametersAndLUT ( UInt uiFrame );
109
110
111  // getting conversion parameters for disparity to virtual depth conversion
112  Void  xGetCameraShifts          ( UInt uiSourceView, UInt uiTargetView, UInt uiFrame, Double& rdCamPosShift, Double& rdPicPosShift );
113  Void  xSetPdmConversionParams   ();
114
115public:
116  // constructor and destructor
117  TAppComCamPara();
118  ~TAppComCamPara();
119
120  // initialization, check, and and update
121  Void init   ( UInt    uiNumBaseViews,
122                UInt    uiInputBitDepth,
123                UInt    uiCodedCamParsPrecision,
124                UInt    uiStartFrameId,
125                UInt    uiNumFrames,
126                Char*   pchCfgFileName,
127                Char*   pchBaseViewNumbers,
128                Char*   pchSynthViewNumbers,
129                std::vector<Int>* paiSynthViewNumbers,
130                Int     iLog2Precision );
131
132  Void init   ( UInt    uiInputBitDepth,
133                UInt    uiStartFrameId,
134                UInt    uiNumFrames,
135                Char*   pchCfgFileName,
136                Char*   pchSynthViewNumbers,
137                std::vector<Int>* paiSynthViewNumbers,
138                Int     iLog2Precision
139              );
140
141
142
143  Void check  ( Bool    bCheckViewRange,
144                Bool    bCheckFrameRange );
145  Void update ( UInt    uiFrameId );
146
147  // miscellaneous functions
148
149  Int                 synthRelNum2Idx           ( Int iRelNum );
150  Bool getLeftRightBaseView( Int iSynthViewIdx, Int &riLeftViewIdx, Int &riRightViewIdx, Int &riRelDistToLeft, Bool& rbIsBaseView );
151  Int                 getRelDistLeft            ( Int iSynthViewIdx, Int   iLeftViewIdx, Int iRightViewIdx );
152  UInt                getCurFrameId             ()  { return m_iCurrentFrameId;   }
153  static Void         convertNumberString       ( Char* pchViewNumberString, std::vector<Int>& raiViewNumbers, Double dViewNumPrec );
154
155  // function for getting parameters and parameter arrays
156  std::vector<Int>&   getBaseViewNumbers        ()  { return m_aiBaseViews;       }
157  std::vector<Int>&   getSortedBaseViewNumbers  ()  { return m_aiSortedBaseViews; }
158  std::vector<Int>&   getSynthViewNumbers       ()  { return m_aiSynthViews;      }
159  std::vector<Int>&   getRelSynthViewNumbers    ()  { return m_aiRelSynthViewsNum;}
160
161  std::vector<Int>&   getBaseId2SortedId        ()   { return m_aiBaseId2SortedId; }
162  std::vector<Int>&   getBaseSortedId2Id        ()   { return m_aiBaseSortedId2Id; }
163
164
165  Double***           getBaseViewShiftParameterD()  { return         m_adBaseViewShiftParameter;  }
166  Int***              getBaseViewShiftParameterI()  { return (Int***)m_aiBaseViewShiftParameter;  }
167
168  Double****          getSynthViewShiftLUTD     ()  { return m_adSynthViewShiftLUT;  }
169  Double****          getBaseViewShiftLUTD      ()  { return m_adBaseViewShiftLUT;   }
170  Int****             getSynthViewShiftLUTI     ()  { return m_aiSynthViewShiftLUT;  }
171  Int****             getBaseViewShiftLUTI      ()  { return m_aiBaseViewShiftLUT;   }
172
173  Bool                getVaryingCameraParameters()  { return m_bCamParsVaryOverTime;    }
174  UInt                getCamParsCodedPrecision  ()  { return m_uiCamParsCodedPrecision; }
175  std::vector<Int>&   getViewOrderIndex         ()  { return m_aiViewOrderIndex;        }
176  Int**               getCodedScale             ()  { return m_aaiCodedScale;           }
177  Int**               getCodedOffset            ()  { return m_aaiCodedOffset;          }
178
179  // parameters for virtual depth map generation
180  Int                 getPdmPrecision           ()  { return m_iPdmPrecision;           }
181  Int**               getPdmScaleNomDelta       ()  { return m_aaiPdmScaleNomDelta;     }
182  Int**               getPdmOffset              ()  { return m_aaiPdmOffset;            }
183};
184
185
186
187
188
189template <class T>
190Void TAppComCamPara::xDeleteArray( T*& rpt, UInt uiSize1, UInt uiSize2, UInt uiSize3 )
191{
192  if( rpt )
193  {
194    for( UInt uiK = 0; uiK < uiSize1; uiK++ )
195    {
196      for( UInt uiL = 0; uiL < uiSize2; uiL++ )
197      {
198        for( UInt uiM = 0; uiM < uiSize3; uiM++ )
199        {
200          delete[] rpt[ uiK ][ uiL ][ uiM ];
201        }
202        delete[] rpt[ uiK ][ uiL ];
203      }
204      delete[] rpt[ uiK ];
205    }
206    delete[] rpt;
207  }
208  rpt = NULL;
209};
210
211
212template <class T>
213Void TAppComCamPara::xDeleteArray( T*& rpt, UInt uiSize1, UInt uiSize2 )
214{
215  if( rpt )
216  {
217    for( UInt uiK = 0; uiK < uiSize1; uiK++ )
218    {
219      for( UInt uiL = 0; uiL < uiSize2; uiL++ )
220      {
221        delete[] rpt[ uiK ][ uiL ];
222      }
223      delete[] rpt[ uiK ];
224    }
225    delete[] rpt;
226  }
227  rpt = NULL;
228};
229
230
231template <class T>
232Void TAppComCamPara::xDeleteArray( T*& rpt, UInt uiSize )
233{
234  if( rpt )
235  {
236    for( UInt uiK = 0; uiK < uiSize; uiK++ )
237    {
238      delete[] rpt[ uiK ];
239    }
240    delete[] rpt;
241  }
242  rpt = NULL;
243};
244
245
246
247#endif // __TAPPCOMCAMPARA__
248
249
250
Note: See TracBrowser for help on using the repository browser.