source: 3DVCSoftware/branches/HTM-DEV-0.2-dev/source/Lib/TLibCommon/TypeDef.h @ 438

Last change on this file since 438 was 438, checked in by tech, 11 years ago

Integrated 3D encoder control, camera parameters, renderer and MV fixes.

  • Property svn:eol-style set to native
File size: 19.3 KB
Line 
1/* The copyright in this software is being made available under the BSD
2 * License, included below. This software may be subject to other third party
3 * and contributor rights, including patent rights, and no such rights are
4 * granted under this license. 
5 *
6 * Copyright (c) 2010-2013, ITU/ISO/IEC
7 * All rights reserved.
8 *
9 * Redistribution and use in source and binary forms, with or without
10 * modification, are permitted provided that the following conditions are met:
11 *
12 *  * Redistributions of source code must retain the above copyright notice,
13 *    this list of conditions and the following disclaimer.
14 *  * Redistributions in binary form must reproduce the above copyright notice,
15 *    this list of conditions and the following disclaimer in the documentation
16 *    and/or other materials provided with the distribution.
17 *  * Neither the name of the ITU/ISO/IEC nor the names of its contributors may
18 *    be used to endorse or promote products derived from this software without
19 *    specific prior written permission.
20 *
21 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
22 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
23 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
24 * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS
25 * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
26 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
27 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
28 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
29 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
30 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF
31 * THE POSSIBILITY OF SUCH DAMAGE.
32 */
33
34/** \file     TypeDef.h
35    \brief    Define basic types, new types and enumerations
36*/
37
38#ifndef _TYPEDEF__
39#define _TYPEDEF__
40
41//! \ingroup TLibCommon
42//! \{
43
44#define H_MV                        1
45
46
47#if H_MV
48#define H_3D                        0
49#endif
50
51///// ***** HM 10.0 *********
52
53#define L0363_DU_BIT_RATE             1 ///< L0363: add bit_rate_du_value_minus1 to HRD parameters
54#define L0328_SPLICING                1 ///< L0328: splicing support in HRD
55#define L0044_DU_DPB_OUTPUT_DELAY_HRD 1 ///< L0044: Include dpb_output_delay_du_length_minus1 in hrd_parameters(), dpb_output_du_delay in
56                                        ///<        picture timing SEI and DU information SEI
57#define L0045_PERSISTENCE_FLAGS  1      ///< L0045: Replace "repetition_period" syntax elements in SEI with "persistence_flag"
58#define L0045_NON_NESTED_SEI_RESTRICTIONS 1 ///< L0045; Include restriction on the order of APS and non-nested BP, PT and DU info SEI messages
59#define L0044_CPB_DPB_DELAY_OFFSET 1  ///< L0044: Include syntax elements cpb_delay_offset and dpb_delay_offset in the BP SEI message
60#define L0047_APS_FLAGS            1  ///< L0047: Include full_random_access_flag and no_param_set_update_flag in the active parameter set SEI message
61#define L0043_TIMING_INFO          1  ///< L0043: Timing information is signalled in VUI outside hrd_parameters()
62#define L0046_RENAME_PROG_SRC_IDC  1  ///< L0046: Rename progressive_source_idc to source_scan_type
63#define L0045_CONDITION_SIGNALLING 1  ///< L0045: Condition the signaling of some syntax elements in picture timing SEI message
64#define L0043_MSS_IDC 1
65#define L0116_ENTRY_POINT 1
66#define L0363_MORE_BITS 1
67#define L0363_MVP_POC 1
68#define L0363_BYTE_ALIGN 1
69#define L0363_SEI_ALLOW_SUFFIX 1
70#define L0323_LIMIT_DEFAULT_LIST_SIZE 1
71#define L0046_CONSTRAINT_FLAGS 1
72#define L0255_MOVE_PPS_FLAGS       1  ///< move some flags to earlier positions in the PPS
73#define L0444_FPA_TYPE             1  ///< allow only FPA types 3, 4 and 5
74#define L0372 1
75#define SIGNAL_BITRATE_PICRATE_IN_VPS               0  ///< K0125: Signal bit_rate and pic_rate in VPS
76#define L0232_RD_PENALTY           1  ///< L0232: RD-penalty for 32x32 TU for intra in non-intra slices
77
78#define MAX_VPS_NUM_HRD_PARAMETERS                1
79#define MAX_VPS_OP_SETS_PLUS1                     1024
80
81#if H_MV
82#define MAX_VPS_NUH_LAYER_ID_PLUS1  64
83#define MAX_NUM_SCALABILITY_TYPES   16
84#define ENC_CFG_CONSOUT_SPACE       29           
85#else
86#define MAX_VPS_NUH_RESERVED_ZERO_LAYER_ID_PLUS1  1
87#endif
88
89#define RATE_CONTROL_LAMBDA_DOMAIN                  1  ///< JCTVC-K0103, rate control by R-lambda model
90#define L0033_RC_BUGFIX                             1  ///< JCTVC-L0033, bug fix for R-lambda model based rate control
91
92#define MAX_CPB_CNT                     32  ///< Upper bound of (cpb_cnt_minus1 + 1)
93#define MAX_NUM_LAYER_IDS               64
94#define MAX_NUM_LAYERS                  64
95
96#define COEF_REMAIN_BIN_REDUCTION        3 ///< indicates the level at which the VLC
97                                           ///< transitions from Golomb-Rice to TU+EG(k)
98
99#define CU_DQP_TU_CMAX 5                   ///< max number bins for truncated unary
100#define CU_DQP_EG_k 0                      ///< expgolomb order
101
102#define SBH_THRESHOLD                    4  ///< I0156: value of the fixed SBH controlling threshold
103 
104#define SEQUENCE_LEVEL_LOSSLESS           0  ///< H0530: used only for sequence or frame-level lossless coding
105
106#define DISABLING_CLIP_FOR_BIPREDME         1  ///< Ticket #175
107 
108#define C1FLAG_NUMBER               8 // maximum number of largerThan1 flag coded in one chunk :  16 in HM5
109#define C2FLAG_NUMBER               1 // maximum number of largerThan2 flag coded in one chunk:  16 in HM5
110
111#define REMOVE_SAO_LCU_ENC_CONSTRAINTS_3 1  ///< disable the encoder constraint that conditionally disable SAO for chroma for entire slice in interleaved mode
112
113#define REMOVE_SINGLE_SEI_EXTENSION_FLAGS 1 ///< remove display orientation SEI extension flag (there is a generic SEI extension mechanism now)
114
115#define SAO_ENCODING_CHOICE              1  ///< I0184: picture early termination
116#if SAO_ENCODING_CHOICE
117#define SAO_ENCODING_RATE                0.75
118#define SAO_ENCODING_CHOICE_CHROMA       1 ///< J0044: picture early termination Luma and Chroma are handled separately
119#if SAO_ENCODING_CHOICE_CHROMA
120#define SAO_ENCODING_RATE_CHROMA         0.5
121#endif
122#endif
123
124#define MAX_NUM_VPS                16
125#define MAX_NUM_SPS                16
126#define MAX_NUM_PPS                64
127
128
129
130#define WEIGHTED_CHROMA_DISTORTION  1   ///< F386: weighting of chroma for RDO
131#define RDOQ_CHROMA_LAMBDA          1   ///< F386: weighting of chroma for RDOQ
132#define SAO_CHROMA_LAMBDA           1   ///< F386: weighting of chroma for SAO
133
134#define MIN_SCAN_POS_CROSS          4
135
136#define FAST_BIT_EST                1   ///< G763: Table-based bit estimation for CABAC
137
138#define MLS_GRP_NUM                         64     ///< G644 : Max number of coefficient groups, max(16, 64)
139#define MLS_CG_SIZE                         4      ///< G644 : Coefficient group size of 4x4
140
141#define ADAPTIVE_QP_SELECTION               1      ///< G382: Adaptive reconstruction levels, non-normative part for adaptive QP selection
142#if ADAPTIVE_QP_SELECTION
143#define ARL_C_PRECISION                     7      ///< G382: 7-bit arithmetic precision
144#define LEVEL_RANGE                         30     ///< G382: max coefficient level in statistics collection
145#endif
146
147#define NS_HAD                               0
148
149#define HHI_RQT_INTRA_SPEEDUP             1           ///< tests one best mode with full rqt
150#define HHI_RQT_INTRA_SPEEDUP_MOD         0           ///< tests two best modes with full rqt
151
152#if HHI_RQT_INTRA_SPEEDUP_MOD && !HHI_RQT_INTRA_SPEEDUP
153#error
154#endif
155
156#define VERBOSE_RATE 0 ///< Print additional rate information in encoder
157
158#define AMVP_DECIMATION_FACTOR            4
159
160#define SCAN_SET_SIZE                     16
161#define LOG2_SCAN_SET_SIZE                4
162
163#define FAST_UDI_MAX_RDMODE_NUM               35          ///< maximum number of RD comparison in fast-UDI estimation loop
164
165#define ZERO_MVD_EST                          0           ///< Zero Mvd Estimation in normal mode
166
167#define NUM_INTRA_MODE 36
168#if !REMOVE_LM_CHROMA
169#define LM_CHROMA_IDX  35
170#endif
171
172#define WRITE_BACK                      1           ///< Enable/disable the encoder to replace the deltaPOC and Used by current from the config file with the values derived by the refIdc parameter.
173#define AUTO_INTER_RPS                  1           ///< Enable/disable the automatic generation of refIdc from the deltaPOC and Used by current from the config file.
174#define PRINT_RPS_INFO                  0           ///< Enable/disable the printing of bits used to send the RPS.
175                                                    // using one nearest frame as reference frame, and the other frames are high quality (POC%4==0) frames (1+X)
176                                                    // this should be done with encoder only decision
177                                                    // but because of the absence of reference frame management, the related code was hard coded currently
178
179#define RVM_VCEGAM10_M 4
180
181#define PLANAR_IDX             0
182#define VER_IDX                26                    // index for intra VERTICAL   mode
183#define HOR_IDX                10                    // index for intra HORIZONTAL mode
184#define DC_IDX                 1                     // index for intra DC mode
185#define NUM_CHROMA_MODE        5                     // total number of chroma modes
186#define DM_CHROMA_IDX          36                    // chroma mode index for derived from luma intra mode
187
188
189#define FAST_UDI_USE_MPM 1
190
191#define RDO_WITHOUT_DQP_BITS              0           ///< Disable counting dQP bits in RDO-based mode decision
192
193#define FULL_NBIT 0 ///< When enabled, compute costs using full sample bitdepth.  When disabled, compute costs as if it is 8-bit source video.
194#if FULL_NBIT
195# define DISTORTION_PRECISION_ADJUSTMENT(x) 0
196#else
197# define DISTORTION_PRECISION_ADJUSTMENT(x) (x)
198#endif
199
200#define LOG2_MAX_NUM_COLUMNS_MINUS1        7
201#define LOG2_MAX_NUM_ROWS_MINUS1           7
202#define LOG2_MAX_COLUMN_WIDTH              13
203#define LOG2_MAX_ROW_HEIGHT                13
204
205#define MATRIX_MULT                             0   // Brute force matrix multiplication instead of partial butterfly
206
207#define REG_DCT 65535
208
209#define AMP_SAD                               1           ///< dedicated SAD functions for AMP
210#define AMP_ENC_SPEEDUP                       1           ///< encoder only speed-up by AMP mode skipping
211#if AMP_ENC_SPEEDUP
212#define AMP_MRG                               1           ///< encoder only force merge for AMP partition (no motion search for AMP)
213#endif
214
215#define SCALING_LIST_OUTPUT_RESULT    0 //JCTVC-G880/JCTVC-G1016 quantization matrices
216
217#define CABAC_INIT_PRESENT_FLAG     1
218
219// ====================================================================================================================
220// Basic type redefinition
221// ====================================================================================================================
222
223typedef       void                Void;
224typedef       bool                Bool;
225
226typedef       char                Char;
227typedef       unsigned char       UChar;
228typedef       short               Short;
229typedef       unsigned short      UShort;
230typedef       int                 Int;
231typedef       unsigned int        UInt;
232typedef       double              Double;
233typedef       float               Float;
234
235// ====================================================================================================================
236// 64-bit integer type
237// ====================================================================================================================
238
239#ifdef _MSC_VER
240typedef       __int64             Int64;
241
242#if _MSC_VER <= 1200 // MS VC6
243typedef       __int64             UInt64;   // MS VC6 does not support unsigned __int64 to double conversion
244#else
245typedef       unsigned __int64    UInt64;
246#endif
247
248#else
249
250typedef       long long           Int64;
251typedef       unsigned long long  UInt64;
252
253#endif
254
255// ====================================================================================================================
256// Type definition
257// ====================================================================================================================
258
259typedef       UChar           Pxl;        ///< 8-bit pixel type
260typedef       Short           Pel;        ///< 16-bit pixel type
261typedef       Int             TCoeff;     ///< transform coefficient
262
263/// parameters for adaptive loop filter
264class TComPicSym;
265
266// Slice / Slice segment encoding modes
267enum SliceConstraint
268{
269  NO_SLICES              = 0,          ///< don't use slices / slice segments
270  FIXED_NUMBER_OF_LCU    = 1,          ///< Limit maximum number of largest coding tree blocks in a slice / slice segments
271  FIXED_NUMBER_OF_BYTES  = 2,          ///< Limit maximum number of bytes in a slice / slice segment
272  FIXED_NUMBER_OF_TILES  = 3,          ///< slices / slice segments span an integer number of tiles
273};
274
275#define NUM_DOWN_PART 4
276
277enum SAOTypeLen
278{
279  SAO_EO_LEN    = 4, 
280  SAO_BO_LEN    = 4,
281  SAO_MAX_BO_CLASSES = 32
282};
283
284enum SAOType
285{
286  SAO_EO_0 = 0, 
287  SAO_EO_1,
288  SAO_EO_2, 
289  SAO_EO_3,
290  SAO_BO,
291  MAX_NUM_SAO_TYPE
292};
293
294typedef struct _SaoQTPart
295{
296  Int         iBestType;
297  Int         iLength;
298  Int         subTypeIdx ;                 ///< indicates EO class or BO band position
299  Int         iOffset[4];
300  Int         StartCUX;
301  Int         StartCUY;
302  Int         EndCUX;
303  Int         EndCUY;
304
305  Int         PartIdx;
306  Int         PartLevel;
307  Int         PartCol;
308  Int         PartRow;
309
310  Int         DownPartsIdx[NUM_DOWN_PART];
311  Int         UpPartIdx;
312
313  Bool        bSplit;
314
315  //---- encoder only start -----//
316  Bool        bProcessed;
317  Double      dMinCost;
318  Int64       iMinDist;
319  Int         iMinRate;
320  //---- encoder only end -----//
321} SAOQTPart;
322
323typedef struct _SaoLcuParam
324{
325  Bool       mergeUpFlag;
326  Bool       mergeLeftFlag;
327  Int        typeIdx;
328  Int        subTypeIdx;                  ///< indicates EO class or BO band position
329  Int        offset[4];
330  Int        partIdx;
331  Int        partIdxTmp;
332  Int        length;
333} SaoLcuParam;
334
335struct SAOParam
336{
337  Bool       bSaoFlag[2];
338  SAOQTPart* psSaoPart[3];
339  Int        iMaxSplitLevel;
340  Bool         oneUnitFlag[3];
341  SaoLcuParam* saoLcuParam[3];
342  Int          numCuInHeight;
343  Int          numCuInWidth;
344  ~SAOParam();
345};
346
347/// parameters for deblocking filter
348typedef struct _LFCUParam
349{
350  Bool bInternalEdge;                     ///< indicates internal edge
351  Bool bLeftEdge;                         ///< indicates left edge
352  Bool bTopEdge;                          ///< indicates top edge
353} LFCUParam;
354
355// ====================================================================================================================
356// Enumeration
357// ====================================================================================================================
358
359/// supported slice type
360enum SliceType
361{
362  B_SLICE,
363  P_SLICE,
364  I_SLICE
365};
366
367/// chroma formats (according to semantics of chroma_format_idc)
368enum ChromaFormat
369{
370  CHROMA_400  = 0,
371  CHROMA_420  = 1,
372  CHROMA_422  = 2,
373  CHROMA_444  = 3
374};
375
376/// supported partition shape
377enum PartSize
378{
379  SIZE_2Nx2N,           ///< symmetric motion partition,  2Nx2N
380  SIZE_2NxN,            ///< symmetric motion partition,  2Nx N
381  SIZE_Nx2N,            ///< symmetric motion partition,   Nx2N
382  SIZE_NxN,             ///< symmetric motion partition,   Nx N
383  SIZE_2NxnU,           ///< asymmetric motion partition, 2Nx( N/2) + 2Nx(3N/2)
384  SIZE_2NxnD,           ///< asymmetric motion partition, 2Nx(3N/2) + 2Nx( N/2)
385  SIZE_nLx2N,           ///< asymmetric motion partition, ( N/2)x2N + (3N/2)x2N
386  SIZE_nRx2N,           ///< asymmetric motion partition, (3N/2)x2N + ( N/2)x2N
387  SIZE_NONE = 15
388};
389
390/// supported prediction type
391enum PredMode
392{
393  MODE_INTER,           ///< inter-prediction mode
394  MODE_INTRA,           ///< intra-prediction mode
395  MODE_NONE = 15
396};
397
398/// texture component type
399enum TextType
400{
401  TEXT_LUMA,            ///< luma
402  TEXT_CHROMA,          ///< chroma (U+V)
403  TEXT_CHROMA_U,        ///< chroma U
404  TEXT_CHROMA_V,        ///< chroma V
405  TEXT_ALL,             ///< Y+U+V
406  TEXT_NONE = 15
407};
408
409/// reference list index
410enum RefPicList
411{
412  REF_PIC_LIST_0 = 0,   ///< reference list 0
413  REF_PIC_LIST_1 = 1,   ///< reference list 1
414  REF_PIC_LIST_C = 2,   ///< combined reference list for uni-prediction in B-Slices
415  REF_PIC_LIST_X = 100  ///< special mark
416};
417
418/// distortion function index
419enum DFunc
420{
421  DF_DEFAULT  = 0,
422  DF_SSE      = 1,      ///< general size SSE
423  DF_SSE4     = 2,      ///<   4xM SSE
424  DF_SSE8     = 3,      ///<   8xM SSE
425  DF_SSE16    = 4,      ///<  16xM SSE
426  DF_SSE32    = 5,      ///<  32xM SSE
427  DF_SSE64    = 6,      ///<  64xM SSE
428  DF_SSE16N   = 7,      ///< 16NxM SSE
429 
430  DF_SAD      = 8,      ///< general size SAD
431  DF_SAD4     = 9,      ///<   4xM SAD
432  DF_SAD8     = 10,     ///<   8xM SAD
433  DF_SAD16    = 11,     ///<  16xM SAD
434  DF_SAD32    = 12,     ///<  32xM SAD
435  DF_SAD64    = 13,     ///<  64xM SAD
436  DF_SAD16N   = 14,     ///< 16NxM SAD
437 
438  DF_SADS     = 15,     ///< general size SAD with step
439  DF_SADS4    = 16,     ///<   4xM SAD with step
440  DF_SADS8    = 17,     ///<   8xM SAD with step
441  DF_SADS16   = 18,     ///<  16xM SAD with step
442  DF_SADS32   = 19,     ///<  32xM SAD with step
443  DF_SADS64   = 20,     ///<  64xM SAD with step
444  DF_SADS16N  = 21,     ///< 16NxM SAD with step
445 
446  DF_HADS     = 22,     ///< general size Hadamard with step
447  DF_HADS4    = 23,     ///<   4xM HAD with step
448  DF_HADS8    = 24,     ///<   8xM HAD with step
449  DF_HADS16   = 25,     ///<  16xM HAD with step
450  DF_HADS32   = 26,     ///<  32xM HAD with step
451  DF_HADS64   = 27,     ///<  64xM HAD with step
452  DF_HADS16N  = 28,     ///< 16NxM HAD with step
453 
454#if AMP_SAD
455  DF_SAD12    = 43,
456  DF_SAD24    = 44,
457  DF_SAD48    = 45,
458
459  DF_SADS12   = 46,
460  DF_SADS24   = 47,
461  DF_SADS48   = 48,
462
463  DF_SSE_FRAME = 50     ///< Frame-based SSE
464#else
465  DF_SSE_FRAME = 33     ///< Frame-based SSE
466#endif
467};
468
469/// index for SBAC based RD optimization
470enum CI_IDX
471{
472  CI_CURR_BEST = 0,     ///< best mode index
473  CI_NEXT_BEST,         ///< next best index
474  CI_TEMP_BEST,         ///< temporal index
475  CI_CHROMA_INTRA,      ///< chroma intra index
476  CI_QT_TRAFO_TEST,
477  CI_QT_TRAFO_ROOT,
478  CI_NUM,               ///< total number
479};
480
481/// motion vector predictor direction used in AMVP
482enum MVP_DIR
483{
484  MD_LEFT = 0,          ///< MVP of left block
485  MD_ABOVE,             ///< MVP of above block
486  MD_ABOVE_RIGHT,       ///< MVP of above right block
487  MD_BELOW_LEFT,        ///< MVP of below left block
488  MD_ABOVE_LEFT         ///< MVP of above left block
489};
490
491/// coefficient scanning type used in ACS
492enum COEFF_SCAN_TYPE
493{
494  SCAN_DIAG = 0,         ///< up-right diagonal scan
495  SCAN_HOR,              ///< horizontal first scan
496  SCAN_VER               ///< vertical first scan
497};
498
499namespace Profile
500{
501  enum Name
502  {
503    NONE = 0,
504    MAIN = 1,
505    MAIN10 = 2,
506    MAINSTILLPICTURE = 3,
507#if H_MV
508    MAINSTEREO = 4,
509    MAINMULTIVIEW = 5,
510#if H_3D
511    MAIN3D = 6, 
512#endif
513#endif
514  };
515}
516
517namespace Level
518{
519  enum Tier
520  {
521    MAIN = 0,
522    HIGH = 1,
523  };
524
525  enum Name
526  {
527    NONE     = 0,
528    LEVEL1   = 30,
529    LEVEL2   = 60,
530    LEVEL2_1 = 63,
531    LEVEL3   = 90,
532    LEVEL3_1 = 93,
533    LEVEL4   = 120,
534    LEVEL4_1 = 123,
535    LEVEL5   = 150,
536    LEVEL5_1 = 153,
537    LEVEL5_2 = 156,
538    LEVEL6   = 180,
539    LEVEL6_1 = 183,
540    LEVEL6_2 = 186,
541  };
542}
543//! \}
544
545#if H_MV
546/// scalability types
547  enum ScalabilityType
548  {
549    VIEW_ID  = 0,
550#if H_3D
551    DEPTH_ID = 1,
552#endif   
553  };
554#endif
555#endif
556
Note: See TracBrowser for help on using the repository browser.