source: 3DVCSoftware/trunk/source/Lib/TLibCommon/TypeDef.h @ 1413

Last change on this file since 1413 was 1413, checked in by tech, 6 years ago

Merged HTM-16.2-dev@1412

  • Property svn:eol-style set to native
File size: 58.7 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-2017, 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/** \file     TypeDef.h
34    \brief    Define macros, basic types, new types and enumerations
35*/
36#ifndef __TYPEDEF__
37#define __TYPEDEF__
38#ifndef __COMMONDEF__
39#error Include CommonDef.h not TypeDef.h
40#endif
41#include <vector>
42#include <utility>
43
44//! \ingroup TLibCommon
45//! \{
46/////////////////////////////////////////////////////////////////////////////////////////
47///////////////////////////////// EXTENSION SELECTION ///////////////////////////////////
48/////////////////////////////////////////////////////////////////////////////////////////
49/* HEVC_EXT might be defined by compiler/makefile options.
50   Linux makefiles support the following settings:
51   make             -> HEVC_EXT not defined
52   make HEVC_EXT=0  -> NH_MV=0 H_3D=0   --> plain HM
53   make HEVC_EXT=1  -> NH_MV=1 H_3D=0   --> MV only
54   make HEVC_EXT=2  -> NH_MV=1 H_3D=1   --> full 3D
55*/
56#ifndef HEVC_EXT
57#define HEVC_EXT                    2
58#endif
59#if ( HEVC_EXT < 0 )||( HEVC_EXT > 2 )
60#error HEVC_EXT must be in the range of 0 to 2, inclusive.
61#endif
62#define NH_MV          ( HEVC_EXT != 0)
63#define NH_3D          ( HEVC_EXT == 2)
64
65#define NH_MV_ALLOW_NON_CONFORMING                0   // Allow non-conforming representations formats
66/////////////////////////////////////////////////////////////////////////////////////////
67///////////////////////////////////   FIXES AND INTEGRATIONS     ////////////////////////
68/////////////////////////////////////////////////////////////////////////////////////////
69#if NH_MV
70// Things that needs to be fixed also in the Specification ... CHECK if this has been done
71#define NH_MV_FIX_NO_REF_PICS_CHECK               1 // !!SPEC!!
72#define NH_MV_FIX_INIT_NUM_ACTIVE_REF_LAYER_PICS  1 // Derivation of NumActiveRefLayerPIcs. !!SPEC!!
73#define NH_MV_FIX_NUM_POC_TOTAL_CUR               1 // Derivation of NumPocTotalCur for IDR pictures. !!SPEC!!
74// To be done
75#define NH_MV_HLS_PTL_LIMITS                      0
76#define NH_MV_SEI_TBD                             0
77#endif
78/////////////////////////////////////////////////////////////////////////////////////////
79///////////////////////////////////   MAJOR DEFINES   ///////////////////////////////////
80/////////////////////////////////////////////////////////////////////////////////////////
81
82
83#if NH_MV
84#define NH_MV_ENC_DEC_TRAC                 1  //< CU/PU level tracking
85#if NH_3D
86#define NH_3D_VSO                          1  // VSO, View synthesis optimization, includes:
87// HHI_VSO
88// HHI_VSO_LS_TABLE_M23714 enable table base Lagrange multiplier optimization
89// SAIT_VSO_EST_A0033, JCT3V-A0033 modification 3
90// LGE_WVSO_A0119
91// SCU_HS_VSD_BUGFIX_IMPROV_G0163
92
93#define NH_3D_FAST_TEXTURE_ENCODING        1   // Fast merge mode decision and early CU determination for texture component of dependent view, JCT3V-E0173
94
95/////////////////////////////////////////////////////////////////////////////////////////
96///////////////////////////////////   REMOVED DEFINES   /////////////////////////////////
97/////////////////////////////////////////////////////////////////////////////////////////
98
99//#define NH_3D_INTEGER_MV_DEPTH            1
100
101//#define NH_3D_ENC_DEPTH                   1   // Encoder optimizations for depth, incl.
102                                              // HHI_DEPTH_INTRA_SEARCH_RAU_C0160
103                                              // LG_ZEROINTRADEPTHRESI_A0087
104                                              // HHI_DMM4_ENC_I0066
105                                              // H_3D_FAST_DEPTH_INTRA
106
107//#define NH_3D_ARP                         1  // Advanced residual prediction (ARP), JCT3V-D0177
108                                             // QC_MTK_INTERVIEW_ARP_F0123_F0108 JCT3V-F0123; JCT3V-F0108
109                                             // SHARP_ARP_REF_CHECK_F0105        ARP reference picture selection and DPB check
110                                             // LGE_ARP_CTX_F0161                JCT3V-F0161
111                                             // MTK_ARP_FLAG_CABAC_SIMP_G0061 Use 2 context for ARP flag referring to only left neighbor block in JCT3V-G0061
112                                             // MTK_ARP_REF_SELECTION_G0053 ARP Reference picture selection in JCT3V-G0053
113                                             // MTK_ALIGN_SW_WD_BI_PRED_ARP_H0085  Align the SW and WD for the bi-prediction ARP PUs by disallowing non-normative fast bi-prediction for ARP PUs, JCT3V-H0085
114                                             // QC_I0051_ARP_SIMP
115                                             // SHARP_ARP_CHROMA_I0104
116                                             // MTK_I0072_IVARP_SCALING_FIX
117                                             // SEC_ARP_VIEW_REF_CHECK_J0037    Signaling iv_res_pred_weight_idx when the current slice has both view and temporal reference picture(s), JCT3V-J0037 item1
118                                             // SEC_ARP_REM_ENC_RESTRICT_K0035    Removal of encoder restriction of ARP, JCT3V-K0035
119//#define NH_3D_QTL                          1
120//#define NH_3D_QTLPC                        1   // OL_QTLIMIT_PREDCODING_B0068 //JCT3V-B0068
121                                              // HHI_QTLPC_RAU_OFF_C0160 JCT3V-C0160 change 2: quadtree limitation and predictive coding switched off in random access units
122                                              // MTK_TEX_DEP_PAR_G0055 Texture-partition-dependent depth partition. JCT3V-G0055
123//#define NH_3D_NBDV                         1   // Neighboring block disparity derivation
124                                              // QC_JCT3V-A0097
125                                              // LGE_DVMCP_A0126
126                                              // LGE_DVMCP_MEM_REDUCTION_B0135
127                                              // QC_SIMPLE_NBDV_B0047
128                                              // FIX_LGE_DVMCP_B0133
129                                              // QC_NBDV_LDB_FIX_C0055
130                                              // MTK_SAIT_TEMPORAL_FIRST_ORDER_C0141_C0097
131                                              // MTK_SIMPLIFY_DVTC_C0135
132                                              // QC_CU_NBDV_D0181
133                                              // SEC_DEFAULT_DV_D0112
134                                              // MTK_DVMCP_FIX_E0172       fix the mismatch between software and WD for DV derivation from DVMCP blocks, issue 2 in JCT3V-E0172
135                                              // SEC_SIMPLIFIED_NBDV_E0142 Simplified NBDV, JCT3V-E0142 and JCT3V-E0190
136                                              // MTK_NBDV_TN_FIX_E0172     fix the issue of DV derivation from the temporal neighboring blocks, issue 7 in JCT3V-E0172
137                                              // MTK_TEXTURE_MRGCAND_BUGFIX_E0182  Bug fix for TEXTURE MERGING CANDIDATE     , JCT3V-E0182
138                                              // LGE_SIMP_DISP_AVAIL_J0041    // Use 2 status for disparity availability - DISP_AVAILABLE and DISP_NONE
139//#define NH_3D_IC                          1   // Illumination Compensation, JCT3V-B0045, JCT3V-C0046, JCT3V-D0060
140                                              // Unifying rounding offset, for IC part, JCT3V-D0135
141                                              // Full Pel Interpolation for Depth, HHI_FULL_PEL_DEPTH_MAP_MV_ACC
142                                              // SHARP_ILLUCOMP_REFINE_E0046
143                                              // MTK_CLIPPING_ALIGN_IC_E0168       // To support simplify bi-prediction PU with identical motion checking, JCT3V-E0168
144                                              // LGE_IC_CTX_F0160 //JCT3V-F0160
145                                              // SEC_ONLY_TEXTURE_IC_F0151
146                                              // MTK_IC_FLAG_CABAC_SIMP_G0061
147                                              // SEC_IC_ARP_SIG_G0072, Disabling IC when ARP is enabled, option 1 in JCT3V-G0072, part 2 in JCT3V-G0121
148                                              // MTK_LOW_LATENCY_IC_ENCODING_H0086  Low-latency IC encoding in JCT3V-H0086
149                                              // MTK_LOW_LATENCY_IC_ENCODING_H0086_FIX  1  // Remove the global variables used in JCT3V-H0086
150                                              // SEC_IC_NEIGHBOR_CLIP_I0080    // Clipping of neighboring sample position, JCT3V-I0080
151                                              // LGE_CHROMA_IC_J0050_J0034
152//#if NH_3D_NBDV
153//#define NH_3D_NBDV_REF                     1   // Depth oriented neighboring block disparity derivation
154                                              // MTK_D0156
155                                              // MERL_D0166: Reference view selection in NBDV & Bi-VSP
156                                              // MERL_C0152: Basic VSP
157                                              // NBDV_DEFAULT_VIEWIDX_BUGFIX Bug fix for invalid default view index for NBDV
158                                              // NTT_DoNBDV_VECTOR_CLIP_E0141 disparity vector clipping in DoNBDV, JCT3V-E0141 and JCT3V-E0209
159                                              // SEC_VER_DONBDV_H0103          Vertical DV Restriction for DoNBDV
160//#endif
161//#define NH_3D_VSP                          1   // View synthesis prediction
162                                              // MERL_C0152: Basic VSP
163                                              // MERL_D0166: Reference view selection in NBDV & Bi-VSP
164                                              // MTK_D0105, LG_D0139: No VSP for depth
165                                              // QC_D0191: Clean up
166                                              // LG_D0092: Multiple VSP candidate allowed
167                                              // MTK_VSP_FIX_ALIGN_WD_E0172
168                                              // NTT_VSP_ADAPTIVE_SPLIT_E0207 adaptive sub-PU partitioning in VSP, JCT3V-E0207
169                                              // NTT_VSP_DC_BUGFIX_E0208 bugfix for sub-PU based DC in VSP, JCT3V-E0208
170                                              // NTT_VSP_COMMON_E0207_E0208 common part of JCT3V-E0207 and JCT3V-E0208
171                                              // MTK_F0109_LG_F0120_VSP_BLOCK MTK_LG_SIMPLIFY_VSP_BLOCK_PARTITION_F0109_F0120
172                                              // SHARP_VSP_BLOCK_IN_AMP_F0102 VSP partitioning for AMP
173                                              // MTK_VSP_SIMPLIFICATION_F0111 1. Inherited VSP also use NBDV of current CU, 2. VSP cannot be inherited from above LCU rowss
174                                              // LGE_SHARP_VSP_INHERIT_F0104
175                                              // NTT_STORE_SPDV_VSP_G0148 Storing Sub-PU based DV for VSP
176                                              // Restricted bi-prediction for VSP
177                                              // MTK_MRG_LIST_SIZE_CLEANUP_J0059   1   // Include VSP for deriving merge candidate list size, JCT3V-J0059
178                                              // SEC_A1_BASED_VSP_J0039            1   // Removal of redundant VSP in Merge list
179//#define NH_3D_MLC                          1
180//#define NH_3D_IV_MERGE                     1  // Inter-view motion merge candidate
181                                              // HHI_INTER_VIEW_MOTION_PRED
182                                              // SAIT_IMPROV_MOTION_PRED_M24829, improved inter-view motion vector prediction
183                                              // QC_MRG_CANS_B0048             , JCT3V-B0048, B0086, B0069
184                                              // OL_DISMV_POS_B0069            , different pos for disparity MV candidate, B0069
185                                              // MTK_INTERVIEW_MERGE_A0049     , second part
186                                              // QC_AMVP_MRG_UNIFY_IVCAN_C0051
187                                              // QC_INRIA_MTK_MRG_E0126
188                                              // ETRIKHU_MERGE_REUSE_F0093 QC_DEPTH_IV_MRG_F0125, JCT3V-F0125: Depth oriented Inter-view MV candidate
189                                              // MTK_NBDV_IVREF_FIX_G0067      , Disable IvMC, VSP when IVREF is not available, JCT3V-G0067
190                                              // SEC_DEPTH_DV_DERIVAITON_G0074, Simplification of DV derivation for depth, JCT3V-G0074
191                                              // QC_DEPTH_MERGE_SIMP_G0127 Remove DV candidate and shifting candidate for depth coding
192                                              // QC_IV_PRED_CONSTRAINT_H0137   Constraint on inter-view (motion) prediction tools
193                                              // ETRIKHU_BUGFIX_H0083          bug-fix for DV candidate pruning
194                                              // ETRIKHU_CLEANUP_H0083         cleaned-up source code for constructing merging candidate list
195                                              // ETRIKHU_CLEANUP_H0083_MISSING missing guard macros added by GT
196                                              // SHARP_SIMPLE_MERGE_H0062      Restrict 3D-HEVC merge cand in small PUs
197                                              // MTK_DIS_SPBIP8X4_H0205        Disable bi-prediction for 8x4 and 4x8 sub PU and remove the SPIVMP 2Nx2N restriction
198                                              // SEC_ADAPT_DISABLE_IVMP        Disabling IVMP merge candidates when IC is enabled, JCT3V-H0070
199                                              // SEC_SIMP_SHIFTED_DV_I0086     Simplification of Shifted DV candidate, JCT3V-I0086
200                                              // SEC_SHIFTED_IVMC_POS_K0036    Position Derivation for Shifted-IVMC, JCT3V-K0036
201//#define NH_3D_TEXT_MERGE                  1
202                                              // TEXTURE MERGING CANDIDATE     , JCT3V-C0137
203                                              // EC_MPI_ENABLING_MERGE_F0150, MPI flag in VPS and enabling in Merge mode
204//#define NH_3D_TMVP                        1   // QC_TMVP_C0047
205                                              // Sony_M23639
206                                              // H_3D_TMVP_SCALING_FIX_K0053       1   // QC/CY for K0053
207//#define NH_3D_DMM                         1   // Depth modeling modes
208                                              // HHI_DMM_PRED_TEX
209                                              // HHI_DMM_WEDGE_INTRA
210                                              // FIX_WEDGE_NOFLOAT_D0036
211                                              // LGE_EDGE_INTRA_A0070
212                                              // LGE_DMM3_SIMP_C0044
213                                              // QC_DC_PREDICTOR_D0183
214                                              // LGE_CONCATENATE_D0141
215                                              // PKU_QC_DEPTH_INTRA_UNI_D0195
216                                              // SEC_DMM2_E0146_HHIFIX Removal of DMM2 from DMMs
217                                              // ZJU_DEPTH_INTRA_MODE_E0204 Simplified Binarization for depth_intra_mode
218                                              // SCU_HS_DMM4_REMOVE_DIV_E0242 DMM4 Division Removal
219                                              // LGE_PKU_DMM3_OVERLAP_E0159_HHIFIX 1   Removal of overlap between DMM3 and DMM1
220                                              // SEC_DMM3_RBC_F0147 Removal of DMM3 and RBC from DMMs
221                                              // HHI_DIM_PREDSAMP_FIX_F0171
222                                              // QC_DIM_DELTADC_UNIFY_F0132 Unify delta DC coding in depth intra modes
223                                              // LGE_SIMP_DIM_NOT_PRESENT_FLAG_CODING_H0119_H0135  Use only one context for CABAC of dim_not_present_flag
224                                              // QC_SIMP_DELTADC_CODING_H0131   Simplify detaDC entropy coding
225                                              // MTK_DMM_SIMP_CODE_H0092        Remove CABAC context for DMM1 mode coding
226                                              // MTK_DELTA_DC_FLAG_ONE_CONTEXT_H0084_H0100_H0113 Use only one context for CABAC of delta_dc_flag as in JCTVC-H0084, JCTVC-H0100 and JCTVC-H0113
227                                              // HS_DMM_SIGNALLING_I0120
228                                              // SHARP_DMM1_I0110 LUT size reduction for DMM1 proposed in JCT3V-I0110
229                                              // MTK_DMM_SIM_J0035
230                                              // SHARP_DMM_CLEAN_K0042             1   // Generate DMM pattern with rotation
231//#define NH_3D_DLT                         1   // Depth Lookup Table
232                                              // HHI_DELTADC_DLT_D0035
233                                              // LGE_PRED_RES_CODING_DLT_DOMAIN_F0159 JCT3V-F0159
234                                              // SEC_NO_RESI_DLT_H0105
235                                              // MTK_DLT_CODING_FIX_H0091
236                                              // H_3D_DELTA_DLT
237                                              // RWTH_DLT_CLIP_I0057
238                                              // SHARP_DLT_SIMP_J0029 DLT(DepthValue2Idx[]) table derivation cleanup
239//#define NH_3D_SDC_INTRA                   1   // Segment-wise DC Coding method for INTRA
240//#define NH_3D_SDC_INTER                   1   // Segment-wise DC Coding method for INTER
241                                              // RWTH_SDC_DLT_B0036
242                                              // INTEL_SDC64_D0193
243                                              // RWTH_SDC_CTX_SIMPL_D0032
244                                              // FIX_SDC_ENC_RD_WVSO_D0163
245                                              // MTK_SAMPLE_BASED_SDC_D0110
246                                              // KWU_SDC_SIMPLE_DC_E0117 Simplified DC calculation for SDC
247                                              // LGE_SDC_REMOVE_DC_E0158 Removal of DC mode from SDC
248                                              // Unify intra SDC and inter SDC
249                                              // QC_GENERIC_SDC_G0122 Generalize SDC to all depth intra modes
250                                              // SCU_HS_DEPTH_DC_PRED_G0143
251                                              // HS_TSINGHUA_SDC_SPLIT_G0111
252                                              // QC_PKU_SDC_SPLIT_G0123 Intra SDC Split
253                                              // HS_DMM_SDC_PREDICTOR_UNIFY_H0108  Unification of DMM and SDC predictor derivation
254                                              // MTK_SDC_FLAG_FIX_H0095                          Remove conditional check of PCM flag based on SDC flag, JCTVC-H0095
255                                              // FAST_SDC_OFFSET_DECISION_I0084
256                                              // SEPARATE_FLAG_I0085
257                                              // MTK_J0033
258                                              // LGE_INTER_SDC_E0156 Enable inter SDC for depth coding
259                                              // SEC_INTER_SDC_G0101 Improved inter SDC with multiple DC candidates
260//#define NH_3D_SPIVMP                       1   // H_3D_SPIVMP JCT3V-F0110: Sub-PU level inter-view motion prediction
261                                              // SEC_SPIVMP_MCP_SIZE_G0077, Apply SPIVMP only to 2Nx2N partition, JCT3V-G0077
262                                              // QC_SPIVMP_MPI_G0119 Sub-PU level MPI merge candidate
263                                              // Simplification on Sub-PU level temporal interview motion prediction
264                                              // MPI_SUBPU_DEFAULT_MV_H0077_H0099_H0111_H0133
265//#define NH_3D_DBBP                         1   // DBBP: Depth-based Block Partitioning and Merging
266                                              // MTK_DBBP_AMP_REM_H0072
267                                              // RWTH_DBBP_NO_SPU_H0057
268                                              // SEC_DBBP_FILTERING_H0104
269                                              // MTK_DBBP_SIGNALING_H0094
270                                              // H_3D_FIX_DBBP_IVMP Fix . Enable IVMP is always disabled, when DBBP is enabled. The original intention is to disable Sub-PU IVMP when DBBP is enabled, not to disable IVMP itself.
271                                              // SEC_DBBP_EXPLICIT_SIG_I0077 Remove the partition derivation and signal dbbp_flag only when the partition mode is 2NxN/Nx2N, JCT3V-I0077
272                                              // Disallow DBBP in 8x8 CU, JCT3V-I0078
273                                              // SHARP_DBBP_SIMPLE_FLTER_I0109 Simple condition and one dimensional filter for DBBP
274                                              // SEC_DBBP_DMM4_THRESHOLD_I0076 Simplification of threshold derivation for DBBP and DMM4, JCT3V-I0076
275                                              // SEC_DBBP_VIEW_REF_CHECK_J0037 Signaling dbbp_flag when the current slice has view reference picture(s), JCT3V-J0037 item4
276                                              // RWTH_DBBP_NO_SATD_K0028
277                                              // HS_DBBP_CLEAN_K0048
278//#define NH_3D_DIS                         1   // Depth intra skip
279                                              // SEC_DEPTH_INTRA_SKIP_MODE_K0033  Depth intra skip mode
280// OTHERS
281                                              // MTK_SONY_PROGRESSIVE_MV_COMPRESSION_E0170 // Progressive MV Compression, JCT3V-E0170
282                                              // MTK_FAST_TEXTURE_ENCODING_E0173
283//HLS
284                                              // HHI_DEPENDENCY_SIGNALLING_I1_J0107
285                                              // HHI_TOOL_PARAMETERS_I2_J0107
286                                              // HHI_VPS_3D_EXTENSION_I3_J0107
287                                              // HHI_INTER_COMP_PRED_K0052
288                                              // HHI_RES_PRED_K0052
289                                              // HHI_CAM_PARA_K0052
290                                              // H_3D_DIRECT_DEP_TYPE
291#endif // NH_3D
292#if NH_MV
293////////////////////////
294/// Consider Removal
295////////////////////////
296// Rate Control
297#define KWU_FIX_URQ                       0
298#define KWU_RC_VIEWRC_E0227               0  ///< JCT3V-E0227, view-wise target bitrate allocation
299#define KWU_RC_MADPRED_E0227              0  ///< JCT3V-E0227, inter-view MAD prediction
300#define NH_MV_HLS_PTL_LIMITS               0
301#if NH_3D
302// Unclear Fix
303#define H_3D_PPS_FIX_DEPTH                     0
304#endif
305#endif
306/////////////////////////////////////////////////////////////////////////////////////////
307///////////////////////////////////   DERIVED DEFINES ///////////////////////////////////
308/////////////////////////////////////////////////////////////////////////////////////////
309#if NH_3D
310#define NH_3D_OUTPUT_ACTIVE_TOOLS               0
311#define NH_3D_REN_MAX_DEV_OUT                   0
312#endif
313///// ***** VIEW SYNTHESIS OPTIMIZAION *********
314#if NH_3D_VSO
315#define H_3D_VSO_DIST_INT                 1   // Allow negative synthesized view distortion change
316#define H_3D_VSO_COLOR_PLANES             1   // Compute VSO distortion on color planes
317#define H_3D_VSO_EARLY_SKIP               1   // LGE_VSO_EARLY_SKIP_A0093, A0093 modification 4
318#define H_3D_VSO_RM_ASSERTIONS            0   // Output VSO assertions
319#define H_3D_VSO_SYNTH_DIST_OUT           0   // Output of synthesized view distortion instead of depth distortion in encoder output
320#endif
321////   ****** NEIGHBOURING BLOCK-BASED DISPARITY VECTOR  *********
322#if NH_3D
323#define DVFROM_LEFT                       0
324#define DVFROM_ABOVE                      1
325#define IDV_CANDS                         2
326
327/////////////////////////////////////////////////////////////////////////////////////
328/// GT: Move values which are not flags to CommonDef.h and convert to static int !!
329///////////////////////////////////////////////////////////////////////////////////
330///// ***** ILLUMATION COMPENSATION *********
331
332#define IC_REG_COST_SHIFT                 7
333#define IC_CONST_SHIFT                    5
334#define IC_SHIFT_DIFF                     12
335#define IC_LOW_LATENCY_ENCODING_THRESHOLD 0.1 // Threshold for low-latency IC encoding in JCT3V-H0086
336
337///// ***** DEPTH BASED BLOCK PARTITIONING *********
338
339#define DBBP_INVALID_SHORT                (-4)
340#endif
341/////////////////////////////////////////////////////////////////////////////////////////
342///////////////////////////////////   HM RELATED DEFINES ////////////////////////////////
343/////////////////////////////////////////////////////////////////////////////////////////
344#endif
345// ====================================================================================================================
346// Debugging
347// ====================================================================================================================
348#define DEBUG_STRING                                      0 ///< When enabled, prints out final decision debug info at encoder and decoder
349#define DEBUG_ENCODER_SEARCH_BINS                         0 ///< When enabled, prints out each bin as it is coded during encoder search
350#define DEBUG_CABAC_BINS                                  0 ///< When enabled, prints out each bin as it is coded during final encode and decode
351#define DEBUG_INTRA_SEARCH_COSTS                          0 ///< When enabled, prints out the cost for each mode during encoder search
352#define DEBUG_TRANSFORM_AND_QUANTISE                      0 ///< When enabled, prints out each TU as it passes through the transform-quantise-dequantise-inverseTransform process
353#define ENVIRONMENT_VARIABLE_DEBUG_AND_TEST               0 ///< When enabled, allows control of debug modifications via environment variables
354#define PRINT_MACRO_VALUES                                1 ///< When enabled, the encoder prints out a list of the non-environment-variable controlled macros and their values on startup
355// TODO: rename this macro to DECODER_DEBUG_BIT_STATISTICS (may currently cause merge issues with other branches)
356// This can be enabled by the makefile
357#ifndef RExt__DECODER_DEBUG_BIT_STATISTICS
358#define RExt__DECODER_DEBUG_BIT_STATISTICS                0 ///< 0 (default) = decoder reports as normal, 1 = decoder produces bit usage statistics (will impact decoder run time by up to ~10%)
359#endif
360// This can be enabled by the makefile
361#ifndef ENC_DEC_TRACE
362#define ENC_DEC_TRACE                                     0
363#endif
364
365#define DEC_NUH_TRACE                                     0 ///< When trace enabled, enable tracing of NAL unit headers at the decoder (currently not possible at the encoder)
366
367#define PRINT_RPS_INFO                                    0 ///< Enable/disable the printing of bits used to send the RPS.
368// ====================================================================================================================
369// Tool Switches - transitory (these macros are likely to be removed in future revisions)
370// ====================================================================================================================
371#define DECODER_CHECK_SUBSTREAM_AND_SLICE_TRAILING_BYTES  1 ///< TODO: integrate this macro into a broader conformance checking system.
372#define X0038_LAMBDA_FROM_QP_CAPABILITY                   ( HEVC_EXT == 0 ) ///< This approach derives lambda from QP+QPoffset+QPoffset2. QPoffset2 is derived from QP+QPoffset using a linear model that is clipped between 0 and 3.
373                                                            // To use this capability enable config parameter LambdaFromQpEnable
374                                                            // GT: This is currently disabled for MV-HEVC and 3D-HEVC. Enabling requires modifications of the cfg-files
375#define JCTVC_Y0038_PARAMS                                1
376
377#define JVET_E0059_FLOATING_POINT_QP_FIX                  1 ///< Replace floating point QP with a source-file frame number.
378#define JVET_G0101_QP_SWITCHING                           1 ///< After switching POC, increase base QP instead of frame level QP.
379
380#define JVET_F0064_MSSSIM                                 1 ///< Calculate MS-SSIM scores
381
382#ifndef EXTENSION_360_VIDEO
383#define EXTENSION_360_VIDEO                               0   ///< extension for 360/spherical video coding support; this macro should be controlled by makefile, as it would be used to control whether the library is built and linked
384#endif
385
386#define MCTS_ENC_CHECK                                    1  ///< Temporal MCTS encoder constraint and decoder checks. Also requires SEITMCTSTileConstraint to be enabled to enforce constraint
387// ====================================================================================================================
388// Tool Switches
389// ====================================================================================================================
390
391// Please also refer to "TDecConformance.h" for DECODER_PARTIAL_CONFORMANCE_CHECK
392
393#define REDUCED_ENCODER_MEMORY                            0 ///< When 1, the encoder will allocate TComPic memory when required and release it when no longer required.
394// GT: To be aligned
395
396#define ADAPTIVE_QP_SELECTION                             1 ///< G382: Adaptive reconstruction levels, non-normative part for adaptive QP selection
397#define AMP_ENC_SPEEDUP                                   1 ///< encoder only speed-up by AMP mode skipping
398#if AMP_ENC_SPEEDUP
399#define AMP_MRG                                           1 ///< encoder only force merge for AMP partition (no motion search for AMP)
400#endif
401#define FAST_BIT_EST                                      1   ///< G763: Table-based bit estimation for CABAC
402#define HHI_RQT_INTRA_SPEEDUP                             1           ///< tests one best mode with full rqt
403#define HHI_RQT_INTRA_SPEEDUP_MOD                         0           ///< tests two best modes with full rqt
404#if HHI_RQT_INTRA_SPEEDUP_MOD && !HHI_RQT_INTRA_SPEEDUP
405#error
406#endif
407#define MATRIX_MULT                                       0 ///< Brute force matrix multiplication instead of partial butterfly
408#define O0043_BEST_EFFORT_DECODING                        0 ///< 0 (default) = disable code related to best effort decoding, 1 = enable code relating to best effort decoding [ decode-side only ].
409#define ME_ENABLE_ROUNDING_OF_MVS                         1 ///< 0 (default) = disables rounding of motion vectors when right shifted,  1 = enables rounding
410#define RDOQ_CHROMA_LAMBDA                                1 ///< F386: weighting of chroma for RDOQ
411// This can be enabled by the makefile
412#ifndef RExt__HIGH_BIT_DEPTH_SUPPORT
413#define RExt__HIGH_BIT_DEPTH_SUPPORT                                           0 ///< 0 (default) use data type definitions for 8-10 bit video, 1 = use larger data types to allow for up to 16-bit video (originally developed as part of N0188)
414#endif
415
416#if defined __SSE2__ || defined __AVX2__ || defined __AVX__ || defined _M_AMD64 || defined _M_X64
417#define VECTOR_CODING__INTERPOLATION_FILTER               1 ///< enable vector coding for the interpolation filter. 1 (default if SSE possible) disable SSE vector coding. Should not affect RD costs/decisions. Code back-ported from JEM2.0.
418#define VECTOR_CODING__DISTORTION_CALCULATIONS            1 ///< enable vector coding for distortion calculations   1 (default if SSE possible) disable SSE vector coding. Should not affect RD costs/decisions. Code back-ported from JEM2.0.
419#else
420#define VECTOR_CODING__INTERPOLATION_FILTER               0 ///< enable vector coding for the interpolation filter. 0 (default if SSE not possible) disable SSE vector coding. Should not affect RD costs/decisions. Code back-ported from JEM2.0.
421#define VECTOR_CODING__DISTORTION_CALCULATIONS            0 ///< enable vector coding for distortion calculations   0 (default if SSE not possible) disable SSE vector coding. Should not affect RD costs/decisions. Code back-ported from JEM2.0.
422#endif
423
424// ====================================================================================================================
425// Derived macros
426// ====================================================================================================================
427#if RExt__HIGH_BIT_DEPTH_SUPPORT
428#define FULL_NBIT                                                              1 ///< When enabled, use distortion measure derived from all bits of source data, otherwise discard (bitDepth - 8) least-significant bits of distortion
429#define RExt__HIGH_PRECISION_FORWARD_TRANSFORM                                 1 ///< 0 use original 6-bit transform matrices for both forward and inverse transform, 1 (default) = use original matrices for inverse transform and high precision matrices for forward transform
430#else
431#define FULL_NBIT                                                              0 ///< When enabled, use distortion measure derived from all bits of source data, otherwise discard (bitDepth - 8) least-significant bits of distortion
432#define RExt__HIGH_PRECISION_FORWARD_TRANSFORM                                 0 ///< 0 (default) use original 6-bit transform matrices for both forward and inverse transform, 1 = use original matrices for inverse transform and high precision matrices for forward transform
433#endif
434#if FULL_NBIT
435# define DISTORTION_PRECISION_ADJUSTMENT(x)  0
436#else
437# define DISTORTION_PRECISION_ADJUSTMENT(x) (x)
438#endif
439#if DEBUG_STRING
440  #define DEBUG_STRING_PASS_INTO(name) , name
441  #define DEBUG_STRING_PASS_INTO_OPTIONAL(name, exp) , (exp==0)?0:name
442  #define DEBUG_STRING_FN_DECLARE(name) , std::string &name
443  #define DEBUG_STRING_FN_DECLAREP(name) , std::string *name
444  #define DEBUG_STRING_NEW(name) std::string name;
445  #define DEBUG_STRING_OUTPUT(os, name) os << name;
446  #define DEBUG_STRING_APPEND(str1, str2) str1+=str2;
447  #define DEBUG_STRING_SWAP(str1, str2) str1.swap(str2);
448  #define DEBUG_STRING_CHANNEL_CONDITION(compID) (true)
449  #include <sstream>
450  #include <iomanip>
451#else
452  #define DEBUG_STRING_PASS_INTO(name)
453  #define DEBUG_STRING_PASS_INTO_OPTIONAL(name, exp)
454  #define DEBUG_STRING_FN_DECLARE(name)
455  #define DEBUG_STRING_FN_DECLAREP(name)
456  #define DEBUG_STRING_NEW(name)
457  #define DEBUG_STRING_OUTPUT(os, name)
458  #define DEBUG_STRING_APPEND(str1, str2)
459  #define DEBUG_STRING_SWAP(srt1, str2)
460  #define DEBUG_STRING_CHANNEL_CONDITION(compID)
461#endif
462// ====================================================================================================================
463// Error checks
464// ====================================================================================================================
465#if ((RExt__HIGH_PRECISION_FORWARD_TRANSFORM != 0) && (RExt__HIGH_BIT_DEPTH_SUPPORT == 0))
466#error ERROR: cannot enable RExt__HIGH_PRECISION_FORWARD_TRANSFORM without RExt__HIGH_BIT_DEPTH_SUPPORT
467#endif
468// ====================================================================================================================
469// Basic type redefinition
470// ====================================================================================================================
471typedef       void                Void;
472typedef       bool                Bool;
473typedef       char                TChar; // Used for text/characters
474typedef       signed char         SChar; // Signed 8-bit values
475typedef       unsigned char       UChar; // Unsigned 8-bit values
476typedef       short               Short;
477typedef       unsigned short      UShort;
478typedef       int                 Int;
479typedef       unsigned int        UInt;
480typedef       double              Double;
481typedef       float               Float;
482// ====================================================================================================================
483// 64-bit integer type
484// ====================================================================================================================
485#ifdef _MSC_VER
486typedef       __int64             Int64;
487#if _MSC_VER <= 1200 // MS VC6
488typedef       __int64             UInt64;   // MS VC6 does not support unsigned __int64 to double conversion
489#else
490typedef       unsigned __int64    UInt64;
491#endif
492#else
493typedef       long long           Int64;
494typedef       unsigned long long  UInt64;
495#endif
496// ====================================================================================================================
497// Named numerical types
498// ====================================================================================================================
499#if RExt__HIGH_BIT_DEPTH_SUPPORT
500typedef       Int             Pel;               ///< pixel type
501typedef       Int64           TCoeff;            ///< transform coefficient
502typedef       Int             TMatrixCoeff;      ///< transform matrix coefficient
503typedef       Short           TFilterCoeff;      ///< filter coefficient
504typedef       Int64           Intermediate_Int;  ///< used as intermediate value in calculations
505typedef       UInt64          Intermediate_UInt; ///< used as intermediate value in calculations
506#else
507typedef       Short           Pel;               ///< pixel type
508typedef       Int             TCoeff;            ///< transform coefficient
509typedef       Short           TMatrixCoeff;      ///< transform matrix coefficient
510typedef       Short           TFilterCoeff;      ///< filter coefficient
511typedef       Int             Intermediate_Int;  ///< used as intermediate value in calculations
512typedef       UInt            Intermediate_UInt; ///< used as intermediate value in calculations
513#endif
514#if FULL_NBIT
515typedef       UInt64          Distortion;        ///< distortion measurement
516#else
517typedef       UInt            Distortion;        ///< distortion measurement
518#endif
519#if NH_MV
520typedef std::vector< std::string > StringAry1d;
521typedef std::vector< StringAry1d > StringAry2d;
522typedef std::vector< Int >        IntAry1d;
523typedef std::vector< IntAry1d >   IntAry2d;
524typedef std::vector< IntAry2d >   IntAry3d;
525typedef std::vector< IntAry3d >   IntAry4d;
526typedef std::vector< IntAry4d >   IntAry5d;
527typedef std::vector< Bool >        BoolAry1d;
528typedef std::vector< BoolAry1d >   BoolAry2d;
529typedef std::vector< BoolAry2d >   BoolAry3d;
530typedef std::vector< BoolAry3d >   BoolAry4d;
531typedef std::vector< BoolAry4d >   BoolAry5d;
532#endif
533#if NH_3D_VSO
534// ====================================================================================================================
535// Define Distortion Types
536// ====================================================================================================================
537typedef       Int64           RMDist;     ///< renderer model distortion
538#if H_3D_VSO_DIST_INT
539typedef       Int64            Dist;       ///< RDO distortion
540typedef       Int64            Dist64;
541#define       RDO_DIST_MIN     MIN_INT
542#define       RDO_DIST_MAX     MAX_INT
543#else
544typedef       UInt             Dist;       ///< RDO distortion
545typedef       UInt64           Dist;
546#define       RDO_DIST_MIN     0
547#define       RDO_DIST_MAX     MAX_UINT
548#endif
549#else
550#define       RDO_DIST_MAX     MAX_UINT
551#endif
552// ====================================================================================================================
553// Enumeration
554// ====================================================================================================================
555enum RDPCMMode
556{
557  RDPCM_OFF             = 0,
558  RDPCM_HOR             = 1,
559  RDPCM_VER             = 2,
560  NUMBER_OF_RDPCM_MODES = 3
561};
562enum RDPCMSignallingMode
563{
564  RDPCM_SIGNAL_IMPLICIT            = 0,
565  RDPCM_SIGNAL_EXPLICIT            = 1,
566  NUMBER_OF_RDPCM_SIGNALLING_MODES = 2
567};
568/// supported slice type
569enum SliceType
570{
571  B_SLICE               = 0,
572  P_SLICE               = 1,
573  I_SLICE               = 2,
574  NUMBER_OF_SLICE_TYPES = 3
575};
576/// chroma formats (according to semantics of chroma_format_idc)
577enum ChromaFormat
578{
579  CHROMA_400        = 0,
580  CHROMA_420        = 1,
581  CHROMA_422        = 2,
582  CHROMA_444        = 3,
583  NUM_CHROMA_FORMAT = 4
584};
585enum ChannelType
586{
587  CHANNEL_TYPE_LUMA    = 0,
588  CHANNEL_TYPE_CHROMA  = 1,
589  MAX_NUM_CHANNEL_TYPE = 2
590};
591enum ComponentID
592{
593  COMPONENT_Y       = 0,
594  COMPONENT_Cb      = 1,
595  COMPONENT_Cr      = 2,
596  MAX_NUM_COMPONENT = 3
597};
598enum InputColourSpaceConversion // defined in terms of conversion prior to input of encoder.
599{
600  IPCOLOURSPACE_UNCHANGED               = 0,
601  IPCOLOURSPACE_YCbCrtoYCrCb            = 1, // Mainly used for debug!
602  IPCOLOURSPACE_YCbCrtoYYY              = 2, // Mainly used for debug!
603  IPCOLOURSPACE_RGBtoGBR                = 3,
604  NUMBER_INPUT_COLOUR_SPACE_CONVERSIONS = 4
605};
606enum MATRIX_COEFFICIENTS // Table E.5 (Matrix coefficients)
607{
608  MATRIX_COEFFICIENTS_RGB                           = 0,
609  MATRIX_COEFFICIENTS_BT709                         = 1,
610  MATRIX_COEFFICIENTS_UNSPECIFIED                   = 2,
611  MATRIX_COEFFICIENTS_RESERVED_BY_ITUISOIEC         = 3,
612  MATRIX_COEFFICIENTS_USFCCT47                      = 4,
613  MATRIX_COEFFICIENTS_BT601_625                     = 5,
614  MATRIX_COEFFICIENTS_BT601_525                     = 6,
615  MATRIX_COEFFICIENTS_SMPTE240                      = 7,
616  MATRIX_COEFFICIENTS_YCGCO                         = 8,
617  MATRIX_COEFFICIENTS_BT2020_NON_CONSTANT_LUMINANCE = 9,
618  MATRIX_COEFFICIENTS_BT2020_CONSTANT_LUMINANCE     = 10,
619};
620enum DeblockEdgeDir
621{
622  EDGE_VER     = 0,
623  EDGE_HOR     = 1,
624  NUM_EDGE_DIR = 2
625};
626/// supported partition shape
627enum PartSize
628{
629  SIZE_2Nx2N           = 0,           ///< symmetric motion partition,  2Nx2N
630  SIZE_2NxN            = 1,           ///< symmetric motion partition,  2Nx N
631  SIZE_Nx2N            = 2,           ///< symmetric motion partition,   Nx2N
632  SIZE_NxN             = 3,           ///< symmetric motion partition,   Nx N
633  SIZE_2NxnU           = 4,           ///< asymmetric motion partition, 2Nx( N/2) + 2Nx(3N/2)
634  SIZE_2NxnD           = 5,           ///< asymmetric motion partition, 2Nx(3N/2) + 2Nx( N/2)
635  SIZE_nLx2N           = 6,           ///< asymmetric motion partition, ( N/2)x2N + (3N/2)x2N
636  SIZE_nRx2N           = 7,           ///< asymmetric motion partition, (3N/2)x2N + ( N/2)x2N
637  NUMBER_OF_PART_SIZES = 8
638};
639/// supported prediction type
640enum PredMode
641{
642  MODE_INTER                 = 0,     ///< inter-prediction mode
643  MODE_INTRA                 = 1,     ///< intra-prediction mode
644  NUMBER_OF_PREDICTION_MODES = 2,
645};
646/// reference list index
647enum RefPicList
648{
649  REF_PIC_LIST_0               = 0,   ///< reference list 0
650  REF_PIC_LIST_1               = 1,   ///< reference list 1
651  NUM_REF_PIC_LIST_01          = 2,
652  REF_PIC_LIST_X               = 100  ///< special mark
653};
654/// distortion function index
655enum DFunc
656{
657  DF_DEFAULT         = 0,
658  DF_SSE             = 1,      ///< general size SSE
659  DF_SSE4            = 2,      ///<   4xM SSE
660  DF_SSE8            = 3,      ///<   8xM SSE
661  DF_SSE16           = 4,      ///<  16xM SSE
662  DF_SSE32           = 5,      ///<  32xM SSE
663  DF_SSE64           = 6,      ///<  64xM SSE
664  DF_SSE16N          = 7,      ///< 16NxM SSE
665  DF_SAD             = 8,      ///< general size SAD
666  DF_SAD4            = 9,      ///<   4xM SAD
667  DF_SAD8            = 10,     ///<   8xM SAD
668  DF_SAD16           = 11,     ///<  16xM SAD
669  DF_SAD32           = 12,     ///<  32xM SAD
670  DF_SAD64           = 13,     ///<  64xM SAD
671  DF_SAD16N          = 14,     ///< 16NxM SAD
672  DF_SADS            = 15,     ///< general size SAD with step
673  DF_SADS4           = 16,     ///<   4xM SAD with step
674  DF_SADS8           = 17,     ///<   8xM SAD with step
675  DF_SADS16          = 18,     ///<  16xM SAD with step
676  DF_SADS32          = 19,     ///<  32xM SAD with step
677  DF_SADS64          = 20,     ///<  64xM SAD with step
678  DF_SADS16N         = 21,     ///< 16NxM SAD with step
679  DF_HADS            = 22,     ///< general size Hadamard with step
680  DF_HADS4           = 23,     ///<   4xM HAD with step
681  DF_HADS8           = 24,     ///<   8xM HAD with step
682  DF_HADS16          = 25,     ///<  16xM HAD with step
683  DF_HADS32          = 26,     ///<  32xM HAD with step
684  DF_HADS64          = 27,     ///<  64xM HAD with step
685  DF_HADS16N         = 28,     ///< 16NxM HAD with step
686#if NH_3D_VSO
687  DF_VSD      = 29,      ///< general size VSD
688  DF_VSD4     = 30,      ///<   4xM VSD
689  DF_VSD8     = 31,      ///<   8xM VSD
690  DF_VSD16    = 32,      ///<  16xM VSD
691  DF_VSD32    = 33,      ///<  32xM VSD
692  DF_VSD64    = 34,      ///<  64xM VSD
693  DF_VSD16N   = 35,      ///< 16NxM VSD
694#endif
695  DF_SAD12           = 43,
696  DF_SAD24           = 44,
697  DF_SAD48           = 45,
698  DF_SADS12          = 46,
699  DF_SADS24          = 47,
700  DF_SADS48          = 48,
701  DF_SSE_FRAME       = 50,     ///< Frame-based SSE
702  DF_TOTAL_FUNCTIONS = 64
703};
704/// index for SBAC based RD optimization
705enum CI_IDX
706{
707  CI_CURR_BEST = 0,     ///< best mode index
708  CI_NEXT_BEST,         ///< next best index
709  CI_TEMP_BEST,         ///< temporal index
710  CI_CHROMA_INTRA,      ///< chroma intra index
711  CI_QT_TRAFO_TEST,
712  CI_QT_TRAFO_ROOT,
713  CI_NUM,               ///< total number
714};
715/// motion vector predictor direction used in AMVP
716enum MVP_DIR
717{
718  MD_LEFT = 0,          ///< MVP of left block
719  MD_ABOVE,             ///< MVP of above block
720  MD_ABOVE_RIGHT,       ///< MVP of above right block
721  MD_BELOW_LEFT,        ///< MVP of below left block
722  MD_ABOVE_LEFT         ///< MVP of above left block
723};
724#if NH_3D
725enum DefaultMergCandOrder
726{
727  MRG_T = 0,            ///< MPI
728  MRG_D,                ///< DDD
729  MRG_IVMC,             ///< Temporal inter-view
730  MRG_A1,               ///< Left
731  MRG_B1,               ///< Above
732  MRG_VSP,              ///< VSP
733  MRG_B0,               ///< Above right
734  MRG_IVDC,             ///< Disparity inter-view
735  MRG_A0,               ///< Left bottom
736  MRG_B2,               ///< Above left
737  MRG_IVSHIFT,          ///< Shifted IVMC or Shifted IVDC. (These are mutually exclusive)
738  MRG_COL               ///< Temporal co-located
739};
740#endif
741enum StoredResidualType
742{
743  RESIDUAL_RECONSTRUCTED          = 0,
744  RESIDUAL_ENCODER_SIDE           = 1,
745  NUMBER_OF_STORED_RESIDUAL_TYPES = 2
746};
747enum TransformDirection
748{
749  TRANSFORM_FORWARD              = 0,
750  TRANSFORM_INVERSE              = 1,
751  TRANSFORM_NUMBER_OF_DIRECTIONS = 2
752};
753/// supported ME search methods
754enum MESearchMethod
755{
756  MESEARCH_FULL              = 0,
757  MESEARCH_DIAMOND           = 1,
758  MESEARCH_SELECTIVE         = 2,
759  MESEARCH_DIAMOND_ENHANCED  = 3,
760  MESEARCH_NUMBER_OF_METHODS = 4
761};
762/// coefficient scanning type used in ACS
763enum COEFF_SCAN_TYPE
764{
765  SCAN_DIAG = 0,        ///< up-right diagonal scan
766  SCAN_HOR  = 1,        ///< horizontal first scan
767  SCAN_VER  = 2,        ///< vertical first scan
768  SCAN_NUMBER_OF_TYPES = 3
769};
770enum COEFF_SCAN_GROUP_TYPE
771{
772  SCAN_UNGROUPED   = 0,
773  SCAN_GROUPED_4x4 = 1,
774  SCAN_NUMBER_OF_GROUP_TYPES = 2
775};
776enum SignificanceMapContextType
777{
778  CONTEXT_TYPE_4x4    = 0,
779  CONTEXT_TYPE_8x8    = 1,
780  CONTEXT_TYPE_NxN    = 2,
781  CONTEXT_TYPE_SINGLE = 3,
782  CONTEXT_NUMBER_OF_TYPES = 4
783};
784enum ScalingListMode
785{
786  SCALING_LIST_OFF,
787  SCALING_LIST_DEFAULT,
788  SCALING_LIST_FILE_READ
789};
790enum ScalingListSize
791{
792  SCALING_LIST_4x4 = 0,
793  SCALING_LIST_8x8,
794  SCALING_LIST_16x16,
795  SCALING_LIST_32x32,
796  SCALING_LIST_SIZE_NUM
797};
798// Slice / Slice segment encoding modes
799enum SliceConstraint
800{
801  NO_SLICES              = 0,          ///< don't use slices / slice segments
802  FIXED_NUMBER_OF_CTU    = 1,          ///< Limit maximum number of largest coding tree units in a slice / slice segments
803  FIXED_NUMBER_OF_BYTES  = 2,          ///< Limit maximum number of bytes in a slice / slice segment
804  FIXED_NUMBER_OF_TILES  = 3,          ///< slices / slice segments span an integer number of tiles
805  NUMBER_OF_SLICE_CONSTRAINT_MODES = 4
806};
807// For use with decoded picture hash SEI messages, generated by encoder.
808enum HashType
809{
810  HASHTYPE_MD5             = 0,
811  HASHTYPE_CRC             = 1,
812  HASHTYPE_CHECKSUM        = 2,
813  HASHTYPE_NONE            = 3,
814  NUMBER_OF_HASHTYPES      = 4
815};
816enum SAOMode //mode
817{
818  SAO_MODE_OFF = 0,
819  SAO_MODE_NEW,
820  SAO_MODE_MERGE,
821  NUM_SAO_MODES
822};
823enum SAOModeMergeTypes
824{
825  SAO_MERGE_LEFT =0,
826  SAO_MERGE_ABOVE,
827  NUM_SAO_MERGE_TYPES
828};
829enum SAOModeNewTypes
830{
831  SAO_TYPE_START_EO =0,
832  SAO_TYPE_EO_0 = SAO_TYPE_START_EO,
833  SAO_TYPE_EO_90,
834  SAO_TYPE_EO_135,
835  SAO_TYPE_EO_45,
836  SAO_TYPE_START_BO,
837  SAO_TYPE_BO = SAO_TYPE_START_BO,
838  NUM_SAO_NEW_TYPES
839};
840#define NUM_SAO_EO_TYPES_LOG2 2
841enum SAOEOClasses
842{
843  SAO_CLASS_EO_FULL_VALLEY = 0,
844  SAO_CLASS_EO_HALF_VALLEY = 1,
845  SAO_CLASS_EO_PLAIN       = 2,
846  SAO_CLASS_EO_HALF_PEAK   = 3,
847  SAO_CLASS_EO_FULL_PEAK   = 4,
848  NUM_SAO_EO_CLASSES,
849};
850#define NUM_SAO_BO_CLASSES_LOG2  5
851#define NUM_SAO_BO_CLASSES       (1<<NUM_SAO_BO_CLASSES_LOG2)
852#if NH_MV
853enum DecodingProcess
854{
855  INVALID,
856  CLAUSE_8,
857  ANNEX_C,
858  ANNEX_F,
859  ANNEX_G,
860  ANNEX_H,
861  ANNEX_I
862};
863#endif
864namespace Profile
865{
866  enum Name
867  {
868    NONE = 0,
869    MAIN = 1,
870    MAIN10 = 2,
871    MAINSTILLPICTURE = 3,
872    MAINREXT = 4,
873    HIGHTHROUGHPUTREXT = 5
874#if NH_MV
875    ,MULTIVIEWMAIN = 6,
876    MAIN3D = 8,
877#if NH_MV_ALLOW_NON_CONFORMING
878    MULTIVIEWMAIN_NONCONFORMING = 29,
879    MAIN3D_NONCONFORMING= 31,
880#endif
881#endif
882  };
883}
884namespace Level
885{
886  enum Tier
887  {
888    MAIN = 0,
889    HIGH = 1,
890    NUMBER_OF_TIERS = 2
891  };
892  enum Name
893  {
894    // code = (level * 30)
895    NONE     = 0,
896    LEVEL1   = 30,
897    LEVEL2   = 60,
898    LEVEL2_1 = 63,
899    LEVEL3   = 90,
900    LEVEL3_1 = 93,
901    LEVEL4   = 120,
902    LEVEL4_1 = 123,
903    LEVEL5   = 150,
904    LEVEL5_1 = 153,
905    LEVEL5_2 = 156,
906    LEVEL6   = 180,
907    LEVEL6_1 = 183,
908    LEVEL6_2 = 186,
909    LEVEL8_5 = 255,
910  };
911}
912enum CostMode
913{
914  COST_STANDARD_LOSSY              = 0,
915  COST_SEQUENCE_LEVEL_LOSSLESS     = 1,
916  COST_LOSSLESS_CODING             = 2,
917  COST_MIXED_LOSSLESS_LOSSY_CODING = 3
918};
919enum WeightedPredictionMethod
920{
921  WP_PER_PICTURE_WITH_SIMPLE_DC_COMBINED_COMPONENT                          =0,
922  WP_PER_PICTURE_WITH_SIMPLE_DC_PER_COMPONENT                               =1,
923  WP_PER_PICTURE_WITH_HISTOGRAM_AND_PER_COMPONENT                           =2,
924  WP_PER_PICTURE_WITH_HISTOGRAM_AND_PER_COMPONENT_AND_CLIPPING              =3,
925  WP_PER_PICTURE_WITH_HISTOGRAM_AND_PER_COMPONENT_AND_CLIPPING_AND_EXTENSION=4
926};
927enum FastInterSearchMode
928{
929  FASTINTERSEARCH_DISABLED = 0,
930  FASTINTERSEARCH_MODE1    = 1, // TODO: assign better names to these.
931  FASTINTERSEARCH_MODE2    = 2,
932  FASTINTERSEARCH_MODE3    = 3
933};
934enum SPSExtensionFlagIndex
935{
936  SPS_EXT__REXT           = 0,
937//SPS_EXT__MVHEVC         = 1, //for use in future versions
938//SPS_EXT__SHVC           = 2, //for use in future versions
939  NUM_SPS_EXTENSION_FLAGS = 8
940};
941enum PPSExtensionFlagIndex
942{
943  PPS_EXT__REXT           = 0,
944//PPS_EXT__MVHEVC         = 1, //for use in future versions
945//PPS_EXT__SHVC           = 2, //for use in future versions
946  NUM_PPS_EXTENSION_FLAGS = 8
947};
948// TODO: Existing names used for the different NAL unit types can be altered to better reflect the names in the spec.
949//       However, the names in the spec are not yet stable at this point. Once the names are stable, a cleanup
950//       effort can be done without use of macros to alter the names used to indicate the different NAL unit types.
951enum NalUnitType
952{
953  NAL_UNIT_CODED_SLICE_TRAIL_N = 0, // 0
954  NAL_UNIT_CODED_SLICE_TRAIL_R,     // 1
955  NAL_UNIT_CODED_SLICE_TSA_N,       // 2
956  NAL_UNIT_CODED_SLICE_TSA_R,       // 3
957  NAL_UNIT_CODED_SLICE_STSA_N,      // 4
958  NAL_UNIT_CODED_SLICE_STSA_R,      // 5
959  NAL_UNIT_CODED_SLICE_RADL_N,      // 6
960  NAL_UNIT_CODED_SLICE_RADL_R,      // 7
961  NAL_UNIT_CODED_SLICE_RASL_N,      // 8
962  NAL_UNIT_CODED_SLICE_RASL_R,      // 9
963  NAL_UNIT_RESERVED_VCL_N10,
964  NAL_UNIT_RESERVED_VCL_R11,
965  NAL_UNIT_RESERVED_VCL_N12,
966  NAL_UNIT_RESERVED_VCL_R13,
967  NAL_UNIT_RESERVED_VCL_N14,
968  NAL_UNIT_RESERVED_VCL_R15,
969  NAL_UNIT_CODED_SLICE_BLA_W_LP,    // 16
970  NAL_UNIT_CODED_SLICE_BLA_W_RADL,  // 17
971  NAL_UNIT_CODED_SLICE_BLA_N_LP,    // 18
972  NAL_UNIT_CODED_SLICE_IDR_W_RADL,  // 19
973  NAL_UNIT_CODED_SLICE_IDR_N_LP,    // 20
974  NAL_UNIT_CODED_SLICE_CRA,         // 21
975  NAL_UNIT_RESERVED_IRAP_VCL22,
976  NAL_UNIT_RESERVED_IRAP_VCL23,
977  NAL_UNIT_RESERVED_VCL24,
978  NAL_UNIT_RESERVED_VCL25,
979  NAL_UNIT_RESERVED_VCL26,
980  NAL_UNIT_RESERVED_VCL27,
981  NAL_UNIT_RESERVED_VCL28,
982  NAL_UNIT_RESERVED_VCL29,
983  NAL_UNIT_RESERVED_VCL30,
984  NAL_UNIT_RESERVED_VCL31,
985  NAL_UNIT_VPS,                     // 32
986  NAL_UNIT_SPS,                     // 33
987  NAL_UNIT_PPS,                     // 34
988  NAL_UNIT_ACCESS_UNIT_DELIMITER,   // 35
989  NAL_UNIT_EOS,                     // 36
990  NAL_UNIT_EOB,                     // 37
991  NAL_UNIT_FILLER_DATA,             // 38
992  NAL_UNIT_PREFIX_SEI,              // 39
993  NAL_UNIT_SUFFIX_SEI,              // 40
994  NAL_UNIT_RESERVED_NVCL41,
995  NAL_UNIT_RESERVED_NVCL42,
996  NAL_UNIT_RESERVED_NVCL43,
997  NAL_UNIT_RESERVED_NVCL44,
998  NAL_UNIT_RESERVED_NVCL45,
999  NAL_UNIT_RESERVED_NVCL46,
1000  NAL_UNIT_RESERVED_NVCL47,
1001  NAL_UNIT_UNSPECIFIED_48,
1002  NAL_UNIT_UNSPECIFIED_49,
1003  NAL_UNIT_UNSPECIFIED_50,
1004  NAL_UNIT_UNSPECIFIED_51,
1005  NAL_UNIT_UNSPECIFIED_52,
1006  NAL_UNIT_UNSPECIFIED_53,
1007  NAL_UNIT_UNSPECIFIED_54,
1008  NAL_UNIT_UNSPECIFIED_55,
1009  NAL_UNIT_UNSPECIFIED_56,
1010  NAL_UNIT_UNSPECIFIED_57,
1011  NAL_UNIT_UNSPECIFIED_58,
1012  NAL_UNIT_UNSPECIFIED_59,
1013  NAL_UNIT_UNSPECIFIED_60,
1014  NAL_UNIT_UNSPECIFIED_61,
1015  NAL_UNIT_UNSPECIFIED_62,
1016  NAL_UNIT_UNSPECIFIED_63,
1017  NAL_UNIT_INVALID,
1018};
1019
1020enum LumaLevelToDQPMode
1021{
1022  LUMALVL_TO_DQP_DISABLED   = 0,
1023  LUMALVL_TO_DQP_AVG_METHOD = 1, // use average of CTU to determine luma level
1024  LUMALVL_TO_DQP_MAX_METHOD = 2,  // use maximum value of CTU to determine luma level
1025  LUMALVL_TO_DQP_NUM_MODES  = 3
1026};
1027
1028#if NH_MV
1029/// scalability types
1030enum ScalabilityType
1031{
1032  DEPTH_ID = 0,
1033  VIEW_ORDER_INDEX  = 1,
1034  DEPENDENCY_ID = 2,
1035  AUX_ID = 3,
1036};
1037enum DecProcPart
1038{
1039  START_PIC,
1040  FINALIZE_PIC
1041};
1042#endif
1043#if NH_3D_VSO
1044// Renderer
1045enum BlenMod
1046{
1047  BLEND_NONE  = -1,
1048  BLEND_AVRG  = 0,
1049  BLEND_LEFT  = 1,
1050  BLEND_RIGHT = 2,
1051  BLEND_GEN   =  3
1052};
1053
1054  enum SetMod
1055  {
1056    GET_FULL   = 0,
1057    SET_FULL   = 1,
1058    GET_SIMP   = 2,
1059    SET_SIMP   = 3   
1060  };
1061
1062 
1063enum
1064{
1065  VIEWPOS_INVALID = -1,
1066  VIEWPOS_LEFT    = 0,
1067  VIEWPOS_RIGHT   = 1,
1068  VIEWPOS_MERGED  = 2
1069};
1070#endif
1071// ====================================================================================================================
1072// Type definition
1073// ====================================================================================================================
1074/// parameters for adaptive loop filter
1075class TComPicSym;
1076#define MAX_NUM_SAO_CLASSES  32  //(NUM_SAO_EO_GROUPS > NUM_SAO_BO_GROUPS)?NUM_SAO_EO_GROUPS:NUM_SAO_BO_GROUPS
1077struct SAOOffset
1078{
1079  SAOMode modeIdc; // NEW, MERGE, OFF
1080  Int typeIdc;     // union of SAOModeMergeTypes and SAOModeNewTypes, depending on modeIdc.
1081  Int typeAuxInfo; // BO: starting band index
1082  Int offset[MAX_NUM_SAO_CLASSES];
1083  SAOOffset();
1084  ~SAOOffset();
1085  Void reset();
1086  const SAOOffset& operator= (const SAOOffset& src);
1087};
1088struct SAOBlkParam
1089{
1090  SAOBlkParam();
1091  ~SAOBlkParam();
1092  Void reset();
1093  const SAOBlkParam& operator= (const SAOBlkParam& src);
1094  SAOOffset& operator[](Int compIdx){ return offsetParam[compIdx];}
1095private:
1096  SAOOffset offsetParam[MAX_NUM_COMPONENT];
1097};
1098struct BitDepths
1099{
1100#if O0043_BEST_EFFORT_DECODING
1101  Int recon[MAX_NUM_CHANNEL_TYPE]; ///< the bit depth used for reconstructing the video
1102  Int stream[MAX_NUM_CHANNEL_TYPE];///< the bit depth used indicated in the SPS
1103#else
1104  Int recon[MAX_NUM_CHANNEL_TYPE]; ///< the bit depth as indicated in the SPS
1105#endif
1106};
1107/// parameters for deblocking filter
1108typedef struct _LFCUParam
1109{
1110  Bool bInternalEdge;                     ///< indicates internal edge
1111  Bool bLeftEdge;                         ///< indicates left edge
1112  Bool bTopEdge;                          ///< indicates top edge
1113} LFCUParam;
1114//TU settings for entropy encoding
1115struct TUEntropyCodingParameters
1116{
1117  const UInt            *scan;
1118  const UInt            *scanCG;
1119        COEFF_SCAN_TYPE  scanType;
1120        UInt             widthInGroups;
1121        UInt             heightInGroups;
1122        UInt             firstSignificanceMapContext;
1123};
1124struct TComPictureHash
1125{
1126  std::vector<UChar> hash;
1127  Bool operator==(const TComPictureHash &other) const
1128  {
1129    if (other.hash.size() != hash.size())
1130    {
1131      return false;
1132    }
1133    for(UInt i=0; i<UInt(hash.size()); i++)
1134    {
1135      if (other.hash[i] != hash[i])
1136      {
1137        return false;
1138      }
1139    }
1140    return true;
1141  }
1142  Bool operator!=(const TComPictureHash &other) const
1143  {
1144    return !(*this == other);
1145  }
1146};
1147struct TComSEITimeSet
1148{
1149  TComSEITimeSet() : clockTimeStampFlag(false),
1150                     numUnitFieldBasedFlag(false),
1151                     countingType(0),
1152                     fullTimeStampFlag(false),
1153                     discontinuityFlag(false),
1154                     cntDroppedFlag(false),
1155                     numberOfFrames(0),
1156                     secondsValue(0),
1157                     minutesValue(0),
1158                     hoursValue(0),
1159                     secondsFlag(false),
1160                     minutesFlag(false),
1161                     hoursFlag(false),
1162                     timeOffsetLength(0),
1163                     timeOffsetValue(0)
1164  { }
1165  Bool clockTimeStampFlag;
1166  Bool numUnitFieldBasedFlag;
1167  Int  countingType;
1168  Bool fullTimeStampFlag;
1169  Bool discontinuityFlag;
1170  Bool cntDroppedFlag;
1171  Int  numberOfFrames;
1172  Int  secondsValue;
1173  Int  minutesValue;
1174  Int  hoursValue;
1175  Bool secondsFlag;
1176  Bool minutesFlag;
1177  Bool hoursFlag;
1178  Int  timeOffsetLength;
1179  Int  timeOffsetValue;
1180};
1181struct TComSEIMasteringDisplay
1182{
1183  Bool      colourVolumeSEIEnabled;
1184  UInt      maxLuminance;
1185  UInt      minLuminance;
1186  UShort    primaries[3][2];
1187  UShort    whitePoint[2];
1188};
1189
1190struct LumaLevelToDeltaQPMapping
1191{
1192  LumaLevelToDQPMode                 mode;             ///< use deltaQP determined by block luma level
1193  Double                             maxMethodWeight;  ///< weight of max luma value when mode = 2
1194  std::vector< std::pair<Int, Int> > mapping;          ///< first=luma level, second=delta QP.
1195  Bool isEnabled() const { return mode!=LUMALVL_TO_DQP_DISABLED; }
1196};
1197
1198struct WCGChromaQPControl
1199{
1200  Bool isEnabled() const { return enabled; }
1201  Bool   enabled;         ///< Enabled flag (0:default)
1202  Double chromaCbQpScale; ///< Chroma Cb QP Scale (1.0:default)
1203  Double chromaCrQpScale; ///< Chroma Cr QP Scale (1.0:default)
1204  Double chromaQpScale;   ///< Chroma QP Scale (0.0:default)
1205  Double chromaQpOffset;  ///< Chroma QP Offset (0.0:default)
1206};
1207
1208//! \}
1209#endif
Note: See TracBrowser for help on using the repository browser.