[5] | 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 | */ |
---|
[2] | 33 | |
---|
[608] | 34 | #ifndef __TAppRENDERERCFG__ |
---|
| 35 | #define __TAppRENDERERCFG__ |
---|
[2] | 36 | |
---|
| 37 | #include <list> |
---|
| 38 | #include <stdio.h> |
---|
| 39 | #include <fcntl.h> |
---|
| 40 | #include <assert.h> |
---|
| 41 | |
---|
[56] | 42 | #include "../../Lib/TAppCommon/TAppComCamPara.h" |
---|
[2] | 43 | #include "../../Lib/TLibCommon/CommonDef.h" |
---|
| 44 | #include "../../Lib/TLibRenderer/TRenModel.h" |
---|
| 45 | #include "../../Lib/TLibRenderer/TRenModSetupStrParser.h" |
---|
| 46 | #include <string> |
---|
| 47 | #include <vector> |
---|
[608] | 48 | |
---|
| 49 | #if H_3D |
---|
| 50 | |
---|
[2] | 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 | |
---|
[608] | 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 | |
---|
[2] | 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 |
---|
[100] | 90 | Char* m_pchSynthViewCameraNumbers; ///< numbers of views to synthesize |
---|
[2] | 91 | Char* m_pchViewConfig; ///< String to setup renderer |
---|
[100] | 92 | Char* m_pchBaseViewCameraNumbers; ///< numbers of base views |
---|
[2] | 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 | |
---|
[100] | 99 | Int m_iNumberOfInputViews; ///< number of input Views |
---|
| 100 | Int m_iNumberOfOutputViews; ///< number views to synthesize |
---|
[2] | 101 | |
---|
| 102 | //// renderer Modes //// |
---|
[100] | 103 | Int m_iRenderDirection; ///< 0: interpolate, 1: extrapolate from left, 2: extrapolate from right |
---|
[2] | 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__ |
---|
[608] | 144 | #endif // H_3D |
---|