source: 3DVCSoftware/trunk/source/App/TAppRenderer/TAppRendererCfg.h @ 1179

Last change on this file since 1179 was 1179, checked in by tech, 9 years ago

Merged branch 13.1-dev0@1178.
  • Property svn:eol-style set to native
File size: 8.1 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-2015, 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 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#ifndef __TAppRENDERERCFG__
35#define __TAppRENDERERCFG__
36
37#include <list>
38#include <stdio.h>
39#include <fcntl.h>
40#include <assert.h>
41
42#include "../../Lib/TAppCommon/TAppComCamPara.h"
43#include "../../Lib/TLibCommon/CommonDef.h"
44#include "../../Lib/TLibRenderer/TRenModel.h"
45#include "../../Lib/TLibRenderer/TRenModSetupStrParser.h"
46#include <string>
47#include <vector>
48
49#if H_3D
50
51// ====================================================================================================================
52// Class definition
53// ====================================================================================================================
54
55/// encoder configuration class
56class TAppRendererCfg
57{
58protected:
59
60  //// file I/O ////
61  Char*              m_pchVideoInputFileBaseName;      ///< input video  file base name, placeholder for numbering $$
62  Char*              m_pchDepthInputFileBaseName;      ///< input depth  file base name, placeholder for numbering $$
63  Char*              m_pchSynthOutputFileBaseName;     ///< output synth file base name, placeholder for numbering $$
64  Bool               m_bContOutputFileNumbering;       ///< use continous numbering instead of view numbering
65  Bool               m_bSweep;                         ///< 1: Store view range in file
66
67
68  // bit-depth      ( Currently interal luma and chroma bit-depth are required to be equal. )
69  Int                m_inputBitDepthY;                 ///< bit-depth of input file (luma component)
70  Int                m_inputBitDepthC;                 ///< bit-depth of input file (chroma component)
71  Int                m_outputBitDepthY;                ///< bit-depth of output file (luma component)
72  Int                m_outputBitDepthC;                ///< bit-depth of output file (chroma component)
73  Int                m_internalBitDepthY;              ///< bit-depth renderer operates at in luma (input/output files will be converted)
74  Int                m_internalBitDepthC;              ///< bit-depth renderer operates at in chroma (input/output files will be converted)
75
76
77  // derived
78  std::vector<Char*> m_pchVideoInputFileList;          ///< source file names
79  std::vector<Char*> m_pchDepthInputFileList;          ///< source depth file names
80  std::vector<Char*> m_pchSynthOutputFileList;         ///< output reconstruction file names
81
82  //// source specification ////
83  Int                m_iSourceWidth;                   ///< source width in pixel
84  Int                m_iSourceHeight;                  ///< source height in pixel
85  Int                m_iFrameSkip;                     ///< number of skipped frames from the beginning
86  Int                m_iFramesToBeRendered;            ///< number of rendered frames
87
88  ////camera specification ////
89  Char*               m_pchCameraParameterFile;         ///< camera parameter file
90  Char*               m_pchSynthViewCameraNumbers;      ///< numbers of views to synthesize
91  Char*               m_pchViewConfig;                  ///< String to setup renderer
92  Char*               m_pchBaseViewCameraNumbers;       ///< numbers of base views
93
94  // derived
95  TAppComCamPara      m_cCameraData;                    ///< class to store camera parameters
96  TRenModSetupStrParser m_cRenModStrParser;             ///< class to manage View to be rendered
97  Bool                m_bUseSetupString;                ///< true if setup string is used
98
99  Int                 m_iNumberOfInputViews;            ///< number of input Views
100  Int                 m_iNumberOfOutputViews;           ///< number views to synthesize
101
102  //// renderer Modes ////
103  Int                 m_iRenderDirection;               ///< 0: interpolate, 1: extrapolate from left, 2: extrapolate from right
104
105  Int                 m_iLog2SamplingFactor;            ///< factor for horizontal upsampling before processing
106  Bool                m_bUVUp;                          ///< upsampling of chroma planes before processing
107  Int                 m_iPreProcMode;                   ///< depth pre-processing: 0 = none, 1 = binominal filtering
108  Int                 m_iPreFilterSize;                 ///< for PreProcMode = 1: size of filter kernel
109  Bool                m_bSimEnhance;                    ///< Similarity enhancement before blending
110  Int                 m_iBlendMode;                     ///< merging of left and right image: 0 = average, 1 = only holes from right, 2 = only holes from left
111  Int                 m_iBlendZThresPerc;               ///< z-difference threshold for blending in percent of total z-range
112  Bool                m_bBlendUseDistWeight;            ///< 0: blend using average; 1: blend factor depends on view distance
113  Int                 m_iBlendHoleMargin;               ///< Margin around boundaries
114  Bool                m_bTempDepthFilter;               ///< Zheijang temporal enhancement filter
115  Int                 m_iInterpolationMode;             ///< 0: NN, 1: linear, 2: cspline
116  Int                 m_iHoleFillingMode;               ///< 0: none, 1: line wise background extension
117  Int                 m_iPostProcMode;                  ///< 0: none, 1: horizontal 3-tap median
118  Int                 m_iRenderMode;                      ///< 0: use renderer
119  Int                 m_iShiftPrecision;                ///< Precision used for Interpolation Mode 4
120  Int                 m_iUsedPelMapMarExt;              ///< Used Pel map extra margin
121
122  Void xCheckParameter ();                              ///< check validity of configuration values
123  Void xPrintParameter ();                              ///< print configuration values
124  Void xPrintUsage     ();                              ///< print usage
125  Void xSetGlobal();
126
127  Void xCreateFileNames();
128  Void xGetMaxPrecision( std::vector< Int > adIn, Int& iPrecBefore, Int& iPrecAfter );
129  Void xAddNumberToFileName( Char* pchSourceFileName, Char*& rpchTargetFileName, Int iNumberToAdd, UInt uiPrecBefore, UInt uiPrecAfter );
130public:
131  TAppRendererCfg();
132  virtual ~TAppRendererCfg();
133
134public:
135  Void  create    ();                                         ///< create option handling class
136  Void  destroy   ();                                         ///< destroy option handling class
137  Bool  parseCfg  ( Int argc, Char* argv[] );                 ///< parse configuration file to fill member variables
138  Bool  xConfirmParameter(Bool bflag, const Char* message);
139
140
141};// END CLASS DEFINITION TAppRendererCfg
142
143#endif // __TAppRENDERERCFG__
144#endif // H_3D
Note: See TracBrowser for help on using the repository browser.