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

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

Merged HTM-16.1-dev@1404.

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