1/******************************************************************************
2 *
3 * Copyright (C) 2015 The Android Open Source Project
4 *
5 * Licensed under the Apache License, Version 2.0 (the "License");
6 * you may not use this file except in compliance with the License.
7 * You may obtain a copy of the License at:
8 *
9 * http://www.apache.org/licenses/LICENSE-2.0
10 *
11 * Unless required by applicable law or agreed to in writing, software
12 * distributed under the License is distributed on an "AS IS" BASIS,
13 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14 * See the License for the specific language governing permissions and
15 * limitations under the License.
16 *
17 *****************************************************************************
18 * Originally developed and contributed by Ittiam Systems Pvt. Ltd, Bangalore
19*/
20
21/**
22******************************************************************************
23* @file ih264_cavlc_tables.h
24*
25* @brief
26*  This file contains enumerations, macros and extern declarations of H264
27*  cavlc tables
28*
29* @author
30*  Ittiam
31*
32*  @remarks
33*   none
34******************************************************************************
35*/
36
37#ifndef IH264_CAVLC_TABLES_H_
38#define IH264_CAVLC_TABLES_H_
39
40/*****************************************************************************/
41/* Constant Macros                                                           */
42/*****************************************************************************/
43/**
44******************************************************************************
45 *  @brief  maximum zeros left
46******************************************************************************
47 */
48#define MAX_ZERO_LEFT 6
49
50/*****************************************************************************/
51/* Extern global declarations                                                */
52/*****************************************************************************/
53
54/**
55 ******************************************************************************
56 * @brief  Assignment of cbp to a codenum for intra and inter prediction modes
57 * chroma format idc != 0
58 * input  : cbp, intra - 0/inter - 1
59 * output : codenum
60 * @remarks Table 9-4 � Assignment of codeNum to values of coded_block_pattern
61 * for macroblock prediction modes in H264 spec
62 ******************************************************************************
63 */
64extern const UWORD8 gu1_cbp_map_tables[48][2];
65
66/**
67 ******************************************************************************
68 * @brief  total non-zero coefficients and numbers of trailing ones of a residual
69 * block are mapped to coefftoken using the tables given below.
70 * input  : VLC-Num  | Trailing ones | Total coeffs
71 * output : coeff_token (code word, size of the code word)
72 * @remarks Table-9-5 coeff_token mapping to TotalCoeff( coeff_token )
73 * and TrailingOnes( coeff_token ) in H264 spec
74 ******************************************************************************
75 */
76extern const UWORD8 gu1_code_coeff_token_table[3][4][16];
77extern const UWORD8 gu1_size_coeff_token_table[3][4][16];
78extern const UWORD8 gu1_code_coeff_token_table_chroma[4][4];
79extern const UWORD8 gu1_size_coeff_token_table_chroma[4][4];
80
81/**
82 ******************************************************************************
83 * @brief  Thresholds for determining whether to increment Level table number.
84 * input  : suffix_length
85 * output : threshold
86 ******************************************************************************
87 */
88extern const UWORD8 gu1_threshold_vlc_level[6];
89
90/**
91 ******************************************************************************
92 * @brief  table for encoding total number of zeros
93 * input  : coeff_token, total zeros
94 * output : code word, size of the code word
95 * @remarks Table-9-7, 9-8  total_zeros tables for 4x4 blocks with
96 * TotalCoeff( coeff_token ) in H264 spec
97 ******************************************************************************
98 */
99extern const UWORD8 gu1_size_zero_table[135];
100extern const UWORD8 gu1_code_zero_table[135];
101extern const UWORD8 gu1_size_zero_table_chroma[9];
102extern const UWORD8 gu1_code_zero_table_chroma[9];
103
104/**
105 ******************************************************************************
106 * @brief  index to access zero table (for speed)
107 * input  : TotalCoeff( coeff_token )
108 * output : index to access zero table
109 ******************************************************************************
110 */
111extern const UWORD8 gu1_index_zero_table[15];
112
113/**
114 ******************************************************************************
115 * @brief  table for encoding runs of zeros before
116 * input  : zeros left, runs of zeros before
117 * output : code word, size of the code word
118 * @remarks Table-9-10  table for run_before in H264 spec
119 ******************************************************************************
120 */
121extern const UWORD8 gu1_size_run_table[42];
122extern const UWORD8 gu1_code_run_table[42];
123
124/**
125 ******************************************************************************
126 * @brief  index to access run table (look up)
127 * input  : zeros left
128 * output : index to access run table
129 ******************************************************************************
130 */
131extern const UWORD8 gu1_index_run_table[7];
132
133#endif /* IH264_CAVLC_TABLES_H_ */
134