source: 3DVCSoftware/branches/HTM-15.2-dev/source/App/TAppEncoder/TAppEncCfg.h @ 1360

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

Update to HM-16.7.

  • Property svn:eol-style set to native
File size: 37.9 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 ITU/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/** \file     TAppEncCfg.h
35    \brief    Handle encoder configuration parameters (header)
36*/
37
38#ifndef __TAPPENCCFG__
39#define __TAPPENCCFG__
40
41#include "TLibCommon/CommonDef.h"
42
43#include "TLibEncoder/TEncCfg.h"
44#include <sstream>
45#include <vector>
46#if NH_3D
47#include "TAppCommon/TAppComCamPara.h"
48#include "TLibRenderer/TRenModel.h"
49#include "TLibRenderer/TRenModSetupStrParser.h"
50#endif
51//! \ingroup TAppEncoder
52//! \{
53
54// ====================================================================================================================
55// Class definition
56// ====================================================================================================================
57
58/// encoder configuration class
59class TAppEncCfg
60{
61protected:
62  // file I/O
63#if NH_MV
64  std::vector<TChar*>     m_pchInputFileList;                  ///< source file names
65#else
66  std::string m_inputFileName;                                ///< source file name
67#endif
68  std::string m_bitstreamFileName;                            ///< output bitstream file
69#if NH_MV
70  std::vector<char*>     m_pchReconFileList;                  ///< output reconstruction file names
71  Int                    m_numberOfLayers;                    ///< number of Layers to Encode
72  Int                    m_iNumberOfViews;                    ///< number of Layers that are views
73#else
74  std::string m_reconFileName;                                ///< output reconstruction file
75#endif
76  #if NH_MV
77// VPS specification
78  IntAry2d m_dimIds;                   ///< dimension ids ( pointers to m_viewId and m_depthFlag
79  IntAry1d               m_viewId;                            ///< view id
80  IntAry1d               m_viewOrderIndex;                    ///< view order index 
81  IntAry1d               m_auxId;                             ///< auxiliary id
82#if NH_3D
83  IntAry1d               m_depthFlag;                         ///< depth flag
84#endif
85  IntAry1d               m_targetEncLayerIdList;              ///< layer Ids in Nuh to be encoded
86  IntAry1d               m_layerIdInNuh;                      ///< layer Id in Nuh for each layer
87  Bool                   m_splittingFlag;                     ///< Splitting Flag
88  Int                    m_scalabilityMask;                   ///< Mask indicating scalabilities, 1: texture; 3: texture + depth                                                               
89  IntAry1d               m_dimensionIdLen;                    ///< Length of scalability dimension s
90 
91// layer sets   
92  Int                    m_vpsNumLayerSets;                   ///< Number of layer sets
93  IntAry2d m_layerIdsInSets;           ///< LayerIds in vps of layer set
94  Int                    m_numAddLayerSets;                    ///< Number of additional layer sets
95  IntAry2d m_highestLayerIdxPlus1;      ///< HighestLayerIdxPlus1 for each additional layer set and each independent layer (value with index 0 will be ignored)
96  Int                    m_defaultOutputLayerIdc;             ///< Specifies output layers of layer sets, 0: output all layers, 1: output highest layers, 2: specified by LayerIdsInDefOuputLayerSet
97  IntAry1d               m_outputLayerSetIdx;                 ///< Indices of layer sets used as additional output layer sets 
98  IntAry2d m_layerIdsInAddOutputLayerSet; ///< LayerIds in vps of additional output layers
99  IntAry2d m_layerIdsInDefOutputLayerSet; ///< Indices in vps of output layers in layer sets
100  IntAry2d               m_profileTierLevelIdx;      ///< Indices of of profile, per layer in layer set
101  BoolAry1d              m_altOutputLayerFlag;                ///< Alt output layer flag
102
103  // Dependencies
104  IntAry2d m_directRefLayers;          ///< LayerIds of direct reference layers
105  IntAry2d m_dependencyTypes;          ///< Dependency types of direct reference layers
106
107  // VPS VUI
108  Bool m_vpsVuiPresentFlag;
109  Bool m_crossLayerPicTypeAlignedFlag;
110  Bool m_crossLayerIrapAlignedFlag;
111  Bool m_allLayersIdrAlignedFlag;
112  Bool m_bitRatePresentVpsFlag;
113  Bool m_picRatePresentVpsFlag;
114  BoolAry2d m_bitRatePresentFlag;
115  BoolAry2d m_picRatePresentFlag;
116  IntAry2d  m_avgBitRate;
117  IntAry2d  m_maxBitRate;
118  IntAry2d  m_constantPicRateIdc;
119  IntAry2d  m_avgPicRate;
120  Bool      m_tilesNotInUseFlag; 
121  BoolAry1d m_tilesInUseFlag;
122  BoolAry1d m_loopFilterNotAcrossTilesFlag; 
123  Bool      m_wppNotInUseFlag;
124  BoolAry1d m_wppInUseFlag;
125
126  BoolAry2d m_tileBoundariesAlignedFlag; 
127  Bool      m_ilpRestrictedRefLayersFlag;
128  IntAry2d  m_minSpatialSegmentOffsetPlus1;
129  BoolAry2d m_ctuBasedOffsetEnabledFlag;
130  IntAry2d  m_minHorizontalCtuOffsetPlus1;
131  Bool      m_singleLayerForNonIrapFlag;
132  Bool      m_higherLayerIrapSkipFlag;
133#if NH_3D
134  Bool      m_abUseIC;
135  Bool      m_bUseLowLatencyICEnc;
136#endif
137#endif
138  Double    m_adLambdaModifier[ MAX_TLAYER ];                 ///< Lambda modifier array for each temporal layer
139  std::vector<Double> m_adIntraLambdaModifier;                ///< Lambda modifier for Intra pictures, one for each temporal layer. If size>temporalLayer, then use [temporalLayer], else if size>0, use [size()-1], else use m_adLambdaModifier.
140  Double    m_dIntraQpFactor;                                 ///< Intra Q Factor. If negative, use a default equation: 0.57*(1.0 - Clip3( 0.0, 0.5, 0.05*(Double)(isField ? (GopSize-1)/2 : GopSize-1) ))
141
142  // source specification
143  Int       m_iFrameRate;                                     ///< source frame-rates (Hz)
144  UInt      m_FrameSkip;                                   ///< number of skipped frames from the beginning
145  Int       m_iSourceWidth;                                   ///< source width in pixel
146  Int       m_iSourceHeight;                                  ///< source height in pixel (when interlaced = field height)
147
148  Int       m_iSourceHeightOrg;                               ///< original source height in pixel (when interlaced = frame height)
149
150  Bool      m_isField;                                        ///< enable field coding
151  Bool      m_isTopFieldFirst;
152  Bool      m_bEfficientFieldIRAPEnabled;                     ///< enable an efficient field IRAP structure.
153  Bool      m_bHarmonizeGopFirstFieldCoupleEnabled;
154
155  Int       m_conformanceWindowMode;
156  Int       m_confWinLeft;
157  Int       m_confWinRight;
158  Int       m_confWinTop;
159  Int       m_confWinBottom;
160  Int       m_framesToBeEncoded;                              ///< number of encoded frames
161  Int       m_aiPad[2];                                       ///< number of padded pixels for width and height
162  Bool      m_AccessUnitDelimiter;                            ///< add Access Unit Delimiter NAL units
163  InputColourSpaceConversion m_inputColourSpaceConvert;       ///< colour space conversion to apply to input video
164  Bool      m_snrInternalColourSpace;                       ///< if true, then no colour space conversion is applied for snr calculation, otherwise inverse of input is applied.
165  Bool      m_outputInternalColourSpace;                    ///< if true, then no colour space conversion is applied for reconstructed video, otherwise inverse of input is applied.
166  ChromaFormat m_InputChromaFormatIDC;
167
168  Bool      m_printMSEBasedSequencePSNR;
169  Bool      m_printFrameMSE;
170  Bool      m_printSequenceMSE;
171  Bool      m_cabacZeroWordPaddingEnabled;
172  Bool      m_bClipInputVideoToRec709Range;
173  Bool      m_bClipOutputVideoToRec709Range;
174
175  // profile/level
176#if NH_MV
177  std::vector< Profile::Name > m_profiles;
178  std::vector< Level::Tier   > m_levelTier;
179  std::vector< Level::Name   > m_level;
180  std::vector< Bool          > m_inblFlag; 
181#else
182  Profile::Name m_profile;
183  Level::Tier   m_levelTier;
184  Level::Name   m_level;
185#endif
186  UInt          m_bitDepthConstraint;
187  ChromaFormat  m_chromaFormatConstraint;
188  Bool          m_intraConstraintFlag;
189  Bool          m_onePictureOnlyConstraintFlag;
190  Bool          m_lowerBitRateConstraintFlag;
191  Bool m_progressiveSourceFlag;
192  Bool m_interlacedSourceFlag;
193  Bool m_nonPackedConstraintFlag;
194  Bool m_frameOnlyConstraintFlag;
195
196  // coding structure
197#if NH_MV
198  IntAry1d  m_iIntraPeriod;                            ///< period of I-slice (random access period)
199#else
200  Int       m_iIntraPeriod;                                   ///< period of I-slice (random access period)
201#endif
202  Int       m_iDecodingRefreshType;                           ///< random access type
203  Int       m_iGOPSize;                                       ///< GOP size of hierarchical structure
204#if NH_MV
205  Int       m_extraRPSsMvc[MAX_NUM_LAYERS];                       ///< extra RPSs added to handle CRA for each layer
206  std::vector< GOPEntry* >  m_GOPListMvc;                            ///< the coding structure entries from the config file for each layer
207  Int       m_numReorderPicsMvc[MAX_NUM_LAYERS][MAX_TLAYER];      ///< total number of reorder pictures for each layer
208  Int       m_maxDecPicBufferingMvc[MAX_NUM_LAYERS][MAX_TLAYER];  ///< total number of reference pictures needed for decoding for each layer
209#else
210  Int       m_extraRPSs;                                      ///< extra RPSs added to handle CRA
211  GOPEntry  m_GOPList[MAX_GOP];                               ///< the coding structure entries from the config file
212  Int       m_numReorderPics[MAX_TLAYER];                     ///< total number of reorder pictures
213  Int       m_maxDecPicBuffering[MAX_TLAYER];                 ///< total number of pictures in the decoded picture buffer
214  #endif
215  Bool      m_crossComponentPredictionEnabledFlag;                          ///< flag enabling the use of cross-component prediction
216  Bool      m_reconBasedCrossCPredictionEstimate;             ///< causes the alpha calculation in encoder search to be based on the decoded residual rather than the pre-transform encoder-side residual
217#if NH_MV
218  UInt      m_log2SaoOffsetScale[MAX_NUM_LAYERS][MAX_NUM_CHANNEL_TYPE];        ///< number of bits for the upward bit shift operation on the decoded SAO offsets
219#else
220  UInt      m_log2SaoOffsetScale[MAX_NUM_CHANNEL_TYPE];       ///< number of bits for the upward bit shift operation on the decoded SAO offsets
221#endif
222  Bool      m_useTransformSkip;                               ///< flag for enabling intra transform skipping
223  Bool      m_useTransformSkipFast;                           ///< flag for enabling fast intra transform skipping
224  UInt      m_log2MaxTransformSkipBlockSize;                  ///< transform-skip maximum size (minimum of 2)
225  Bool      m_transformSkipRotationEnabledFlag;               ///< control flag for transform-skip/transquant-bypass residual rotation
226  Bool      m_transformSkipContextEnabledFlag;                ///< control flag for transform-skip/transquant-bypass single significance map context
227  Bool      m_rdpcmEnabledFlag[NUMBER_OF_RDPCM_SIGNALLING_MODES];///< control flags for residual DPCM
228  Bool      m_enableAMP;
229  Bool      m_persistentRiceAdaptationEnabledFlag;            ///< control flag for Golomb-Rice parameter adaptation over each slice
230  Bool      m_cabacBypassAlignmentEnabledFlag;
231
232  // coding quality
233#if NH_MV
234  std::vector<Double>  m_fQP;                                 ///< QP value of key-picture (floating point) for each layer
235  std::vector<Int>     m_iQP;                                 ///< QP value of key-picture (integer) for each layer
236#else
237  Double    m_fQP;                                            ///< QP value of key-picture (floating point)
238  Int       m_iQP;                                            ///< QP value of key-picture (integer)
239#endif
240  std::string m_dQPFileName;                                  ///< QP offset for each slice (initialized from external file)
241#if NH_MV
242  std::vector<Int*> m_aidQP;                                    ///< array of slice QP values for each layer
243#else
244  Int*      m_aidQP;                                          ///< array of slice QP values
245#endif
246  Int       m_iMaxDeltaQP;                                    ///< max. |delta QP|
247  UInt      m_uiDeltaQpRD;                                    ///< dQP range for multi-pass slice QP optimization
248  Int       m_iMaxCuDQPDepth;                                 ///< Max. depth for a minimum CuDQPSize (0:default)
249  Int       m_diffCuChromaQpOffsetDepth;                      ///< If negative, then do not apply chroma qp offsets.
250  Bool      m_bFastDeltaQP;                                   ///< Fast Delta QP (false:default)
251
252  Int       m_cbQpOffset;                                     ///< Chroma Cb QP Offset (0:default)
253  Int       m_crQpOffset;                                     ///< Chroma Cr QP Offset (0:default)
254
255#if ADAPTIVE_QP_SELECTION
256  Bool      m_bUseAdaptQpSelect;
257#endif
258  TComSEIMasteringDisplay m_masteringDisplay;
259#if NH_MV_SEI
260  std::vector<char*>     m_seiCfgFileNames;               ///< SEI message files.
261  SEIMessages            m_seiMessages;                       ///< Buffer for SEI messages.
262#endif
263
264  Bool      m_bUseAdaptiveQP;                                 ///< Flag for enabling QP adaptation based on a psycho-visual model
265  Int       m_iQPAdaptationRange;                             ///< dQP range by QP adaptation
266
267#if NH_MV
268  Int       m_maxTempLayerMvc[MAX_NUM_LAYER_IDS];             ///< Max temporal layer for each layer
269#else
270  Int       m_maxTempLayer;                                  ///< Max temporal layer
271#endif
272
273  // coding unit (CU) definition
274  // TODO: Remove MaxCUWidth/MaxCUHeight and replace with MaxCUSize.
275  UInt      m_uiMaxCUWidth;                                   ///< max. CU width in pixel
276  UInt      m_uiMaxCUHeight;                                  ///< max. CU height in pixel
277  UInt      m_uiMaxCUDepth;                                   ///< max. CU depth (as specified by command line)
278  UInt      m_uiMaxTotalCUDepth;                              ///< max. total CU depth - includes depth of transform-block structure
279  UInt      m_uiLog2DiffMaxMinCodingBlockSize;                ///< difference between largest and smallest CU depth
280
281  // transfom unit (TU) definition
282  UInt      m_uiQuadtreeTULog2MaxSize;
283  UInt      m_uiQuadtreeTULog2MinSize;
284
285  UInt      m_uiQuadtreeTUMaxDepthInter;
286  UInt      m_uiQuadtreeTUMaxDepthIntra;
287
288  // coding tools (bit-depth)
289  Int       m_inputBitDepth   [MAX_NUM_CHANNEL_TYPE];         ///< bit-depth of input file
290  Int       m_outputBitDepth  [MAX_NUM_CHANNEL_TYPE];         ///< bit-depth of output file
291  Int       m_MSBExtendedBitDepth[MAX_NUM_CHANNEL_TYPE];      ///< bit-depth of input samples after MSB extension
292  Int       m_internalBitDepth[MAX_NUM_CHANNEL_TYPE];         ///< bit-depth codec operates at (input/output files will be converted)
293  Bool      m_extendedPrecisionProcessingFlag;
294  Bool      m_highPrecisionOffsetsEnabledFlag;
295
296  //coding tools (chroma format)
297  ChromaFormat m_chromaFormatIDC;
298
299  // coding tools (PCM bit-depth)
300  Bool      m_bPCMInputBitDepthFlag;                          ///< 0: PCM bit-depth is internal bit-depth. 1: PCM bit-depth is input bit-depth.
301
302  // coding tool (SAO)
303#if NH_MV
304  std::vector<Bool> m_bUseSAO; 
305#else
306  Bool      m_bUseSAO;
307#endif
308  Bool      m_bTestSAODisableAtPictureLevel;
309  Double    m_saoEncodingRate;                                ///< When >0 SAO early picture termination is enabled for luma and chroma
310  Double    m_saoEncodingRateChroma;                          ///< The SAO early picture termination rate to use for chroma (when m_SaoEncodingRate is >0). If <=0, use results for luma.
311  Int       m_maxNumOffsetsPerPic;                            ///< SAO maximun number of offset per picture
312  Bool      m_saoCtuBoundary;                                 ///< SAO parameter estimation using non-deblocked pixels for CTU bottom and right boundary areas
313  // coding tools (loop filter)
314#if NH_MV
315  std::vector<Bool> m_bLoopFilterDisable;                     ///< flag for using deblocking filter for each layer
316#else
317  Bool      m_bLoopFilterDisable;                             ///< flag for using deblocking filter
318#endif
319  Bool      m_loopFilterOffsetInPPS;                         ///< offset for deblocking filter in 0 = slice header, 1 = PPS
320  Int       m_loopFilterBetaOffsetDiv2;                     ///< beta offset for deblocking filter
321  Int       m_loopFilterTcOffsetDiv2;                       ///< tc offset for deblocking filter
322  Bool      m_DeblockingFilterMetric;                         ///< blockiness metric in encoder
323
324  // coding tools (PCM)
325  Bool      m_usePCM;                                         ///< flag for using IPCM
326  UInt      m_pcmLog2MaxSize;                                 ///< log2 of maximum PCM block size
327  UInt      m_uiPCMLog2MinSize;                               ///< log2 of minimum PCM block size
328  Bool      m_bPCMFilterDisableFlag;                          ///< PCM filter disable flag
329  Bool      m_enableIntraReferenceSmoothing;                  ///< flag for enabling(default)/disabling intra reference smoothing/filtering
330
331  // coding tools (encoder-only parameters)
332  Bool      m_bUseASR;                                        ///< flag for using adaptive motion search range
333  Bool      m_bUseHADME;                                      ///< flag for using HAD in sub-pel ME
334  Bool      m_useRDOQ;                                       ///< flag for using RD optimized quantization
335  Bool      m_useRDOQTS;                                     ///< flag for using RD optimized quantization for transform skip
336#if T0196_SELECTIVE_RDOQ
337  Bool      m_useSelectiveRDOQ;                               ///< flag for using selective RDOQ
338#endif
339  Int       m_rdPenalty;                                      ///< RD-penalty for 32x32 TU for intra in non-intra slices (0: no RD-penalty, 1: RD-penalty, 2: maximum RD-penalty)
340  Bool      m_bDisableIntraPUsInInterSlices;                  ///< Flag for disabling intra predicted PUs in inter slices.
341  MESearchMethod m_motionEstimationSearchMethod;
342  Bool      m_bRestrictMESampling;                            ///< Restrict sampling for the Selective ME
343  Int       m_iSearchRange;                                   ///< ME search range
344  Int       m_bipredSearchRange;                              ///< ME search range for bipred refinement
345  Int       m_minSearchWindow;                                ///< ME minimum search window size for the Adaptive Window ME
346  Bool      m_bClipForBiPredMeEnabled;                        ///< Enables clipping for Bi-Pred ME.
347  Bool      m_bFastMEAssumingSmootherMVEnabled;               ///< Enables fast ME assuming a smoother MV.
348#if NH_MV
349  Bool      m_bUseDisparitySearchRangeRestriction;            ///< restrict vertical search range for inter-view prediction
350  Int       m_iVerticalDisparitySearchRange;                  ///< ME vertical search range for inter-view prediction
351#endif
352  FastInterSearchMode m_fastInterSearchMode;                  ///< Parameter that controls fast encoder settings
353  Bool      m_bUseEarlyCU;                                    ///< flag for using Early CU setting
354  Bool      m_useFastDecisionForMerge;                        ///< flag for using Fast Decision Merge RD-Cost
355  Bool      m_bUseCbfFastMode;                              ///< flag for using Cbf Fast PU Mode Decision
356  Bool      m_useEarlySkipDetection;                         ///< flag for using Early SKIP Detection
357  SliceConstraint m_sliceMode;
358  Int       m_sliceArgument;                                 ///< argument according to selected slice mode
359  SliceConstraint m_sliceSegmentMode;
360  Int       m_sliceSegmentArgument;                          ///< argument according to selected slice segment mode
361
362  Bool      m_bLFCrossSliceBoundaryFlag;  ///< 1: filter across slice boundaries 0: do not filter across slice boundaries
363  Bool      m_bLFCrossTileBoundaryFlag;   ///< 1: filter across tile boundaries  0: do not filter across tile boundaries
364  Bool      m_tileUniformSpacingFlag;
365  Int       m_numTileColumnsMinus1;
366  Int       m_numTileRowsMinus1;
367  std::vector<Int> m_tileColumnWidth;
368  std::vector<Int> m_tileRowHeight;
369  Bool      m_entropyCodingSyncEnabledFlag;
370
371  Bool      m_bUseConstrainedIntraPred;                       ///< flag for using constrained intra prediction
372  Bool      m_bFastUDIUseMPMEnabled;
373  Bool      m_bFastMEForGenBLowDelayEnabled;
374  Bool      m_bUseBLambdaForNonKeyLowDelayPictures;
375
376  HashType  m_decodedPictureHashSEIType;                      ///< Checksum mode for decoded picture hash SEI message
377  Bool      m_recoveryPointSEIEnabled;
378  Bool      m_bufferingPeriodSEIEnabled;
379  Bool      m_pictureTimingSEIEnabled;
380  Bool      m_toneMappingInfoSEIEnabled;
381  Bool      m_chromaResamplingFilterSEIenabled;
382  Int       m_chromaResamplingHorFilterIdc;
383  Int       m_chromaResamplingVerFilterIdc;
384  Int       m_toneMapId;
385  Bool      m_toneMapCancelFlag;
386  Bool      m_toneMapPersistenceFlag;
387  Int       m_toneMapCodedDataBitDepth;
388  Int       m_toneMapTargetBitDepth;
389  Int       m_toneMapModelId;
390  Int       m_toneMapMinValue;
391  Int       m_toneMapMaxValue;
392  Int       m_sigmoidMidpoint;
393  Int       m_sigmoidWidth;
394  Int       m_numPivots;
395  Int       m_cameraIsoSpeedIdc;
396  Int       m_cameraIsoSpeedValue;
397  Int       m_exposureIndexIdc;
398  Int       m_exposureIndexValue;
399  Bool      m_exposureCompensationValueSignFlag;
400  Int       m_exposureCompensationValueNumerator;
401  Int       m_exposureCompensationValueDenomIdc;
402  Int       m_refScreenLuminanceWhite;
403  Int       m_extendedRangeWhiteLevel;
404  Int       m_nominalBlackLevelLumaCodeValue;
405  Int       m_nominalWhiteLevelLumaCodeValue;
406  Int       m_extendedWhiteLevelLumaCodeValue;
407  Int*      m_startOfCodedInterval;
408  Int*      m_codedPivotValue;
409  Int*      m_targetPivotValue;
410  Bool      m_framePackingSEIEnabled;
411  Int       m_framePackingSEIType;
412  Int       m_framePackingSEIId;
413  Int       m_framePackingSEIQuincunx;
414  Int       m_framePackingSEIInterpretation;
415  Bool      m_segmentedRectFramePackingSEIEnabled;
416  Bool      m_segmentedRectFramePackingSEICancel;
417  Int       m_segmentedRectFramePackingSEIType;
418  Bool      m_segmentedRectFramePackingSEIPersistence;
419  Int       m_displayOrientationSEIAngle;
420  Bool      m_temporalLevel0IndexSEIEnabled;
421  Bool      m_gradualDecodingRefreshInfoEnabled;
422  Int       m_noDisplaySEITLayer;
423  Bool      m_decodingUnitInfoSEIEnabled;
424  Bool      m_SOPDescriptionSEIEnabled;
425  Bool      m_scalableNestingSEIEnabled;
426  Bool      m_tmctsSEIEnabled;
427  Bool      m_timeCodeSEIEnabled;
428  Int       m_timeCodeSEINumTs;
429  TComSEITimeSet m_timeSetArray[MAX_TIMECODE_SEI_SETS];
430  Bool      m_kneeSEIEnabled;
431  Int       m_kneeSEIId;
432  Bool      m_kneeSEICancelFlag;
433  Bool      m_kneeSEIPersistenceFlag;
434  Int       m_kneeSEIInputDrange;
435  Int       m_kneeSEIInputDispLuminance;
436  Int       m_kneeSEIOutputDrange;
437  Int       m_kneeSEIOutputDispLuminance;
438  Int       m_kneeSEINumKneePointsMinus1;
439  Int*      m_kneeSEIInputKneePoint;
440  Int*      m_kneeSEIOutputKneePoint;
441  // weighted prediction
442  Bool      m_useWeightedPred;                    ///< Use of weighted prediction in P slices
443  Bool      m_useWeightedBiPred;                  ///< Use of bi-directional weighted prediction in B slices
444  WeightedPredictionMethod m_weightedPredictionMethod;
445
446  UInt      m_log2ParallelMergeLevel;                         ///< Parallel merge estimation region
447  UInt      m_maxNumMergeCand;                                ///< Max number of merge candidates
448
449  Int       m_TMVPModeId;
450  Bool      m_signHideFlag;
451  Bool      m_RCEnableRateControl;                ///< enable rate control or not
452  Int       m_RCTargetBitrate;                    ///< target bitrate when rate control is enabled
453  Int       m_RCKeepHierarchicalBit;              ///< 0: equal bit allocation; 1: fixed ratio bit allocation; 2: adaptive ratio bit allocation
454  Bool      m_RCLCULevelRC;                       ///< true: LCU level rate control; false: picture level rate control NOTE: code-tidy - rename to m_RCCtuLevelRC
455  Bool      m_RCUseLCUSeparateModel;              ///< use separate R-lambda model at LCU level                        NOTE: code-tidy - rename to m_RCUseCtuSeparateModel
456  Int       m_RCInitialQP;                        ///< inital QP for rate control
457  Bool      m_RCForceIntraQP;                     ///< force all intra picture to use initial QP or not
458
459#if U0132_TARGET_BITS_SATURATION
460  Bool      m_RCCpbSaturationEnabled;             ///< enable target bits saturation to avoid CPB overflow and underflow
461  UInt      m_RCCpbSize;                          ///< CPB size
462  Double    m_RCInitialCpbFullness;               ///< initial CPB fullness
463#endif
464
465#if KWU_RC_VIEWRC_E0227
466  vector<Int>     m_viewTargetBits;
467  Bool      m_viewWiseRateCtrl;                              ///< Flag for using view-wise rate control
468#endif
469#if KWU_RC_MADPRED_E0227
470  UInt       m_depthMADPred;
471#endif
472
473  ScalingListMode m_useScalingListId;                         ///< using quantization matrix
474  std::string m_scalingListFileName;                          ///< quantization matrix file name
475
476  Bool      m_TransquantBypassEnableFlag;                     ///< transquant_bypass_enable_flag setting in PPS.
477  Bool      m_CUTransquantBypassFlagForce;                    ///< if transquant_bypass_enable_flag, then, if true, all CU transquant bypass flags will be set to true.
478  CostMode  m_costMode;                                       ///< Cost mode to use
479
480  Bool      m_recalculateQPAccordingToLambda;                 ///< recalculate QP value according to the lambda value
481  Bool      m_useStrongIntraSmoothing;                        ///< enable strong intra smoothing for 32x32 blocks where the reference samples are flat
482  Int       m_activeParameterSetsSEIEnabled;
483
484  Bool      m_vuiParametersPresentFlag;                       ///< enable generation of VUI parameters
485  Bool      m_aspectRatioInfoPresentFlag;                     ///< Signals whether aspect_ratio_idc is present
486  Int       m_aspectRatioIdc;                                 ///< aspect_ratio_idc
487  Int       m_sarWidth;                                       ///< horizontal size of the sample aspect ratio
488  Int       m_sarHeight;                                      ///< vertical size of the sample aspect ratio
489  Bool      m_overscanInfoPresentFlag;                        ///< Signals whether overscan_appropriate_flag is present
490  Bool      m_overscanAppropriateFlag;                        ///< Indicates whether conformant decoded pictures are suitable for display using overscan
491  Bool      m_videoSignalTypePresentFlag;                     ///< Signals whether video_format, video_full_range_flag, and colour_description_present_flag are present
492  Int       m_videoFormat;                                    ///< Indicates representation of pictures
493  Bool      m_videoFullRangeFlag;                             ///< Indicates the black level and range of luma and chroma signals
494  Bool      m_colourDescriptionPresentFlag;                   ///< Signals whether colour_primaries, transfer_characteristics and matrix_coefficients are present
495  Int       m_colourPrimaries;                                ///< Indicates chromaticity coordinates of the source primaries
496  Int       m_transferCharacteristics;                        ///< Indicates the opto-electronic transfer characteristics of the source
497  Int       m_matrixCoefficients;                             ///< Describes the matrix coefficients used in deriving luma and chroma from RGB primaries
498  Bool      m_chromaLocInfoPresentFlag;                       ///< Signals whether chroma_sample_loc_type_top_field and chroma_sample_loc_type_bottom_field are present
499  Int       m_chromaSampleLocTypeTopField;                    ///< Specifies the location of chroma samples for top field
500  Int       m_chromaSampleLocTypeBottomField;                 ///< Specifies the location of chroma samples for bottom field
501  Bool      m_neutralChromaIndicationFlag;                    ///< Indicates that the value of all decoded chroma samples is equal to 1<<(BitDepthCr-1)
502  Bool      m_defaultDisplayWindowFlag;                       ///< Indicates the presence of the default window parameters
503  Int       m_defDispWinLeftOffset;                           ///< Specifies the left offset from the conformance window of the default window
504  Int       m_defDispWinRightOffset;                          ///< Specifies the right offset from the conformance window of the default window
505  Int       m_defDispWinTopOffset;                            ///< Specifies the top offset from the conformance window of the default window
506  Int       m_defDispWinBottomOffset;                         ///< Specifies the bottom offset from the conformance window of the default window
507  Bool      m_frameFieldInfoPresentFlag;                      ///< Indicates that pic_struct values are present in picture timing SEI messages
508  Bool      m_pocProportionalToTimingFlag;                    ///< Indicates that the POC value is proportional to the output time w.r.t. first picture in CVS
509  Int       m_numTicksPocDiffOneMinus1;                       ///< Number of ticks minus 1 that for a POC difference of one
510  Bool      m_bitstreamRestrictionFlag;                       ///< Signals whether bitstream restriction parameters are present
511  Bool      m_tilesFixedStructureFlag;                        ///< Indicates that each active picture parameter set has the same values of the syntax elements related to tiles
512  Bool      m_motionVectorsOverPicBoundariesFlag;             ///< Indicates that no samples outside the picture boundaries are used for inter prediction
513  Int       m_minSpatialSegmentationIdc;                      ///< Indicates the maximum size of the spatial segments in the pictures in the coded video sequence
514  Int       m_maxBytesPerPicDenom;                            ///< Indicates a number of bytes not exceeded by the sum of the sizes of the VCL NAL units associated with any coded picture
515  Int       m_maxBitsPerMinCuDenom;                           ///< Indicates an upper bound for the number of bits of coding_unit() data
516  Int       m_log2MaxMvLengthHorizontal;                      ///< Indicate the maximum absolute value of a decoded horizontal MV component in quarter-pel luma units
517  Int       m_log2MaxMvLengthVertical;                        ///< Indicate the maximum absolute value of a decoded vertical MV component in quarter-pel luma units
518  std::string m_colourRemapSEIFileRoot;
519
520  std::string m_summaryOutFilename;                           ///< filename to use for producing summary output file.
521  std::string m_summaryPicFilenameBase;                       ///< Base filename to use for producing summary picture output files. The actual filenames used will have I.txt, P.txt and B.txt appended.
522  UInt        m_summaryVerboseness;                           ///< Specifies the level of the verboseness of the text output.
523#if NH_MV
524#if !NH_MV_SEI
525  Bool              m_subBistreamPropSEIEnabled;
526  Int               m_sbPropNumAdditionalSubStreams;
527  IntAry1d          m_sbPropSubBitstreamMode;
528  IntAry1d          m_sbPropOutputLayerSetIdxToVps;
529  IntAry1d          m_sbPropHighestSublayerId;
530  IntAry1d          m_sbPropAvgBitRate;
531  IntAry1d          m_sbPropMaxBitRate;
532#endif
533  Bool              m_outputVpsInfo;
534#endif
535#if NH_3D
536  // Output Format
537  Bool      m_depth420OutputFlag;                             ///< Output depth layers in 4:2:0 format
538  // Camera parameters
539  TChar*    m_pchCameraParameterFile;                         ///< camera parameter file
540  TChar*    m_pchBaseViewCameraNumbers;
541  TAppComCamPara m_cCameraData;
542  Int       m_iCodedCamParPrecision;                          ///< precision for coding of camera parameters
543#if NH_3D_VSO
544  TChar*    m_pchVSOConfig;
545  Bool      m_bUseVSO;                                        ///< flag for using View Synthesis Optimization
546  Bool      m_bVSOLSTable;                                    ///< Depth QP dependent Lagrange parameter optimization (m23714)
547  Bool      m_bVSOEarlySkip;                                  ///< Early skip of VSO computation (JCT3V-A0093 modification 4)
548                                                             
549  //// Used for development by GT, might be removed later     
550  Double    m_dLambdaScaleVSO;                                ///< Scaling factor for Lambda in VSO mode
551  Bool      m_bForceLambdaScaleVSO;                           ///< Use Lambda Scale for depth even if VSO is turned off
552  Bool      m_bAllowNegDist;                                  ///< Allow negative distortion in VSO
553  UInt      m_uiVSOMode;                                      ///< Number of VSO Mode, 1 = , 2 = simple, org vs. ren, 3 = simple, ren vs. ren, 4 = full 
554                                                             
555  // SAIT_VSO_EST_A0033                                       
556  Bool      m_bUseEstimatedVSD;                               ///< Flag for using model based VSD estimation instead of VSO for some encoder decisions (JCT3V-A0033 modification 3) 
557                                                             
558  // LGE_WVSO_A0119                                           
559  Bool      m_bUseWVSO;                                       ///< flag for using View Synthesis Optimization 
560  Int       m_iVSOWeight;
561  Int       m_iVSDWeight;
562  Int       m_iDWeight;
563
564  // Ren Model String
565  TRenModSetupStrParser       m_cRenModStrParser;
566#endif
567
568  Bool       m_useDLT;                                        ///< flag for using DLT
569  Bool       m_bUseQTL;                                        ///< flag for using depth QuadTree Limitation
570  BoolAry1d  m_ivMvPredFlag;
571  BoolAry1d  m_ivMvScalingFlag;
572  Int        m_log2SubPbSizeMinus3;
573  Bool       m_ivResPredFlag;
574  Bool       m_depthRefinementFlag;
575  Bool       m_viewSynthesisPredFlag;
576  Bool       m_depthBasedBlkPartFlag;
577  Bool       m_mpiFlag;
578  Int        m_log2MpiSubPbSizeMinus3;
579  Bool       m_intraContourFlag;
580  Bool       m_intraWedgeFlag;
581  Bool       m_intraSdcFlag;
582  Bool       m_qtPredFlag;
583  Bool       m_interSdcFlag;
584  Bool       m_depthIntraSkipFlag; 
585#endif
586  // internal member functions
587  Void  xCheckParameter ();                                   ///< check validity of configuration values
588  Void  xPrintParameter ();                                   ///< print configuration values
589  Void  xPrintUsage     ();                                   ///< print usage
590#if NH_MV
591
592  template<typename T>
593  Void xReadStrToEnum(string in, std::vector<T> &val)
594  {
595    val.clear(); 
596
597    char* cElement = NULL;
598    char* cString = new char[in.size()+1];
599    strcpy(cString, in.c_str());
600
601    cElement = strtok( cString, " " );
602    while ( cElement != NULL )
603    {
604      T profile;       
605      std::istringstream ss( cElement ); 
606      ss >> profile; 
607      val.push_back( profile ); 
608      cElement = strtok( NULL, " " );
609    }
610    delete[] cString;
611  }
612
613
614  template <typename T>
615  Void xResizeVector(  std::vector<T> & rpcVector )
616  {
617    for( Int layer = 0; rpcVector.size() < m_numberOfLayers; layer++ )
618    {
619      assert( rpcVector.size() > 0 );
620      rpcVector.push_back( rpcVector[layer] );     
621    }
622
623    for( ; rpcVector.size() > m_numberOfLayers; )
624    {     
625      rpcVector.pop_back( );     
626    }
627  }
628
629  template <typename T>
630  Void xResizeVector(  std::vector<T> & rpcVector, UInt n )
631  {
632    for( Int layer = 0; rpcVector.size() < n; layer++ )
633    {
634      assert( rpcVector.size() > 0 );
635      rpcVector.push_back( rpcVector[layer] );     
636    }
637
638    for( ; rpcVector.size() > n; )
639    {     
640      rpcVector.pop_back( );     
641    }
642  }
643
644
645  template <typename T>
646  Void xPrintParaVector( std::string description, std::vector<T> & rpcVector )
647  {
648    Int iSpace = max(1, ENC_CFG_CONSOUT_SPACE - (Int) description.length() ); 
649   
650    for ( Int i = 0; i < iSpace; i++ )
651    {
652      description.append( " " ); 
653    }
654     
655    description.append( ":" ); 
656    printf( "%s", description.c_str() ); 
657
658    for(Int i=0;i<rpcVector.size();i++)
659    {
660      xPrintVectorElem( rpcVector[i] );
661    }
662
663    printf("\n");
664  }
665 
666  Void xPrintVectorElem( UInt   elem ) { printf(" %d"   , elem            );};
667  Void xPrintVectorElem( Int    elem ) { printf(" %d"   , elem            );};
668 
669  Void xPrintVectorElem( Double elem ) { printf(" %5.2f", elem            );}; 
670  Void xPrintVectorElem( Bool   elem ) { printf(" %d"   , ( elem ? 1 : 0 ));};
671#if NH_MV_SEI
672  Void xParseSeiCfg();
673#endif
674#endif
675#if NH_MV
676  Int   getGOPSize() { return m_iGOPSize; }
677#endif
678public:
679  TAppEncCfg();
680  virtual ~TAppEncCfg();
681
682public:
683  Void  create    ();                                         ///< create option handling class
684  Void  destroy   ();                                         ///< destroy option handling class
685  Bool  parseCfg  ( Int argc, TChar* argv[] );                ///< parse configuration file to fill member variables
686
687};// END CLASS DEFINITION TAppEncCfg
688
689//! \}
690
691#endif // __TAPPENCCFG__
692
Note: See TracBrowser for help on using the repository browser.