Context navigation

source: 3DVCSoftware/trunk/source/App/TAppEncoder/TAppEncCfg.h @ 605

Visit:

Last change on this file since 605 was 443, checked in by tech, 12 years ago
Reintegrated branch 6.2-dev0 rev. 442. Changed version number. Added coding results.
Property svn:eol-style set to `native`
File size: 20.2 KB

Rev	Line
[5]	1	/* The copyright in this software is being made available under the BSD
	2	* License, included below. This software may be subject to other third party
	3	* and contributor rights, including patent rights, and no such rights are
[56]	4	* granted under this license.
[5]	5	*
[56]	6	* Copyright (c) 2010-2012, ITU/ISO/IEC
[5]	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.
[56]	17	* * Neither the name of the ITU/ISO/IEC nor the names of its contributors may
[5]	18	* be used to endorse or promote products derived from this software without
	19	* specific prior written permission.
	20	*
	21	* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
	22	* AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
	23	* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
	24	* ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS
	25	* BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
	26	* CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
	27	* SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
	28	* INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
	29	* CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
	30	* ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF
	31	* THE POSSIBILITY OF SUCH DAMAGE.
	32	*/
[2]	33
	34	/** \file TAppEncCfg.h
	35	\brief Handle encoder configuration parameters (header)
	36	*/
	37
	38	#ifndef __TAPPENCCFG__
	39	#define __TAPPENCCFG__
	40
[56]	41	#include "TLibCommon/CommonDef.h"
[2]	42
[56]	43	#include "TLibEncoder/TEncCfg.h"
	44	#include "TAppCommon/TAppComCamPara.h"
	45	#include "TLibRenderer/TRenTop.h"
	46	#include "TLibRenderer/TRenModel.h"
	47	#include "TLibRenderer/TRenModSetupStrParser.h"
	48
	49	#include <sstream>
[2]	50	#include <vector>
	51
[56]	52	//! \ingroup TAppEncoder
	53	//! \{
	54
