source: 3DVCSoftware/trunk/source/Lib/TLibCommon/TComRom.h @ 1245

Last change on this file since 1245 was 1196, checked in by tech, 10 years ago

Merged 14.0-dev0@1187.

  • Property svn:eol-style set to native
File size: 15.9 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-2015, 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     TComRom.h
35    \brief    global variables & functions (header)
36*/
37
38#ifndef __TCOMROM__
39#define __TCOMROM__
40
41#include "CommonDef.h"
42#include "TypeDef.h"
43
44#include<stdio.h>
45#include<iostream>
46
47#if H_3D_DIM
48#include "TComWedgelet.h"
49#endif
50
51//! \ingroup TLibCommon
52//! \{
53
54// ====================================================================================================================
55// Macros
56// ====================================================================================================================
57
58#define     MAX_CU_DEPTH            6                           // log2(LCUSize)
59#define     MAX_CU_SIZE             (1<<(MAX_CU_DEPTH))         // maximum allowable size of CU
60#define     MIN_PU_SIZE             4
61#define     MAX_NUM_SPU_W           (MAX_CU_SIZE/MIN_PU_SIZE)   // maximum number of SPU in horizontal line
62
63// ====================================================================================================================
64// Initialize / destroy functions
65// ====================================================================================================================
66
67Void         initROM();
68Void         destroyROM();
69Void         initSigLastScan(UInt* pBuffD, UInt* pBuffH, UInt* pBuffV, Int iWidth, Int iHeight);
70// ====================================================================================================================
71// Data structure related table & variable
72// ====================================================================================================================
73
74// flexible conversion from relative to absolute index
75extern       UInt   g_auiZscanToRaster[ MAX_NUM_SPU_W*MAX_NUM_SPU_W ];
76extern       UInt   g_auiRasterToZscan[ MAX_NUM_SPU_W*MAX_NUM_SPU_W ];
77
78Void         initZscanToRaster ( Int iMaxDepth, Int iDepth, UInt uiStartVal, UInt*& rpuiCurrIdx );
79Void         initRasterToZscan ( UInt uiMaxCUWidth, UInt uiMaxCUHeight, UInt uiMaxDepth         );
80
81// conversion of partition index to picture pel position
82extern       UInt   g_auiRasterToPelX[ MAX_NUM_SPU_W*MAX_NUM_SPU_W ];
83extern       UInt   g_auiRasterToPelY[ MAX_NUM_SPU_W*MAX_NUM_SPU_W ];
84
85Void         initRasterToPelXY ( UInt uiMaxCUWidth, UInt uiMaxCUHeight, UInt uiMaxDepth );
86
87// global variable (LCU width/height, max. CU depth)
88extern       UInt g_uiMaxCUWidth;
89extern       UInt g_uiMaxCUHeight;
90extern       UInt g_uiMaxCUDepth;
91extern       UInt g_uiAddCUDepth;
92
93#define MAX_TS_WIDTH  4
94#define MAX_TS_HEIGHT 4
95
96extern       UInt g_auiPUOffset[8];
97
98#define QUANT_IQUANT_SHIFT    20 // Q(QP%6) * IQ(QP%6) = 2^20
99#define QUANT_SHIFT           14 // Q(4) = 2^14
100#define SCALE_BITS            15 // Inherited from TMuC, pressumably for fractional bit estimates in RDOQ
101#define MAX_TR_DYNAMIC_RANGE  15 // Maximum transform dynamic range (excluding sign bit)
102
103#define SHIFT_INV_1ST          7 // Shift after first inverse transform stage
104#define SHIFT_INV_2ND         12 // Shift after second inverse transform stage
105
106extern Int g_quantScales[6];             // Q(QP%6) 
107extern Int g_invQuantScales[6];          // IQ(QP%6)
108extern const Short g_aiT4[4][4];
109extern const Short g_aiT8[8][8];
110extern const Short g_aiT16[16][16];
111extern const Short g_aiT32[32][32];
112
113// ====================================================================================================================
114// Luma QP to Chroma QP mapping
115// ====================================================================================================================
116
117extern const UChar  g_aucChromaScale      [58];
118
119// ====================================================================================================================
120// Scanning order & context mapping table
121// ====================================================================================================================
122
123extern       UInt*  g_auiSigLastScan[ 3 ][ MAX_CU_DEPTH ];  // raster index from scanning index (diag, hor, ver)
124
125extern const UInt   g_uiGroupIdx[ 32 ];
126extern const UInt   g_uiMinInGroup[ 10 ];
127
128extern const UInt   g_sigLastScan8x8[ 3 ][ 4 ];           //!< coefficient group scan order for 8x8 TUs
129extern       UInt   g_sigLastScanCG32x32[ 64 ];
130
131// ====================================================================================================================
132// ADI table
133// ====================================================================================================================
134
135extern const UChar  g_aucIntraModeNumFast[ MAX_CU_DEPTH ];
136
137// ====================================================================================================================
138// Bit-depth
139// ====================================================================================================================
140
141extern        Int g_bitDepthY;
142extern        Int g_bitDepthC;
143extern       UInt g_uiPCMBitDepthLuma;
144extern       UInt g_uiPCMBitDepthChroma;
145
146// ====================================================================================================================
147// Texture type to integer mapping
148// ====================================================================================================================
149
150extern const UChar g_aucConvertTxtTypeToIdx[4];
151
152#if H_3D_DIM
153// ====================================================================================================================
154// Depth coding modes
155// ====================================================================================================================
156__inline Void mapDepthModeToIntraDir( UInt& intraMode ) { if( isDimMode( intraMode ) ) intraMode = DC_IDX; }
157__inline Void mapDepthModeToIntraDir(  Int& intraMode ) { if( isDimMode( intraMode ) ) intraMode = DC_IDX; }
158
159#if H_3D_DIM_SDC || H_3D_DIM_DLT
160__inline UInt numBitsForValue( UInt value ) { UInt bits = 0; while (value != 0) { value >>= 1; bits++; } return bits; };
161#endif
162
163#if H_3D_DIM_DMM
164extern const WedgeResolution                                 g_dmmWedgeResolution [6];
165extern const UChar                                           g_dmm1TabIdxBits     [6];
166extern const UChar                                           g_dmm3IntraTabIdxBits[6];
167
168extern Bool                                                  g_wedgePattern[32*32];
169
170extern       std::vector< std::vector<TComWedgelet> >        g_dmmWedgeLists;
171extern       std::vector< std::vector<TComWedgeRef> >        g_dmmWedgeRefLists;
172extern       std::vector< std::vector<TComWedgeNode> >       g_dmmWedgeNodeLists;
173
174Void initWedgeLists( Bool initNodeList = false );
175Void createWedgeList( UInt uiWidth, UInt uiHeight, std::vector<TComWedgelet> &racWedgeList, std::vector<TComWedgeRef> &racWedgeRefList, WedgeResolution eWedgeRes );
176Void addWedgeletToList( TComWedgelet cWedgelet, std::vector<TComWedgelet> &racWedgeList, std::vector<TComWedgeRef> &racWedgeRefList );
177#endif
178#endif
179
180// ==========================================
181// Mode-Dependent DST Matrices
182extern const Short g_as_DST_MAT_4 [4][4];
183extern const UChar g_aucDCTDSTMode_Vert[NUM_INTRA_MODE];
184extern const UChar g_aucDCTDSTMode_Hor[NUM_INTRA_MODE];
185// ==========================================
186
187#if H_MV_HLS_PTL_LIMITS
188class TComGeneralTierAndLevelLimits
189{
190public:
191  TComGeneralTierAndLevelLimits::TComGeneralTierAndLevelLimits
192  ( Int maxLumaPs, 
193    Int maxCPBMainTier, 
194    Int maxCPBHighTier, 
195    Int maxSliceSegmentsPerPicture, 
196    Int maxTileRows, 
197    Int maxTileCols )
198  : m_maxLumaPs                 ( maxLumaPs                     ),
199    m_maxCPBMainTier            ( maxCPBMainTier                ),
200    m_maxCPBHighTier            ( maxCPBHighTier                ),
201    m_maxSliceSegmentsPerPicture( maxSliceSegmentsPerPicture    ),
202    m_maxTileRows               ( maxTileRows                   ),
203    m_maxTileCols               ( maxTileCols                   );
204  {};
205
206  Int getMaxLumaPs                 ( ) { return m_maxLumaPs                 ; };
207  Int getMaxCPBMainTier            ( ) { return m_maxCPBMainTier            ; };
208  Int getMaxCPBHighTier            ( ) { return m_maxCPBHighTier            ; };
209  Int getMaxSliceSegmentsPerPicture( ) { return m_maxSliceSegmentsPerPicture; };
210  Int getMaxTileRows               ( ) { return m_maxTileRows               ; };
211  Int getMaxTileCols               ( ) { return m_maxTileCols               ; };
212
213private:
214  const Int m_maxLumaPs;
215  const Int m_maxCPBMainTier; 
216  const Int m_maxCPBHighTier;
217  const Int m_maxSliceSegmentsPerPicture; 
218  const Int m_maxTileRows; 
219  const Int m_maxTileCols; 
220};
221
222extern std::map< Level::Name, TComGeneralTierAndLevelLimits > g_generalTierAndLevelLimits;   
223
224#endif
225// ====================================================================================================================
226// Misc.
227// ====================================================================================================================
228
229extern       Char   g_aucConvertToBit  [ MAX_CU_SIZE+1 ];   // from width to log2(width)-2
230
231#ifndef ENC_DEC_TRACE
232#define ENC_DEC_TRACE   0 
233#endif
234
235#if ENC_DEC_TRACE
236extern FILE*  g_hTrace;
237extern Bool   g_bJustDoIt;
238extern const Bool g_bEncDecTraceEnable;
239extern const Bool g_bEncDecTraceDisable;
240extern Bool   g_HLSTraceEnable;
241extern UInt64 g_nSymbolCounter;
242
243#define COUNTER_START    1
244#define COUNTER_END      0 //( UInt64(1) << 63 )
245
246#define DTRACE_CABAC_F(x)     if ( ( g_nSymbolCounter >= COUNTER_START && g_nSymbolCounter <= COUNTER_END )|| g_bJustDoIt ) fprintf( g_hTrace, "%f", x );
247#define DTRACE_CABAC_V(x)     if ( ( g_nSymbolCounter >= COUNTER_START && g_nSymbolCounter <= COUNTER_END )|| g_bJustDoIt ) fprintf( g_hTrace, "%d", x );
248#define DTRACE_CABAC_VL(x)    if ( ( g_nSymbolCounter >= COUNTER_START && g_nSymbolCounter <= COUNTER_END )|| g_bJustDoIt ) fprintf( g_hTrace, "%lld", x );
249#define DTRACE_CABAC_T(x)     if ( ( g_nSymbolCounter >= COUNTER_START && g_nSymbolCounter <= COUNTER_END )|| g_bJustDoIt ) fprintf( g_hTrace, "%s", x );
250#define DTRACE_CABAC_X(x)     if ( ( g_nSymbolCounter >= COUNTER_START && g_nSymbolCounter <= COUNTER_END )|| g_bJustDoIt ) fprintf( g_hTrace, "%x", x );
251#define DTRACE_CABAC_R( x,y ) if ( ( g_nSymbolCounter >= COUNTER_START && g_nSymbolCounter <= COUNTER_END )|| g_bJustDoIt ) fprintf( g_hTrace, x,    y );
252#define DTRACE_CABAC_N        if ( ( g_nSymbolCounter >= COUNTER_START && g_nSymbolCounter <= COUNTER_END )|| g_bJustDoIt ) fprintf( g_hTrace, "\n"    );
253
254#if H_MV_ENC_DEC_TRAC
255 extern Bool   g_traceCU; 
256 extern Bool   g_tracePU; 
257 extern Bool   g_traceTU; 
258 extern Bool   g_disableHLSTrace;       // USE g_HLSTraceEnable to toggle HLS trace. Not this one!
259 extern Bool   g_disableNumbering;      // Don't print numbers to trace file
260 extern UInt64 g_stopAtCounter;         // Counter to set breakpoint.
261 extern Bool   g_traceCopyBack;         // Output samples on copy back 
262 extern Bool   g_decTraceDispDer;       // Trace derived disparity vectors (decoder only)
263 extern Bool   g_decTraceMvFromMerge;   // Trace motion vectors obtained from merge (decoder only)
264 extern Bool   g_decTracePicOutput;     // Trace output of pictures
265 extern Bool   g_stopAtPos;             // Stop at position
266 extern Bool   g_outputPos;             // Output position
267 extern Bool   g_traceCameraParameters; // Trace camera parameters
268 extern Bool   g_encNumberOfWrittenBits;// Trace number of written bits
269
270#define DTRACE_CU(x,y)             writeToTraceFile( x,y, g_traceCU );
271#define DTRACE_PU(x,y)             writeToTraceFile( x,y, g_tracePU );
272#define DTRACE_TU(x,y)             writeToTraceFile( x,y, g_traceTU );
273#define DTRACE_CU_S(x)             writeToTraceFile( x,   g_traceCU );
274#define DTRACE_PU_S(x)             writeToTraceFile( x,   g_tracePU );
275#define DTRACE_TU_S(x)             writeToTraceFile( x,   g_traceTU );
276
277 Void           writeToTraceFile( const Char* symbolName, Int val, Bool doIt );
278 Void           writeToTraceFile( const Char* symbolName, Bool doIt );
279 Void           stopAtPos       ( Int poc, Int layerId, Int cuPelX, Int cuPelY, Int cuWidth, Int cuHeight );
280#endif
281#else
282
283#define DTRACE_CABAC_F(x)
284#define DTRACE_CABAC_V(x)
285#define DTRACE_CABAC_VL(x)
286#define DTRACE_CABAC_T(x)
287#define DTRACE_CABAC_X(x)
288#define DTRACE_CABAC_R( x,y )
289#define DTRACE_CABAC_N
290
291#if H_MV_ENC_DEC_TRAC
292#define DTRACE_CU(x,y) ;             
293#define DTRACE_PU(x,y) ;           
294#define DTRACE_TU(x,y) ;           
295
296#define DTRACE_CU_S(x) ;           
297#define DTRACE_PU_S(x) ;           
298#define DTRACE_TU_S(x) ;           
299
300#endif
301#endif
302
303
304#define SCALING_LIST_NUM 6         ///< list number for quantization matrix
305#define SCALING_LIST_NUM_32x32 2   ///< list number for quantization matrix 32x32
306#define SCALING_LIST_REM_NUM 6     ///< remainder of QP/6
307#define SCALING_LIST_START_VALUE 8 ///< start value for dpcm mode
308#define MAX_MATRIX_COEF_NUM 64     ///< max coefficient number for quantization matrix
309#define MAX_MATRIX_SIZE_NUM 8      ///< max size number for quantization matrix
310#define SCALING_LIST_DC 16         ///< default DC value
311enum ScalingListSize
312{
313  SCALING_LIST_4x4 = 0,
314  SCALING_LIST_8x8,
315  SCALING_LIST_16x16,
316  SCALING_LIST_32x32,
317  SCALING_LIST_SIZE_NUM
318};
319static const Char MatrixType[4][6][20] =
320{
321  {
322  "INTRA4X4_LUMA",
323  "INTRA4X4_CHROMAU",
324  "INTRA4X4_CHROMAV",
325  "INTER4X4_LUMA",
326  "INTER4X4_CHROMAU",
327  "INTER4X4_CHROMAV"
328  },
329  {
330  "INTRA8X8_LUMA",
331  "INTRA8X8_CHROMAU", 
332  "INTRA8X8_CHROMAV", 
333  "INTER8X8_LUMA",
334  "INTER8X8_CHROMAU", 
335  "INTER8X8_CHROMAV" 
336  },
337  {
338  "INTRA16X16_LUMA",
339  "INTRA16X16_CHROMAU", 
340  "INTRA16X16_CHROMAV", 
341  "INTER16X16_LUMA",
342  "INTER16X16_CHROMAU", 
343  "INTER16X16_CHROMAV" 
344  },
345  {
346  "INTRA32X32_LUMA",
347  "INTER32X32_LUMA",
348  },
349};
350static const Char MatrixType_DC[4][12][22] =
351{
352  {
353  },
354  {
355  },
356  {
357  "INTRA16X16_LUMA_DC",
358  "INTRA16X16_CHROMAU_DC", 
359  "INTRA16X16_CHROMAV_DC", 
360  "INTER16X16_LUMA_DC",
361  "INTER16X16_CHROMAU_DC", 
362  "INTER16X16_CHROMAV_DC" 
363  },
364  {
365  "INTRA32X32_LUMA_DC",
366  "INTER32X32_LUMA_DC",
367  },
368};
369extern Int g_quantIntraDefault8x8[64];
370extern Int g_quantIntraDefault16x16[256];
371extern Int g_quantIntraDefault32x32[1024];
372extern Int g_quantInterDefault8x8[64];
373extern Int g_quantInterDefault16x16[256];
374extern Int g_quantInterDefault32x32[1024];
375extern Int g_quantTSDefault4x4[16];
376extern UInt g_scalingListSize [SCALING_LIST_SIZE_NUM];
377extern UInt g_scalingListSizeX[SCALING_LIST_SIZE_NUM];
378extern UInt g_scalingListNum  [SCALING_LIST_SIZE_NUM];
379extern Int  g_eTTable[4];
380//! \}
381
382#endif  //__TCOMROM__
383
Note: See TracBrowser for help on using the repository browser.