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-2011, 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 |
---|
56 | class TAppRendererCfg |
---|
57 | { |
---|
58 | protected: |
---|
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 ); |
---|
130 | public: |
---|
131 | TAppRendererCfg(); |
---|
132 | virtual ~TAppRendererCfg(); |
---|
133 | |
---|
134 | public: |
---|
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 |
---|