| 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 | |
|---|
| 35 | |
|---|
| 36 | /** \file TAppEncCfg.h |
|---|
| 37 | \brief Handle encoder configuration parameters (header) |
|---|
| 38 | */ |
|---|
| 39 | |
|---|
| 40 | #ifndef __TAPPENCCFG__ |
|---|
| 41 | #define __TAPPENCCFG__ |
|---|
| 42 | |
|---|
| 43 | #include "../../Lib/TLibCommon/CommonDef.h" |
|---|
| 44 | #include "../../Lib/TLibCommon/TComMVDRefData.h" |
|---|
| 45 | #include "../../App/TAppCommon/TAppComCamPara.h" |
|---|
| 46 | #include "../../Lib/TLibRenderer/TRenTop.h" |
|---|
| 47 | #include "../../Lib/TLibRenderer/TRenModel.h" |
|---|
| 48 | #include "../../Lib/TLibRenderer/TRenModSetupStrParser.h" |
|---|
| 49 | |
|---|
| 50 | #include <string> |
|---|
| 51 | #include <vector> |
|---|
| 52 | |
|---|
| 53 | // ==================================================================================================================== |
|---|
| 54 | // Class definition |
|---|
| 55 | // ==================================================================================================================== |
|---|
| 56 | |
|---|
| 57 | /// encoder configuration class |
|---|
| 58 | class TAppEncCfg |
|---|
| 59 | { |
|---|
| 60 | protected: |
|---|
| 61 | // file I/O |
|---|
| 62 | char* m_pchBitstreamFile; ///< output bitstream file |
|---|
| 63 | |
|---|
| 64 | std::vector<char*> m_pchInputFileList; ///< source file names |
|---|
| 65 | std::vector<char*> m_pchDepthInputFileList; ///< source depth file names |
|---|
| 66 | std::vector<char*> m_pchReconFileList; ///< output reconstruction file names |
|---|
| 67 | std::vector<char*> m_pchDepthReconFileList; ///< output depth reconstruction file names |
|---|
| 68 | |
|---|
| 69 | std::vector<char*> m_pchERRefFileList; ///< virtual external reference view files names |
|---|
| 70 | |
|---|
| 71 | // source specification |
|---|
| 72 | Int m_iFrameRate; ///< source frame-rates (Hz) |
|---|
| 73 | unsigned int m_FrameSkip; ///< number of skipped frames from the beginning |
|---|
| 74 | Int m_iSourceWidth; ///< source width in pixel |
|---|
| 75 | Int m_iSourceHeight; ///< source height in pixel |
|---|
| 76 | Int m_iFrameToBeEncoded; ///< number of encoded frames |
|---|
| 77 | Bool m_bUsePAD; ///< flag for using source padding |
|---|
| 78 | Int m_aiPad[2]; ///< number of padded pixels for width and height |
|---|
| 79 | |
|---|
| 80 | Int m_iNumberOfViews; ///< number Views to Encode |
|---|
| 81 | Bool m_bUsingDepthMaps ; |
|---|
| 82 | |
|---|
| 83 | #if FLEX_CODING_ORDER |
|---|
| 84 | char* m_pchMVCJointCodingOrder; ///< texture-depth coding order |
|---|
| 85 | Bool m_b3DVFlexOrder; ///< flexible coding order flag |
|---|
| 86 | #endif |
|---|
| 87 | |
|---|
| 88 | |
|---|
| 89 | // coding structure |
|---|
| 90 | #if DCM_DECODING_REFRESH |
|---|
| 91 | Int m_iDecodingRefreshType; ///< random access type |
|---|
| 92 | #endif |
|---|
| 93 | UInt m_uiCodedPictureStoreSize ; |
|---|
| 94 | Int m_iGOPSize; ///< GOP size of hierarchical structure |
|---|
| 95 | Int m_iRateGOPSize; ///< GOP size for QP variance |
|---|
| 96 | #if !HHI_NO_LowDelayCoding |
|---|
| 97 | Bool m_bUseLDC; ///< flag for using low-delay coding mode |
|---|
| 98 | #endif |
|---|
| 99 | #if DCM_COMB_LIST |
|---|
| 100 | Bool m_bUseLComb; ///< flag for using combined reference list for uni-prediction in B-slices (JCTVC-D421) |
|---|
| 101 | Bool m_bLCMod; ///< flag for specifying whether the combined reference list for uni-prediction in B-slices is uploaded explicitly |
|---|
| 102 | #endif |
|---|
| 103 | std::string m_cInputFormatString ; // GOP string |
|---|
| 104 | // coding quality |
|---|
| 105 | |
|---|
| 106 | std::vector<Double> m_adQP; ///< QP value of key-picture (floating point) [0] video, [1] depth |
|---|
| 107 | std::vector<Int> m_aiQP; ///< QP value of key-picture (integer) |
|---|
| 108 | |
|---|
| 109 | Int m_aiTLayerQPOffset[MAX_TLAYER]; ///< QP offset corresponding to temporal layer depth |
|---|
| 110 | char* m_pchdQPFile; ///< QP offset for each slice (initialized from external file) |
|---|
| 111 | Int* m_aidQP; ///< array of slice QP values |
|---|
| 112 | Int m_iMaxDeltaQP; ///< max. |delta QP| |
|---|
| 113 | UInt m_uiDeltaQpRD; ///< dQP range for multi-pass slice QP optimization |
|---|
| 114 | |
|---|
| 115 | // coding unit (CU) definition |
|---|
| 116 | UInt m_uiMaxCUWidth; ///< max. CU width in pixel |
|---|
| 117 | UInt m_uiMaxCUHeight; ///< max. CU height in pixel |
|---|
| 118 | UInt m_uiMaxCUDepth; ///< max. CU depth |
|---|
| 119 | |
|---|
| 120 | // transfom unit (TU) definition |
|---|
| 121 | UInt m_uiQuadtreeTULog2MaxSize; |
|---|
| 122 | UInt m_uiQuadtreeTULog2MinSize; |
|---|
| 123 | |
|---|
| 124 | UInt m_uiQuadtreeTUMaxDepthInter; |
|---|
| 125 | UInt m_uiQuadtreeTUMaxDepthIntra; |
|---|
| 126 | |
|---|
| 127 | // coding tools (bit-depth) |
|---|
| 128 | UInt m_uiInputBitDepth; ///< bit-depth of input file |
|---|
| 129 | UInt m_uiOutputBitDepth; ///< bit-depth of output file |
|---|
| 130 | #ifdef ENABLE_IBDI |
|---|
| 131 | UInt m_uiBitIncrement; ///< bit-depth increment |
|---|
| 132 | #endif |
|---|
| 133 | UInt m_uiInternalBitDepth; ///< Internal bit-depth (BitDepth+BitIncrement) |
|---|
| 134 | |
|---|
| 135 | #if MTK_SAO |
|---|
| 136 | vector<Bool> m_abUseSAO; |
|---|
| 137 | #endif |
|---|
| 138 | |
|---|
| 139 | // coding tools (loop filter) |
|---|
| 140 | vector<Bool> m_abUseALF; ///< flag for using adaptive loop filter [0] - video, [1] - depth |
|---|
| 141 | #ifdef MQT_ALF_NPASS |
|---|
| 142 | Int m_iALFEncodePassReduction; ///< ALF encoding pass, 0 = original 16-pass, 1 = 1-pass, 2 = 2-pass |
|---|
| 143 | #endif |
|---|
| 144 | |
|---|
| 145 | vector<Bool> m_abLoopFilterDisable; ///< flag for using deblocking filter filter [0] - video, [1] - depth |
|---|
| 146 | Int m_iLoopFilterAlphaC0Offset; ///< alpha offset for deblocking filter |
|---|
| 147 | Int m_iLoopFilterBetaOffset; ///< beta offset for deblocking filter |
|---|
| 148 | |
|---|
| 149 | // coding tools (entropy coder) |
|---|
| 150 | Int m_iSymbolMode; ///< entropy coder mode, 0 = VLC, 1 = CABAC |
|---|
| 151 | |
|---|
| 152 | // coding tools (inter - merge motion partitions) |
|---|
| 153 | Bool m_bUseMRG; ///< SOPH: flag for using motion partition Merge Mode |
|---|
| 154 | |
|---|
| 155 | #if LM_CHROMA |
|---|
| 156 | Bool m_bUseLMChroma; ///< JL: Chroma intra prediction based on luma signal |
|---|
| 157 | #endif |
|---|
| 158 | |
|---|
| 159 | #if HHI_RMP_SWITCH |
|---|
| 160 | Bool m_bUseRMP; |
|---|
| 161 | #endif |
|---|
| 162 | |
|---|
| 163 | // coding tools (encoder-only parameters) |
|---|
| 164 | Bool m_bUseSBACRD; ///< flag for using RD optimization based on SBAC |
|---|
| 165 | Bool m_bUseASR; ///< flag for using adaptive motion search range |
|---|
| 166 | Bool m_bUseHADME; ///< flag for using HAD in sub-pel ME |
|---|
| 167 | vector<Bool> m_abUseRDOQ; ///< flag for using RD optimized quantization [0]-video, [1]-depth |
|---|
| 168 | Int m_iFastSearch; ///< ME mode, 0 = full, 1 = diamond, 2 = PMVFAST |
|---|
| 169 | Int m_iSearchRange; ///< ME search range |
|---|
| 170 | Int m_bipredSearchRange; ///< ME search range for bipred refinement |
|---|
| 171 | Bool m_bUseFastEnc; ///< flag for using fast encoder setting |
|---|
| 172 | |
|---|
| 173 | #if DEPTH_MAP_GENERATION |
|---|
| 174 | UInt m_uiPredDepthMapGeneration; ///< using of (virtual) depth maps for texture coding |
|---|
| 175 | #endif |
|---|
| 176 | #if HHI_INTER_VIEW_MOTION_PRED |
|---|
| 177 | UInt m_uiMultiviewMvPredMode; ///< usage of predictors for multi-view mv prediction |
|---|
| 178 | UInt m_uiMultiviewMvRegMode; ///< regularization for multiview motion vectors |
|---|
| 179 | Double m_dMultiviewMvRegLambdaScale; ///< lambda scale for multiview motion vectors regularization |
|---|
| 180 | #endif |
|---|
| 181 | #if HHI_INTER_VIEW_RESIDUAL_PRED |
|---|
| 182 | UInt m_uiMultiviewResPredMode; ///< using multiview residual prediction |
|---|
| 183 | #endif |
|---|
| 184 | |
|---|
| 185 | #if HHI_INTERVIEW_SKIP |
|---|
| 186 | UInt m_uiInterViewSkip; ///< usage of interview skip mode ( do not transmit residual) |
|---|
| 187 | #if HHI_INTERVIEW_SKIP_LAMBDA_SCALE |
|---|
| 188 | Double m_dInterViewSkipLambdaScale; ///< lambda scale for interview skip |
|---|
| 189 | #endif |
|---|
| 190 | #endif |
|---|
| 191 | |
|---|
| 192 | // camera parameter |
|---|
| 193 | Char* m_pchCameraParameterFile; ///< camera parameter file |
|---|
| 194 | Char* m_pchBaseViewCameraNumbers; |
|---|
| 195 | TAppComCamPara m_cCameraData; |
|---|
| 196 | |
|---|
| 197 | Int m_iCodedCamParPrecision; ///< precision for coding of camera parameters |
|---|
| 198 | |
|---|
| 199 | #if HHI_INTERVIEW_SKIP |
|---|
| 200 | TRenTop m_cUsedPelsRenderer; ///< renderer for used pels map |
|---|
| 201 | #endif |
|---|
| 202 | |
|---|
| 203 | #if HHI_VSO |
|---|
| 204 | Char* m_pchVSOConfig; |
|---|
| 205 | Bool m_bUseVSO; ///< flag for using View Synthesis Optimization |
|---|
| 206 | |
|---|
| 207 | //// Used for development by GT, might be removed later |
|---|
| 208 | Double m_dLambdaScaleVSO; ///< Scaling factor for Lambda in VSO mode |
|---|
| 209 | Bool m_bForceLambdaScaleVSO; ///< Use Lambda Scale for depth even if VSO is turned off |
|---|
| 210 | #if HHI_VSO_DIST_INT |
|---|
| 211 | Bool m_bAllowNegDist; ///< Allow negative distortion in VSO |
|---|
| 212 | #endif |
|---|
| 213 | UInt m_uiVSOMode; ///< Number of VSO Mode, 1 = , 2 = simple, org vs. ren, 3 = simple, ren vs. ren, 4 = full |
|---|
| 214 | Int m_iNumberOfExternalRefs; ///< number Virtual External Reference Views |
|---|
| 215 | std::vector< std::vector<Int> > m_aaiBaseViewRefInd; ///< View numbers of Base View References |
|---|
| 216 | std::vector< std::vector<Int> > m_aaiERViewRefInd; ///< View numbers of External ViewReferences |
|---|
| 217 | std::vector< std::vector<Int> > m_aaiERViewRefLutInd; ///< Indices of LUTs used for External View References |
|---|
| 218 | #endif |
|---|
| 219 | |
|---|
| 220 | Int m_iSliceMode; ///< 0: Disable all Recon slice limits, 1 : Maximum number of largest coding units per slice, 2: Maximum number of bytes in a slice |
|---|
| 221 | Int m_iSliceArgument; ///< If m_iSliceMode==1, m_iSliceArgument=max. # of largest coding units. If m_iSliceMode==2, m_iSliceArgument=max. # of bytes. |
|---|
| 222 | Int m_iEntropySliceMode; ///< 0: Disable all entropy slice limits, 1 : Maximum number of largest coding units per slice, 2: Constraint based entropy slice |
|---|
| 223 | Int m_iEntropySliceArgument;///< If m_iEntropySliceMode==1, m_iEntropySliceArgument=max. # of largest coding units. If m_iEntropySliceMode==2, m_iEntropySliceArgument=max. # of bins. |
|---|
| 224 | |
|---|
| 225 | #if MTK_NONCROSS_INLOOP_FILTER |
|---|
| 226 | Bool m_bLFCrossSliceBoundaryFlag; ///< 0: Cross-slice-boundary in-loop filtering 1: non-cross-slice-boundary in-loop filtering |
|---|
| 227 | #endif |
|---|
| 228 | #ifdef ROUNDING_CONTROL_BIPRED |
|---|
| 229 | Bool m_useRoundingControlBipred; |
|---|
| 230 | #endif |
|---|
| 231 | #if CONSTRAINED_INTRA_PRED |
|---|
| 232 | Bool m_bUseConstrainedIntraPred; ///< flag for using constrained intra prediction |
|---|
| 233 | #endif |
|---|
| 234 | #if HHI_DMM_WEDGE_INTRA || HHI_DMM_PRED_TEX |
|---|
| 235 | Bool m_bUseDMM; |
|---|
| 236 | #endif |
|---|
| 237 | #if HHI_MPI |
|---|
| 238 | Bool m_bUseMVI; ///< flag for using Motion Vector Inheritance for depth map coding |
|---|
| 239 | #endif |
|---|
| 240 | |
|---|
| 241 | PicOrderCnt m_iQpChangeFrame; |
|---|
| 242 | Int m_iQpChangeOffsetVideo; |
|---|
| 243 | Int m_iQpChangeOffsetDepth; |
|---|
| 244 | |
|---|
| 245 | bool m_pictureDigestEnabled; ///< enable(1)/disable(0) md5 computation and SEI signalling |
|---|
| 246 | |
|---|
| 247 | //====== Weighted Prediction ======== |
|---|
| 248 | #ifdef WEIGHT_PRED |
|---|
| 249 | Bool m_bUseWeightPred; ///< Use of explicit Weighting Prediction for P_SLICE |
|---|
| 250 | UInt m_uiBiPredIdc; ///< Use of Bi-Directional Weighting Prediction (B_SLICE): explicit(1) or implicit(2) |
|---|
| 251 | #endif |
|---|
| 252 | |
|---|
| 253 | // internal member functions |
|---|
| 254 | Void xSetGlobal (); ///< set global variables |
|---|
| 255 | Void xCheckParameter (); ///< check validity of configuration values |
|---|
| 256 | Void xPrintParameter (); ///< print configuration values |
|---|
| 257 | Void xPrintUsage (); ///< print usage |
|---|
| 258 | |
|---|
| 259 | Void xCleanUpVectors (); ///< clean up vector sizes |
|---|
| 260 | Void xInitCameraPars (); ///< init camera parameters |
|---|
| 261 | |
|---|
| 262 | |
|---|
| 263 | // set MVD Parameters and LUTs |
|---|
| 264 | Void xSetShiftParameters(); |
|---|
| 265 | Void xGetShiftParameter( UInt uiSourceView, UInt uiTargetView, bool bExternal, double& rdScale, double& rdOffset ); ///< Get one Shift Parameters |
|---|
| 266 | |
|---|
| 267 | // util |
|---|
| 268 | Void xAppendToFileNameEnd( Char* pchInputFileName, const Char* pchStringToAppend, Char* & rpchOutputFileName); |
|---|
| 269 | Bool xConfirmParameter(Bool bflag, const char* message); |
|---|
| 270 | |
|---|
| 271 | |
|---|
| 272 | template <class T> Void xCleanUpVector( std::vector<T>& rcVec, const T& rcInvalid ); |
|---|
| 273 | |
|---|
| 274 | #if HHI_VSO |
|---|
| 275 | // Ren Model String |
|---|
| 276 | TRenModSetupStrParser m_cRenModStrParser; |
|---|
| 277 | #endif |
|---|
| 278 | public: |
|---|
| 279 | |
|---|
| 280 | TAppEncCfg(); |
|---|
| 281 | virtual ~TAppEncCfg(); |
|---|
| 282 | |
|---|
| 283 | public: |
|---|
| 284 | Void create (); ///< create option handling class |
|---|
| 285 | Void destroy (); ///< destroy option handling class |
|---|
| 286 | Bool parseCfg ( Int argc, Char* argv[] ); ///< parse configuration file to fill member variables |
|---|
| 287 | |
|---|
| 288 | };// END CLASS DEFINITION TAppEncCfg |
|---|
| 289 | |
|---|
| 290 | #endif // __TAPPENCCFG__ |
|---|
| 291 | |
|---|