[2]	55	// ====================================================================================================================
	56	// Class definition
	57	// ====================================================================================================================
	58
	59	/// encoder configuration class
	60	class TAppEncCfg
	61	{
	62	protected:
	63	// file I/O
	64	std::vector<char*> m_pchInputFileList; ///< source file names
	65	std::vector<char*> m_pchDepthInputFileList; ///< source depth file names
	66	std::vector<char*> m_pchReconFileList; ///< output reconstruction file names
	67	std::vector<char*> m_pchDepthReconFileList; ///< output depth reconstruction file names
[56]	68	char* m_pchBitstreamFile; ///< output bitstream file
	69	Double m_adLambdaModifier[ MAX_TLAYER ]; ///< Lambda modifier array for each temporal layer
[2]	70	// source specification
	71	Int m_iFrameRate; ///< source frame-rates (Hz)
	72	unsigned int m_FrameSkip; ///< number of skipped frames from the beginning
	73	Int m_iSourceWidth; ///< source width in pixel
	74	Int m_iSourceHeight; ///< source height in pixel
[56]	75	Int m_croppingMode;
	76	Int m_cropLeft;
	77	Int m_cropRight;
	78	Int m_cropTop;
	79	Int m_cropBottom;
[2]	80	Int m_iFrameToBeEncoded; ///< number of encoded frames
	81	Int m_aiPad[2]; ///< number of padded pixels for width and height
[56]	82
	83	Int m_iNumberOfViews; ///< number Views to Encode
	84	Bool m_bUsingDepthMaps;
[210]	85
	86	#if FLEX_CODING_ORDER_M23723
	87	Char* m_pchMVCJointCodingOrder; ///< texture-depth coding order
	88	Bool m_b3DVFlexOrder; ///< flexible coding order flag
	89	#endif
	90
[2]	91	// coding structure
[56]	92	Int m_iIntraPeriod; ///< period of I-slice (random access period)
[2]	93	Int m_iDecodingRefreshType; ///< random access type
	94	Int m_iGOPSize; ///< GOP size of hierarchical structure
[56]	95	Int m_extraRPSs[MAX_VIEW_NUM];
	96	GOPEntryMvc m_GOPListsMvc[MAX_VIEW_NUM][MAX_GOP+1];
	97	Int m_numReorderPics[MAX_VIEW_NUM][MAX_TLAYER]; ///< total number of reorder pictures
	98	Int m_maxDecPicBuffering[MAX_VIEW_NUM][MAX_TLAYER]; ///< total number of reference pictures needed for decoding
[2]	99	Bool m_bUseLComb; ///< flag for using combined reference list for uni-prediction in B-slices (JCTVC-D421)
	100	Bool m_bLCMod; ///< flag for specifying whether the combined reference list for uni-prediction in B-slices is uploaded explicitly
[56]	101	Bool m_bDisInter4x4;
	102	Bool m_enableNSQT; ///< flag for enabling NSQT
	103	Bool m_enableAMP;
[2]	104	// coding quality
	105	std::vector<Double> m_adQP; ///< QP value of key-picture (floating point) [0] video, [1] depth
[56]	106	std::vector<Int> m_aiQP; ///< QP value of key-picture (integer) [0] video, [1] depth
[210]	107	#if QC_MVHEVC_B0046
	108	std::vector<Int> m_aiVId; ///< view id
	109	#endif
[2]	110	Int m_aiTLayerQPOffset[MAX_TLAYER]; ///< QP offset corresponding to temporal layer depth
	111	char* m_pchdQPFile; ///< QP offset for each slice (initialized from external file)
	112	Int* m_aidQP; ///< array of slice QP values
[56]	113	Int* m_aidQPdepth; ///< array of depth slice QP values
[2]	114	Int m_iMaxDeltaQP; ///< max. \|delta QP\|
	115	UInt m_uiDeltaQpRD; ///< dQP range for multi-pass slice QP optimization
[56]	116	Int m_iMaxCuDQPDepth; ///< Max. depth for a minimum CuDQPSize (0:default)
[5]	117
[56]	118	Int m_iChromaQpOffset; ///< ChromaQpOffset (0:default)
	119	Int m_iChromaQpOffset2nd; ///< ChromaQpOffset2nd (0:default)
	120
	121	#if ADAPTIVE_QP_SELECTION
	122	Bool m_bUseAdaptQpSelect;
	123	#endif
	124
	125	Bool m_bUseAdaptiveQP; ///< Flag for enabling QP adaptation based on a psycho-visual model
	126	Int m_iQPAdaptationRange; ///< dQP range by QP adaptation
	127
	128	Int m_maxTempLayer[MAX_VIEW_NUM]; ///< Max temporal layer
	129
[2]	130	// coding unit (CU) definition
	131	UInt m_uiMaxCUWidth; ///< max. CU width in pixel
	132	UInt m_uiMaxCUHeight; ///< max. CU height in pixel
	133	UInt m_uiMaxCUDepth; ///< max. CU depth
[56]	134
[2]	135	// transfom unit (TU) definition
	136	UInt m_uiQuadtreeTULog2MaxSize;
	137	UInt m_uiQuadtreeTULog2MinSize;
[56]	138
[2]	139	UInt m_uiQuadtreeTUMaxDepthInter;
	140	UInt m_uiQuadtreeTUMaxDepthIntra;
[56]	141
[2]	142	// coding tools (bit-depth)
	143	UInt m_uiInputBitDepth; ///< bit-depth of input file
	144	UInt m_uiOutputBitDepth; ///< bit-depth of output file
	145	UInt m_uiInternalBitDepth; ///< Internal bit-depth (BitDepth+BitIncrement)
[5]	146
[56]	147	// coding tools (PCM bit-depth)
	148	Bool m_bPCMInputBitDepthFlag; ///< 0: PCM bit-depth is internal bit-depth. 1: PCM bit-depth is input bit-depth.
	149	UInt m_uiPCMBitDepthLuma; ///< PCM bit-depth for luma
	150
	151	// coding tool (lossless)
	152	#if LOSSLESS_CODING
	153	Bool m_useLossless; ///< flag for using lossless coding
	154	#endif
[5]	155	vector<Bool> m_abUseSAO;
[189]	156	#if LGE_ILLUCOMP_B0045
[296]	157	#if LGE_ILLUCOMP_DEPTH_C0046
	158	vector<Bool> m_abUseIC; ///< flag for using illumination compensation for inter-view prediction
	159	#else
[189]	160	Bool m_bUseIC; ///< flag for using illumination compensation for inter-view prediction
	161	#endif
[296]	162	#endif
	163	#if INTER_VIEW_VECTOR_SCALING_C0115
	164	Bool m_bUseIVS; ///< flag for using inter-view vector scaling
	165	#endif
[56]	166	Int m_maxNumOffsetsPerPic; ///< SAO maximun number of offset per picture
[443]	167	#if LGE_SAO_MIGRATION_D0091
	168	Bool m_saoLcuBoundary; ///< SAO parameter estimation using non-deblocked pixels for LCU bottom and right boundary areas
	169	Bool m_saoLcuBasedOptimization; ///< SAO LCU-based optimization
	170	#else
[56]	171	Bool m_saoInterleavingFlag; ///< SAO interleaving flag
[443]	172	#endif
[2]	173	// coding tools (loop filter)
	174	vector<Bool> m_abUseALF; ///< flag for using adaptive loop filter [0] - video, [1] - depth
[56]	175	Int m_iALFEncodePassReduction; //!< ALF encoding pass, 0 = original 16-pass, 1 = 1-pass, 2 = 2-pass
	176
	177	Int m_iALFMaxNumberFilters; ///< ALF Max Number Filters in one picture
	178	Bool m_bALFParamInSlice;
	179	Bool m_bALFPicBasedEncode;
[5]	180
[2]	181	vector<Bool> m_abLoopFilterDisable; ///< flag for using deblocking filter filter [0] - video, [1] - depth
[56]	182	Bool m_loopFilterOffsetInAPS; ///< offset for deblocking filter in 0 = slice header, 1 = APS
	183	Int m_loopFilterBetaOffsetDiv2; ///< beta offset for deblocking filter
	184	Int m_loopFilterTcOffsetDiv2; ///< tc offset for deblocking filter
	185	Bool m_DeblockingFilterControlPresent; ///< deblocking filter control present flag in PPS
	186
[2]	187	Bool m_bUseLMChroma; ///< JL: Chroma intra prediction based on luma signal
	188
[56]	189	// coding tools (PCM)
	190	Bool m_usePCM; ///< flag for using IPCM
	191	UInt m_pcmLog2MaxSize; ///< log2 of maximum PCM block size
	192	UInt m_uiPCMLog2MinSize; ///< log2 of minimum PCM block size
	193	Bool m_bPCMFilterDisableFlag; ///< PCM filter disable flag
[5]	194
[2]	195	// coding tools (encoder-only parameters)
	196	Bool m_bUseSBACRD; ///< flag for using RD optimization based on SBAC
	197	Bool m_bUseASR; ///< flag for using adaptive motion search range
	198	Bool m_bUseHADME; ///< flag for using HAD in sub-pel ME
[56]	199	vector<Bool> m_abUseRDOQ; ///< flag for using RD optimized quantization [0]-video, [1]-depth
[2]	200	Int m_iFastSearch; ///< ME mode, 0 = full, 1 = diamond, 2 = PMVFAST
	201	Int m_iSearchRange; ///< ME search range
[210]	202	#if DV_V_RESTRICTION_B0037
	203	Bool m_bUseDisparitySearchRangeRestriction; ///< restrict vertical search range for inter-view prediction
	204	Int m_iVerticalDisparitySearchRange; ///< ME vertical search range for inter-view prediction
	205	#endif
[2]	206	Int m_bipredSearchRange; ///< ME search range for bipred refinement
	207	Bool m_bUseFastEnc; ///< flag for using fast encoder setting
[56]	208	#if HHI_INTERVIEW_SKIP
	209	Bool m_bInterViewSkip; ///< usage of interview skip mode ( do not transmit residual)
	210	#if HHI_INTERVIEW_SKIP_LAMBDA_SCALE
	211	Double m_dInterViewSkipLambdaScale; ///< lambda scale for interview skip
	212	#endif
	213	#endif
	214	Bool m_bUseEarlyCU; ///< flag for using Early CU setting
[2]	215
[5]	216	#if DEPTH_MAP_GENERATION
[2]	217	UInt m_uiPredDepthMapGeneration; ///< using of (virtual) depth maps for texture coding
[5]	218	#endif
[296]	219	#if H3D_IVMP
[2]	220	UInt m_uiMultiviewMvPredMode; ///< usage of predictors for multi-view mv prediction
	221	UInt m_uiMultiviewMvRegMode; ///< regularization for multiview motion vectors
	222	Double m_dMultiviewMvRegLambdaScale; ///< lambda scale for multiview motion vectors regularization
[5]	223	#endif
[443]	224	#if H3D_IVRP
	225	#if QC_ARP_D0177
	226	UInt m_nUseAdvResPred;
	227	#else
[100]	228	UInt m_uiMultiviewResPredMode; ///< using multiview residual prediction
[5]	229	#endif
[443]	230	#endif
[2]	231
[100]	232	Bool m_useFastDecisionForMerge; ///< flag for using Fast Decision Merge RD-Cost
	233	Bool m_bUseCbfFastMode; ///< flag for using Cbf Fast PU Mode Decision
	234	Int m_iSliceMode; ///< 0: Disable all Recon slice limits, 1 : Maximum number of largest coding units per slice, 2: Maximum number of bytes in a slice
	235	Int m_iSliceArgument; ///< If m_iSliceMode==1, m_iSliceArgument=max. # of largest coding units. If m_iSliceMode==2, m_iSliceArgument=max. # of bytes.
	236	Int m_iEntropySliceMode; ///< 0: Disable all entropy slice limits, 1 : Maximum number of largest coding units per slice, 2: Constraint based entropy slice
	237	Int m_iEntropySliceArgument; ///< If m_iEntropySliceMode==1, m_iEntropySliceArgument=max. # of largest coding units. If m_iEntropySliceMode==2, m_iEntropySliceArgument=max. # of bins.
[56]	238
[100]	239	Int m_iSliceGranularity; ///< 0: Slices always end at LCU borders. 1-3: slices may end at a depth of 1-3 below LCU level.
	240	Bool m_bLFCrossSliceBoundaryFlag; ///< 0: Cross-slice-boundary in-loop filtering 1: non-cross-slice-boundary in-loop filtering
	241	Int m_iTileBehaviorControlPresentFlag; //!< 1: tile behavior control parameters are in PPS 0: tile behavior control parameters are not in PPS
	242	Bool m_bLFCrossTileBoundaryFlag; //!< 1: Cross-tile-boundary in-loop filtering 0: non-cross-tile-boundary in-loop filtering
[56]	243	Int m_iColumnRowInfoPresent;
	244	Int m_iUniformSpacingIdr;
	245	Int m_iNumColumnsMinus1;
	246	char* m_pchColumnWidth;
	247	Int m_iNumRowsMinus1;
	248	char* m_pchRowHeight;
	249	Int m_iTileLocationInSliceHeaderFlag; //< enable(1)/disable(0) transmitssion of tile location in slice header
	250	Int m_iTileMarkerFlag; //< enable(1)/disable(0) transmitssion of light weight tile marker
	251	Int m_iMaxTileMarkerEntryPoints; //< maximum number of tile markers allowed in a slice (controls degree of parallelism)
	252	Double m_dMaxTileMarkerOffset; //< Calculated offset. Light weight tile markers will be transmitted for TileIdx= Offset, 2Offset, 3Offset ...
[5]	253
[56]	254	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.
	255	Int m_iWaveFrontFlush; //< enable(1)/disable(0) the CABAC flush at the end of each line of LCUs.
	256	Int m_iWaveFrontSubstreams; //< If iWaveFrontSynchro, this is the number of substreams per frame (dependent tiles) or per tile (independent tiles).
	257
	258	Bool m_bUseConstrainedIntraPred; ///< flag for using constrained intra prediction
	259
	260	bool m_pictureDigestEnabled; ///< enable(1)/disable(0) md5 computation and SEI signalling
	261
	262	// weighted prediction
	263	Bool m_bUseWeightPred; ///< Use of explicit Weighting Prediction for P_SLICE
	264	UInt m_uiBiPredIdc; ///< Use of Bi-Directional Weighting Prediction (B_SLICE): explicit(1) or implicit(2)
	265
[189]	266	#if TMVP_DEPTH_SWITCH
	267	vector<Bool> m_enableTMVP; ///< Enable TMVP [0] video, [1] depth
	268	#else
[56]	269	Bool m_enableTMVP;
[189]	270	#endif
	271
[56]	272	Int m_signHideFlag;
	273	Int m_signHidingThreshold;
	274	#if HHI_MPI
	275	Bool m_bUseMVI; ///< flag for using Motion Vector Inheritance for depth map coding
	276	#endif
[189]	277	#if RWTH_SDC_DLT_B0036
	278	Bool m_bUseDLT;
	279	Bool m_bUseSDC;
	280	#endif
[56]	281
	282	Int m_useScalingListId; ///< using quantization matrix
	283	char* m_scalingListFile; ///< quantization matrix file name
	284
[2]	285	// camera parameter
	286	Char* m_pchCameraParameterFile; ///< camera parameter file
	287	Char* m_pchBaseViewCameraNumbers;
[210]	288	#if !QC_MVHEVC_B0046
[5]	289	TAppComCamPara m_cCameraData;
[210]	290	#endif
[2]	291	Int m_iCodedCamParPrecision; ///< precision for coding of camera parameters
	292
[5]	293	#if HHI_VSO
	294	Char* m_pchVSOConfig;
	295	Bool m_bUseVSO; ///< flag for using View Synthesis Optimization
[189]	296	#if HHI_VSO_LS_TABLE_M23714
[100]	297	Bool m_bVSOLSTable; ///< Depth QP dependent Lagrange parameter optimization (m23714)
	298	#endif
	299	#if LGE_VSO_EARLY_SKIP_A0093
	300	Bool m_bVSOEarlySkip; ///< Early skip of VSO computation (JCT3V-A0093 modification 4)
	301	#endif
[5]	302	//// Used for development by GT, might be removed later
[2]	303	Double m_dLambdaScaleVSO; ///< Scaling factor for Lambda in VSO mode
	304	Bool m_bForceLambdaScaleVSO; ///< Use Lambda Scale for depth even if VSO is turned off
[5]	305	#if HHI_VSO_DIST_INT
	306	Bool m_bAllowNegDist; ///< Allow negative distortion in VSO
	307	#endif
[56]	308	UInt m_uiVSOMode; ///< Number of VSO Mode, 1 = , 2 = simple, org vs. ren, 3 = simple, ren vs. ren, 4 = full
[5]	309	#endif
[100]	310	#if SAIT_VSO_EST_A0033
[102]	311	Bool m_bUseEstimatedVSD; ///< Flag for using model based VSD estimation instead of VSO for some encoder decisions (JCT3V-A0033 modification 3)
[100]	312	#endif
[115]	313	#if LGE_WVSO_A0119
[120]	314	Bool m_bUseWVSO; ///< flag for using View Synthesis Optimization
[116]	315	Int m_iVSOWeight;
[115]	316	Int m_iVSDWeight;
[116]	317	Int m_iDWeight;
[115]	318	#endif
[56]	319	// coding tools (depth intra modes)
[5]	320	#if HHI_DMM_WEDGE_INTRA \|\| HHI_DMM_PRED_TEX
[56]	321	Bool m_bUseDMM; ///< flag for using DMM
[2]	322	#endif
	323
[332]	324	#if H3D_QTL
[189]	325	Bool m_bUseQTLPC; ///< flag for using depth QuadTree Limitation + Predictive Coding
[115]	326	#endif
	327
[443]	328	#if MTK_D0156
	329
	330	#if MERL_VSP_COMPENSATION_C0152
	331	Bool m_bUseVSPCompensation;
	332	#endif
	333
	334	Bool m_bUseDVPRefine;
	335	#endif
	336
[2]	337	// internal member functions
	338	Void xSetGlobal (); ///< set global variables
	339	Void xCheckParameter (); ///< check validity of configuration values
	340	Void xPrintParameter (); ///< print configuration values
	341	Void xPrintUsage (); ///< print usage
[56]	342
[2]	343	Void xCleanUpVectors (); ///< clean up vector sizes
	344	Void xInitCameraPars (); ///< init camera parameters
	345
	346
	347	// set MVD Parameters and LUTs
	348	Void xSetShiftParameters();
	349	Void xGetShiftParameter( UInt uiSourceView, UInt uiTargetView, bool bExternal, double& rdScale, double& rdOffset ); ///< Get one Shift Parameters
	350
[5]	351	Void xAppendToFileNameEnd( Char* pchInputFileName, const Char* pchStringToAppend, Char* & rpchOutputFileName);
[2]	352
[56]	353	Void xCheckCodingStructureMvc(); ///< validate and configure inter-view coding structure
[2]	354
	355	template <class T> Void xCleanUpVector( std::vector<T>& rcVec, const T& rcInvalid );
[5]	356	#if HHI_VSO
[2]	357	// Ren Model String
[5]	358	TRenModSetupStrParser m_cRenModStrParser;
	359	#endif
[2]	360	public:
	361	TAppEncCfg();
	362	virtual ~TAppEncCfg();
[56]	363
[2]	364	public:
	365	Void create (); ///< create option handling class
	366	Void destroy (); ///< destroy option handling class
	367	Bool parseCfg ( Int argc, Char* argv[] ); ///< parse configuration file to fill member variables
[56]	368
[2]	369	};// END CLASS DEFINITION TAppEncCfg
	370
[56]	371	//! \}
	372
[2]	373	#endif // __TAPPENCCFG__
	374

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

Download in other formats: