Context navigation

TAppEncCfg.h @ 389

Visit:

Last change on this file since 389 was 389, checked in by qualcomm, 11 years ago

Signaling representation format in VPS (MACRO: REPN_FORMAT_IN_VPS)

Includes signaling of representation format - including picture resolution, bit depth, chroma format - in the VPS, with the option of updating them in the SPS. The configuration file has "RepFormatIdx%d" added to indicate for each layer which representation format is used. The rep_format() structures are automatically created by the encoder. If the bit depth and the chroma format are also changed across layers, some more configuration support would be needed.

From: Adarsh K. Ramasubramonian <aramasub@…>

Property svn:eol-style set to native

File size: 24.4 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-2013, 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	#if SVC_EXTENSION
45	#include "TAppEncLayerCfg.h"
46	#endif
47	#include <sstream>
48	//! \ingroup TAppEncoder
49	//! \{
50
51	// ====================================================================================================================
52	// Class definition
53	// ====================================================================================================================
54
55	/// encoder configuration class
56	class TAppEncCfg
57	{
58	protected:
59	// file I/O
60	#if SVC_EXTENSION
61	TAppEncLayerCfg m_acLayerCfg [MAX_LAYERS];
62	Int m_numLayers; ///< number of layers
63	Int m_scalabilityMask[MAX_VPS_NUM_SCALABILITY_TYPES]; ///< scalability_mask
64	Char* m_pBitstreamFile; ///< output bitstream file
65	Double m_adLambdaModifier[ MAX_TLAYER ]; ///< Lambda modifier array for each temporal layer
66	// source specification
67	UInt m_FrameSkip; ///< number of skipped frames from the beginning
68	Int m_framesToBeEncoded; ///< number of encoded frames
69	#if AVC_BASE
70	Int m_avcBaseLayerFlag; ///< AVC_BASElayer_flag
71	#endif
72	#if AVC_SYNTAX
73	Char* m_BLSyntaxFile; ///< input syntax file
74	#endif
75	#if M0457_IL_SAMPLE_PRED_ONLY_FLAG
76	Int m_ilSampleOnlyPred[ MAX_LAYERS ];
77	#endif
78	#else
79	Char* m_pchInputFile; ///< source file name
80	Char* m_pchBitstreamFile; ///< output bitstream file
81	Char* m_pchReconFile; ///< output reconstruction file
82	Double m_adLambdaModifier[ MAX_TLAYER ]; ///< Lambda modifier array for each temporal layer
83	// source specification
84	Int m_iFrameRate; ///< source frame-rates (Hz)
85	UInt m_FrameSkip; ///< number of skipped frames from the beginning
86	Int m_iSourceWidth; ///< source width in pixel
87	Int m_iSourceHeight; ///< source height in pixel
88	Int m_conformanceMode;
89	Int m_confLeft;
90	Int m_confRight;
91	Int m_confTop;
92	Int m_confBottom;
93	Int m_framesToBeEncoded; ///< number of encoded frames
94	Int m_aiPad[2]; ///< number of padded pixels for width and height
95	#endif
96
97	// profile/level
98	Profile::Name m_profile;
99	Level::Tier m_levelTier;
100	Level::Name m_level;
101	Bool m_progressiveSourceFlag;
102	Bool m_interlacedSourceFlag;
103	Bool m_nonPackedConstraintFlag;
104	Bool m_frameOnlyConstraintFlag;
105
106	// coding structure
107	#if !SVC_EXTENSION
108	Int m_iIntraPeriod; ///< period of I-slice (random access period)
109	#endif
110	Int m_iDecodingRefreshType; ///< random access type
111	Int m_iGOPSize; ///< GOP size of hierarchical structure
112	Int m_extraRPSs; ///< extra RPSs added to handle CRA
113	GOPEntry m_GOPList[MAX_GOP]; ///< the coding structure entries from the config file
114	Int m_numReorderPics[MAX_TLAYER]; ///< total number of reorder pictures
115	Int m_maxDecPicBuffering[MAX_TLAYER]; ///< total number of pictures in the decoded picture buffer
116	Bool m_useTransformSkip; ///< flag for enabling intra transform skipping
117	Bool m_useTransformSkipFast; ///< flag for enabling fast intra transform skipping
118	Bool m_enableAMP;
119	// coding quality
120	#if !SVC_EXTENSION
121	Double m_fQP; ///< QP value of key-picture (floating point)
122	Int m_iQP; ///< QP value of key-picture (integer)
123	Char* m_pchdQPFile; ///< QP offset for each slice (initialized from external file)
124	Int* m_aidQP; ///< array of slice QP values
125	#endif
126	Int m_iMaxDeltaQP; ///< max. \|delta QP\|
127	UInt m_uiDeltaQpRD; ///< dQP range for multi-pass slice QP optimization
128	Int m_iMaxCuDQPDepth; ///< Max. depth for a minimum CuDQPSize (0:default)
129
130	Int m_cbQpOffset; ///< Chroma Cb QP Offset (0:default)
131	Int m_crQpOffset; ///< Chroma Cr QP Offset (0:default)
132
133	#if ADAPTIVE_QP_SELECTION
134	Bool m_bUseAdaptQpSelect;
135	#endif
136
137	Bool m_bUseAdaptiveQP; ///< Flag for enabling QP adaptation based on a psycho-visual model
138	Int m_iQPAdaptationRange; ///< dQP range by QP adaptation
139
140	Int m_maxTempLayer; ///< Max temporal layer
141
142	// coding unit (CU) definition
143	UInt m_uiMaxCUWidth; ///< max. CU width in pixel
144	UInt m_uiMaxCUHeight; ///< max. CU height in pixel
145	UInt m_uiMaxCUDepth; ///< max. CU depth
146
147	// transfom unit (TU) definition
148	UInt m_uiQuadtreeTULog2MaxSize;
149	UInt m_uiQuadtreeTULog2MinSize;
150
151	UInt m_uiQuadtreeTUMaxDepthInter;
152	UInt m_uiQuadtreeTUMaxDepthIntra;
153
154	// coding tools (bit-depth)
155	Int m_inputBitDepthY; ///< bit-depth of input file (luma component)
156	Int m_inputBitDepthC; ///< bit-depth of input file (chroma component)
157	Int m_outputBitDepthY; ///< bit-depth of output file (luma component)
158	Int m_outputBitDepthC; ///< bit-depth of output file (chroma component)
159	Int m_internalBitDepthY; ///< bit-depth codec operates at in luma (input/output files will be converted)
160	Int m_internalBitDepthC; ///< bit-depth codec operates at in chroma (input/output files will be converted)
161
162	// coding tools (PCM bit-depth)
163	Bool m_bPCMInputBitDepthFlag; ///< 0: PCM bit-depth is internal bit-depth. 1: PCM bit-depth is input bit-depth.
164
165	// coding tool (lossless)
166	Bool m_useLossless; ///< flag for using lossless coding
167	Bool m_bUseSAO;
168	Int m_maxNumOffsetsPerPic; ///< SAO maximun number of offset per picture
169	Bool m_saoLcuBoundary; ///< SAO parameter estimation using non-deblocked pixels for LCU bottom and right boundary areas
170	Bool m_saoLcuBasedOptimization; ///< SAO LCU-based optimization
171	// coding tools (loop filter)
172	Bool m_bLoopFilterDisable; ///< flag for using deblocking filter
173	Bool m_loopFilterOffsetInPPS; ///< offset for deblocking filter in 0 = slice header, 1 = PPS
174	Int m_loopFilterBetaOffsetDiv2; ///< beta offset for deblocking filter
175	Int m_loopFilterTcOffsetDiv2; ///< tc offset for deblocking filter
176	Bool m_DeblockingFilterControlPresent; ///< deblocking filter control present flag in PPS
177	Bool m_DeblockingFilterMetric; ///< blockiness metric in encoder
178
179	// coding tools (PCM)
180	Bool m_usePCM; ///< flag for using IPCM
181	UInt m_pcmLog2MaxSize; ///< log2 of maximum PCM block size
182	UInt m_uiPCMLog2MinSize; ///< log2 of minimum PCM block size
183	Bool m_bPCMFilterDisableFlag; ///< PCM filter disable flag
184
185	// coding tools (encoder-only parameters)
186	Bool m_bUseSBACRD; ///< flag for using RD optimization based on SBAC
187	Bool m_bUseASR; ///< flag for using adaptive motion search range
188	Bool m_bUseHADME; ///< flag for using HAD in sub-pel ME
189	Bool m_useRDOQ; ///< flag for using RD optimized quantization
190	Bool m_useRDOQTS; ///< flag for using RD optimized quantization for transform skip
191	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)
192	Int m_iFastSearch; ///< ME mode, 0 = full, 1 = diamond, 2 = PMVFAST
193	Int m_iSearchRange; ///< ME search range
194	Int m_bipredSearchRange; ///< ME search range for bipred refinement
195	Bool m_bUseFastEnc; ///< flag for using fast encoder setting
196	Bool m_bUseEarlyCU; ///< flag for using Early CU setting
197	Bool m_useFastDecisionForMerge; ///< flag for using Fast Decision Merge RD-Cost
198	Bool m_bUseCbfFastMode; ///< flag for using Cbf Fast PU Mode Decision
199	Bool m_useEarlySkipDetection; ///< flag for using Early SKIP Detection
200	#if FAST_INTRA_SHVC
201	Bool m_useFastIntraScalable; ///< flag for using Fast Intra Decision for Scalable HEVC
202	#endif
203	Int m_sliceMode; ///< 0: no slice limits, 1 : max number of CTBs per slice, 2: max number of bytes per slice,
204	///< 3: max number of tiles per slice
205	Int m_sliceArgument; ///< argument according to selected slice mode
206	Int m_sliceSegmentMode; ///< 0: no slice segment limits, 1 : max number of CTBs per slice segment, 2: max number of bytes per slice segment,
207	///< 3: max number of tiles per slice segment
208	Int m_sliceSegmentArgument; ///< argument according to selected slice segment mode
209
210	Bool m_bLFCrossSliceBoundaryFlag; ///< 1: filter across slice boundaries 0: do not filter across slice boundaries
211	Bool m_bLFCrossTileBoundaryFlag; ///< 1: filter across tile boundaries 0: do not filter across tile boundaries
212	Int m_iUniformSpacingIdr;
213	Int m_iNumColumnsMinus1;
214	Char* m_pchColumnWidth;
215	Int m_iNumRowsMinus1;
216	Char* m_pchRowHeight;
217	UInt* m_pColumnWidth;
218	UInt* m_pRowHeight;
219	Int m_iWaveFrontSynchro; //< 0: no WPP. >= 1: WPP is enabled, the "Top right" from which inheritance occurs is this LCU offset in the line above the current.
220	#if !SVC_EXTENSION
221	Int m_iWaveFrontSubstreams; //< If iWaveFrontSynchro, this is the number of substreams per frame (dependent tiles) or per tile (independent tiles).
222	#endif
223
224	Bool m_bUseConstrainedIntraPred; ///< flag for using constrained intra prediction
225
226	Int m_decodedPictureHashSEIEnabled; ///< Checksum(3)/CRC(2)/MD5(1)/disable(0) acting on decoded picture hash SEI message
227	Int m_recoveryPointSEIEnabled;
228	Int m_bufferingPeriodSEIEnabled;
229	Int m_pictureTimingSEIEnabled;
230	Bool m_toneMappingInfoSEIEnabled;
231	Int m_toneMapId;
232	Bool m_toneMapCancelFlag;
233	Bool m_toneMapPersistenceFlag;
234	Int m_toneMapCodedDataBitDepth;
235	Int m_toneMapTargetBitDepth;
236	Int m_toneMapModelId;
237	Int m_toneMapMinValue;
238	Int m_toneMapMaxValue;
239	Int m_sigmoidMidpoint;
240	Int m_sigmoidWidth;
241	Int m_numPivots;
242	Int m_cameraIsoSpeedIdc;
243	Int m_cameraIsoSpeedValue;
244	Int m_exposureCompensationValueSignFlag;
245	Int m_exposureCompensationValueNumerator;
246	Int m_exposureCompensationValueDenomIdc;
247	Int m_refScreenLuminanceWhite;
248	Int m_extendedRangeWhiteLevel;
249	Int m_nominalBlackLevelLumaCodeValue;
250	Int m_nominalWhiteLevelLumaCodeValue;
251	Int m_extendedWhiteLevelLumaCodeValue;
252	Int* m_startOfCodedInterval;
253	Int* m_codedPivotValue;
254	Int* m_targetPivotValue;
255	Int m_framePackingSEIEnabled;
256	Int m_framePackingSEIType;
257	Int m_framePackingSEIId;
258	Int m_framePackingSEIQuincunx;
259	Int m_framePackingSEIInterpretation;
260	Int m_displayOrientationSEIAngle;
261	Int m_temporalLevel0IndexSEIEnabled;
262	Int m_gradualDecodingRefreshInfoEnabled;
263	Int m_decodingUnitInfoSEIEnabled;
264	#if M0043_LAYERS_PRESENT_SEI
265	Int m_layersPresentSEIEnabled;
266	#endif
267	Int m_SOPDescriptionSEIEnabled;
268	Int m_scalableNestingSEIEnabled;
269	// weighted prediction
270	Bool m_useWeightedPred; ///< Use of weighted prediction in P slices
271	Bool m_useWeightedBiPred; ///< Use of bi-directional weighted prediction in B slices
272
273	UInt m_log2ParallelMergeLevel; ///< Parallel merge estimation region
274	UInt m_maxNumMergeCand; ///< Max number of merge candidates
275
276	Int m_TMVPModeId;
277	Int m_signHideFlag;
278	#if RATE_CONTROL_LAMBDA_DOMAIN
279	#if !RC_SHVC_HARMONIZATION
280	Bool m_RCEnableRateControl; ///< enable rate control or not
281	Int m_RCTargetBitrate; ///< target bitrate when rate control is enabled
282	#if M0036_RC_IMPROVEMENT
283	Int m_RCKeepHierarchicalBit; ///< 0: equal bit allocation; 1: fixed ratio bit allocation; 2: adaptive ratio bit allocation
284	#else
285	Bool m_RCKeepHierarchicalBit; ///< whether keeping hierarchical bit allocation structure or not
286	#endif
287	Bool m_RCLCULevelRC; ///< true: LCU level rate control; false: picture level rate control
288	Bool m_RCUseLCUSeparateModel; ///< use separate R-lambda model at LCU level
289	Int m_RCInitialQP; ///< inital QP for rate control
290	Bool m_RCForceIntraQP; ///< force all intra picture to use initial QP or not
291	#endif
292	#else
293	Bool m_enableRateCtrl; ///< Flag for using rate control algorithm
294	Int m_targetBitrate; ///< target bitrate
295	Int m_numLCUInUnit; ///< Total number of LCUs in a frame should be completely divided by the NumLCUInUnit
296	#endif
297	Int m_useScalingListId; ///< using quantization matrix
298	Char* m_scalingListFile; ///< quantization matrix file name
299
300	Bool m_TransquantBypassEnableFlag; ///< transquant_bypass_enable_flag setting in PPS.
301	Bool m_CUTransquantBypassFlagValue; ///< if transquant_bypass_enable_flag, the fixed value to use for the per-CU cu_transquant_bypass_flag.
302
303	Bool m_recalculateQPAccordingToLambda; ///< recalculate QP value according to the lambda value
304	Bool m_useStrongIntraSmoothing; ///< enable strong intra smoothing for 32x32 blocks where the reference samples are flat
305	Int m_activeParameterSetsSEIEnabled;
306
307	Bool m_vuiParametersPresentFlag; ///< enable generation of VUI parameters
308	Bool m_aspectRatioInfoPresentFlag; ///< Signals whether aspect_ratio_idc is present
309	Int m_aspectRatioIdc; ///< aspect_ratio_idc
310	Int m_sarWidth; ///< horizontal size of the sample aspect ratio
311	Int m_sarHeight; ///< vertical size of the sample aspect ratio
312	Bool m_overscanInfoPresentFlag; ///< Signals whether overscan_appropriate_flag is present
313	Bool m_overscanAppropriateFlag; ///< Indicates whether conformant decoded pictures are suitable for display using overscan
314	Bool m_videoSignalTypePresentFlag; ///< Signals whether video_format, video_full_range_flag, and colour_description_present_flag are present
315	Int m_videoFormat; ///< Indicates representation of pictures
316	Bool m_videoFullRangeFlag; ///< Indicates the black level and range of luma and chroma signals
317	Bool m_colourDescriptionPresentFlag; ///< Signals whether colour_primaries, transfer_characteristics and matrix_coefficients are present
318	Int m_colourPrimaries; ///< Indicates chromaticity coordinates of the source primaries
319	Int m_transferCharacteristics; ///< Indicates the opto-electronic transfer characteristics of the source
320	Int m_matrixCoefficients; ///< Describes the matrix coefficients used in deriving luma and chroma from RGB primaries
321	Bool m_chromaLocInfoPresentFlag; ///< Signals whether chroma_sample_loc_type_top_field and chroma_sample_loc_type_bottom_field are present
322	Int m_chromaSampleLocTypeTopField; ///< Specifies the location of chroma samples for top field
323	Int m_chromaSampleLocTypeBottomField; ///< Specifies the location of chroma samples for bottom field
324	Bool m_neutralChromaIndicationFlag; ///< Indicates that the value of all decoded chroma samples is equal to 1<<(BitDepthCr-1)
325	Bool m_defaultDisplayWindowFlag; ///< Indicates the presence of the default window parameters
326	Int m_defDispWinLeftOffset; ///< Specifies the left offset from the conformance window of the default window
327	Int m_defDispWinRightOffset; ///< Specifies the right offset from the conformance window of the default window
328	Int m_defDispWinTopOffset; ///< Specifies the top offset from the conformance window of the default window
329	Int m_defDispWinBottomOffset; ///< Specifies the bottom offset from the conformance window of the default window
330	Bool m_frameFieldInfoPresentFlag; ///< Indicates that pic_struct values are present in picture timing SEI messages
331	Bool m_pocProportionalToTimingFlag; ///< Indicates that the POC value is proportional to the output time w.r.t. first picture in CVS
332	Int m_numTicksPocDiffOneMinus1; ///< Number of ticks minus 1 that for a POC difference of one
333	Bool m_bitstreamRestrictionFlag; ///< Signals whether bitstream restriction parameters are present
334	Bool m_tilesFixedStructureFlag; ///< Indicates that each active picture parameter set has the same values of the syntax elements related to tiles
335	Bool m_motionVectorsOverPicBoundariesFlag; ///< Indicates that no samples outside the picture boundaries are used for inter prediction
336	Int m_minSpatialSegmentationIdc; ///< Indicates the maximum size of the spatial segments in the pictures in the coded video sequence
337	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
338	Int m_maxBitsPerMinCuDenom; ///< Indicates an upper bound for the number of bits of coding_unit() data
339	Int m_log2MaxMvLengthHorizontal; ///< Indicate the maximum absolute value of a decoded horizontal MV component in quarter-pel luma units
340	Int m_log2MaxMvLengthVertical; ///< Indicate the maximum absolute value of a decoded vertical MV component in quarter-pel luma units
341
342	#if SVC_EXTENSION
343	Int m_elRapSliceBEnabled;
344	#endif
345	// internal member functions
346	Void xSetGlobal (); ///< set global variables
347	Void xCheckParameter (); ///< check validity of configuration values
348	Void xPrintParameter (); ///< print configuration values
349	Void xPrintUsage (); ///< print usage
350	#if FINAL_RPL_CHANGE_N0082
351	Bool xconfirmExtraGOP (GOPEntry * ge);
352	#endif
353	#if M0040_ADAPTIVE_RESOLUTION_CHANGE
354	Int m_adaptiveResolutionChange; ///< Indicate adaptive resolution change frame
355	#endif
356	#if REPN_FORMAT_IN_VPS
357	RepFormatCfg m_repFormatCfg[16]; ///< Rep_format structures
358	#endif
359	public:
360	TAppEncCfg();
361	virtual ~TAppEncCfg();
362
363	public:
364	Void create (); ///< create option handling class
365	Void destroy (); ///< destroy option handling class
366	Bool parseCfg ( Int argc, Char* argv[] ); ///< parse configuration file to fill member variables
367
368	#if SVC_EXTENSION
369	Int getNumFrameToBeEncoded() {return m_framesToBeEncoded; }
370	Int getNumLayer() {return m_numLayers; }
371	Int getGOPSize() {return m_iGOPSize; }
372	UInt getInternalBitDepthY() {return m_internalBitDepthY; }
373	UInt getInternalBitDepthC() {return m_internalBitDepthC; }
374	UInt getMaxCUWidth() {return m_uiMaxCUWidth; }
375	UInt getMaxCUHeight() {return m_uiMaxCUHeight; }
376	UInt getMaxCUDepth() {return m_uiMaxCUDepth; }
377	Int getDecodingRefreshType() {return m_iDecodingRefreshType; }
378	Int getWaveFrontSynchro() { return m_iWaveFrontSynchro; }
379	Void getDirFilename(string& filename, string& dir, const string path);
380	#if AVC_SYNTAX
381	Char* getBLSyntaxFile() { return m_BLSyntaxFile; }
382	#endif
383	#if SCALED_REF_LAYER_OFFSETS
384	Void cfgStringToArray(Int *arr, string cfgString, Int numEntries, const char logString);
385	#endif
386	#if REPN_FORMAT_IN_VPS
387	RepFormatCfg* getRepFormatCfg(Int i) { return &m_repFormatCfg[i]; }
388	#endif
389	#endif
390	};// END CLASS DEFINITION TAppEncCfg
391
392	//! \}
393
394	#endif // __TAPPENCCFG__
395

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

JCT-VC SHVC

Context navigation

source: SHVCSoftware/branches/SHM-3.1-dev/source/App/TAppEncoder/TAppEncCfg.h @ 389

Download in other formats: