Context navigation

TAppEncCfg.h @ 1402

Visit:

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

Note: See TracBrowser for help on using the repository browser.

JCT-3V 3D-HEVC

Context navigation

source: 3DVCSoftware/branches/HTM-16.1-dev/source/App/TAppEncoder/TAppEncCfg.h @ 1402

Download in other formats: