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 #ifndef _IH264D_STRUCTS_H_
21 #define _IH264D_STRUCTS_H_
22 
23 #include "ih264_typedefs.h"
24 #include "ih264_macros.h"
25 #include "ih264_platform_macros.h"
26 #include "iv.h"
27 #include "ivd.h"
28 
29 #include "ih264d_transfer_address.h"
30 #include "ih264d_defs.h"
31 #include "ih264d_defs.h"
32 #include "ih264d_bitstrm.h"
33 #include "ih264d_debug.h"
34 #include "ih264d_dpb_manager.h"
35 /* includes for CABAC */
36 #include "ih264d_cabac.h"
37 #include "ih264d_dpb_manager.h"
38 
39 #include "ih264d_vui.h"
40 #include "ih264d_sei.h"
41 #include "iv.h"
42 #include "ivd.h"
43 
44 #include "ih264_weighted_pred.h"
45 #include "ih264_trans_quant_itrans_iquant.h"
46 #include "ih264_inter_pred_filters.h"
47 #include "ih264_mem_fns.h"
48 #include "ih264_padding.h"
49 #include "ih264_intra_pred_filters.h"
50 #include "ih264_deblk_edge_filters.h"
51 
52 
53 
54 
55 
56 /** Number of Mb's whoose syntax will be read */
57 /************************************************************/
58 /* MB_GROUP should be a multiple of 2                       */
59 /************************************************************/
60 #define PARSE_MB_GROUP_4            4
61 
62 /* MV_SCRATCH_BUFS assumed to be pow(2) */
63 #define MV_SCRATCH_BUFS             4
64 
65 #define TOP_FIELD_ONLY      0x02
66 #define BOT_FIELD_ONLY      0x01
67 
68 #define MAX_REF_BUF_SIZE       (3776*2*2)
69 
70 struct _DecStruct;
71 struct _DecMbInfo;
72 
73 typedef enum
74 {
75     MB_TYPE_SI_SLICE = 0,
76     MB_TYPE_I_SLICE = 3,
77     MB_SKIP_FLAG_P_SLICE = 11,
78     MB_TYPE_P_SLICE = 14,
79     SUB_MB_TYPE_P_SLICE = 21,
80     MB_SKIP_FLAG_B_SLICE = 24,
81     MB_TYPE_B_SLICE = 27,
82     SUB_MB_TYPE_B_SLICE = 36,
83     MVD_X = 40,
84     MVD_Y = 47,
85     REF_IDX = 54,
86     MB_QP_DELTA = 60,
87     INTRA_CHROMA_PRED_MODE = 64,
88     PREV_INTRA4X4_PRED_MODE_FLAG = 68,
89     REM_INTRA4X4_PRED_MODE = 69,
90     MB_FIELD_DECODING_FLAG = 70,
91     CBP_LUMA = 73,
92     CBP_CHROMA = 77,
93     CBF = 85,
94     SIGNIFICANT_COEFF_FLAG_FRAME = 105,
95     SIGNIFICANT_COEFF_FLAG_FLD = 277,
96     LAST_SIGNIFICANT_COEFF_FLAG_FRAME = 166,
97     LAST_SIGNIFICANT_COEFF_FLAG_FLD = 338,
98     COEFF_ABS_LEVEL_MINUS1 = 227,
99 
100     /* High profile related Syntax element CABAC offsets */
101     TRANSFORM_SIZE_8X8_FLAG = 399,
102     SIGNIFICANT_COEFF_FLAG_8X8_FRAME = 402,
103     LAST_SIGNIFICANT_COEFF_FLAG_8X8_FRAME = 417,
104     COEFF_ABS_LEVEL_MINUS1_8X8 = 426,
105     SIGNIFICANT_COEFF_FLAG_8X8_FIELD = 436,
106     LAST_SIGNIFICANT_COEFF_FLAG_8X8_FIELD = 451
107 
108 } cabac_table_num_t;
109 
110 typedef enum
111 {
112     SIG_COEFF_CTXT_CAT_0_OFFSET = 0,
113     SIG_COEFF_CTXT_CAT_1_OFFSET = 15,
114     SIG_COEFF_CTXT_CAT_2_OFFSET = 29,
115     SIG_COEFF_CTXT_CAT_3_OFFSET = 44,
116     SIG_COEFF_CTXT_CAT_4_OFFSET = 47,
117     SIG_COEFF_CTXT_CAT_5_OFFSET = 0,
118     COEFF_ABS_LEVEL_CAT_0_OFFSET = 0,
119     COEFF_ABS_LEVEL_CAT_1_OFFSET = 10,
120     COEFF_ABS_LEVEL_CAT_2_OFFSET = 20,
121     COEFF_ABS_LEVEL_CAT_3_OFFSET = 30,
122     COEFF_ABS_LEVEL_CAT_4_OFFSET = 39,
123     COEFF_ABS_LEVEL_CAT_5_OFFSET = 0
124 } cabac_blk_cat_offset_t;
125 
126 /** Structure for the MV bank */
127 typedef struct _mv_pred_t
128 {
129     WORD16 i2_mv[4]; /** 0- mvFwdX, 1- mvFwdY, 2- mvBwdX, 3- mvBwdY */
130     WORD8 i1_ref_frame[2];
131 
132     UWORD8 u1_col_ref_pic_idx; /** Idx into the pic buff array */
133     UWORD8 u1_pic_type; /** Idx into the pic buff array */
134 
135 } mv_pred_t;
136 
137 typedef struct
138 {
139     WORD32 i4_mv_indices[16];
140     WORD8 i1_submb_num[16];
141     WORD8 i1_partitionsize[16];
142     WORD8 i1_num_partitions;
143     WORD8 u1_vert_mv_scale;
144     UWORD8 u1_col_zeroflag_change;
145 } directmv_t;
146 
147 typedef struct pic_buffer_t
148 {
149     /**Different components of the picture */
150     UWORD8 *pu1_buf1;
151     UWORD8 *pu1_buf2;
152     UWORD8 *pu1_buf3;
153     UWORD16 u2_disp_width; /** Width of the display luma frame in pixels */
154     UWORD16 u2_disp_height; /** Height of the display luma frame in pixels */
155     UWORD32 u4_time_stamp; /** Time at which frame has to be displayed */
156     UWORD16 u2_frm_wd_y; /** Width of the luma frame in pixels */
157     UWORD16 u2_frm_wd_uv; /** Width of the chroma frame */
158     UWORD16 u2_frm_ht_y; /** Height of the luma frame in pixels */
159     UWORD16 u2_frm_ht_uv; /** Height of the chroma frame */
160     /* Upto this is resembling the structure IH264DEC_DispUnit */
161 
162     /* If any member is to be added, add below this            */
163 
164     /* u4_ofst from start of picture buffer to display position for Y buffer  */
165     UWORD16 u2_crop_offset_y;
166 
167     /* u4_ofst from start of picture buffer to display position for UV buffer */
168     UWORD16 u2_crop_offset_uv;
169 
170     UWORD8 u1_is_short; /** (1: short 0: long) term ref pic */
171     UWORD8 u1_pic_type; /** frame / field / complementary field pair */
172     UWORD8 u1_pic_buf_id; /** Idx into the picBufAPI array */
173     UWORD8 u1_mv_buf_id;
174     WORD32 i4_seq;
175     UWORD8 *pu1_col_zero_flag;
176     mv_pred_t *ps_mv; /** Pointer to the MV bank array */
177     WORD32 i4_poc; /** POC */
178     WORD32 i4_pic_num;
179     WORD32 i4_frame_num;
180     WORD32 i4_top_field_order_cnt; /** TopPOC */
181     WORD32 i4_bottom_field_order_cnt; /** BottomPOC */
182     WORD32 i4_avg_poc; /** minPOC */
183     UWORD8 u1_picturetype; /*Same as u1_pic_type..u1_pic_type gets overwritten whereas
184      this doesnot get overwritten ...stores the pictype of
185      frame/complementary field pair/ mbaff */
186     UWORD8 u1_long_term_frm_idx;
187     UWORD8 u1_long_term_pic_num;
188     UWORD32 u4_pack_slc_typ; /* It will contain information about types of slices */
189 
190     /* ! */
191     UWORD32 u4_ts;
192     UWORD8 u1_pic_struct;/* Refer to SEI table D-1 */
193 
194 } pic_buffer_t;
195 
196 typedef struct
197 {
198     void *u4_add[4];
199 } neighbouradd_t;
200 
201 typedef struct
202 {
203     const UWORD8 *pu1_inv_scan;
204     void *pv_table[6];
205 } cavlc_cntxt_t;
206 
207 /**
208  ************************************************************************
209  * \file ih264d_structs.h
210  *
211  * \brief
212  *    Structures used in the H.264 decoder
213  *
214  * \date
215  *    18/11/2002
216  *
217  * \author  Sriram Sethuraman
218  *
219  ************************************************************************
220  */
221 
222 /**
223  * Structure to represent a MV Bank buffer and col flag
224  */
225 typedef struct
226 {
227     /**
228      *  Pointer to buffer that holds col flag.
229      */
230     void *pv_col_zero_flag;
231 
232     /**
233      * Pointer to buffer that holds mv_pred
234      */
235     void *pv_mv;
236 
237  }col_mv_buf_t;
238 
239 
240 typedef struct
241 {
242     UWORD8 u1_dydx; /** 4*dy + dx for Y comp / 8*dy + dx for UV comp */
243     UWORD8 u1_is_bi_direct; /** 1: is bi-direct 0: forward / backward only   */
244     UWORD8 u1_wght_pred_type; /** 0-default 1-singleWeighted 2-BiWeighted      */
245     WORD8 i1_mb_partwidth; /** Width of MB partition                        */
246     WORD8 i1_mb_partheight; /** Height of MB partition                       */
247     WORD8 i1_mc_wd; /** Number of bytes in a DMA stride              */
248     WORD8 i1_dma_ht; /** Number of strides                            */
249 
250     WORD8 i1_pod_ht; /** Flag specifying height of pad on demand      */
251     /** 0 (No pod) -ve(Top pod) +ve(Bottom pod)      */
252     UWORD16 u2_dst_stride; /** Stride value of the destination              */
253     UWORD16 u2_u1_ref_buf_wd; /** Width of the ref buffer                      */
254     UWORD16 u2_frm_wd;
255     UWORD16 u2_dummy;
256 
257     UWORD8 *u1_pi1_wt_ofst_rec_v; /** Pointer to packed weight and u4_ofst          */
258     UWORD8 *pu1_rec_y_u; /** MB partition address in row buffer           */
259     UWORD8 *pu1_dma_dest_addr; /** Destination address for DMA transfer         */
260     UWORD8 *pu1_y_ref;
261     UWORD8 *pu1_u_ref;
262     UWORD8 *pu1_v_ref;
263 
264     UWORD8 *pu1_pred;
265     UWORD8 *pu1_pred_u;
266     UWORD8 *pu1_pred_v;
267     UWORD8 u1_dma_wd_y;
268     UWORD8 u1_dma_ht_y;
269     UWORD8 u1_dma_wd_uv;
270     UWORD8 u1_dma_ht_uv;
271 } pred_info_t;
272 
273 typedef struct
274 {
275     UWORD32 *pu4_wt_offst;
276     WORD16 i2_mv[2];
277 
278     /***************************************************/
279     /*packing information  i1_size_pos_info             */
280     /* bit 1:0 -> X position in terms of  (4x4) units   */
281     /* bit 3:2 -> Y position in terms of  (4x4) units   */
282     /* bit 5:4 -> PU width 0:4,1:8,2:16                 */
283     /* bit 7:6 -> PU height 0:4,1:8,2:16                */
284      /***************************************************/
285     WORD8 i1_size_pos_info;
286 
287     /***************************************************/
288     /*packing information ref idx info                 */
289     /* bit 5:0 ->ref_idx                              */
290     /* bit 6:7   -> 0:l0,1:l1,2:bipred                  */
291      /***************************************************/
292     WORD8 i1_ref_idx_info;
293 
294     WORD8 i1_buf_id;
295 
296 
297     UWORD8 u1_pic_type; /** frame /top field/bottom field/mbaff / complementary field pair */
298 
299 }pred_info_pkd_t;
300 /*! Sequence level parameters */
301 
302 typedef struct
303 {
304     UWORD8 u1_seq_parameter_set_id; /** id for the seq par set 0-31 */
305     UWORD8 u1_is_valid; /** is Seq Param set valid */
306 
307     UWORD16 u2_frm_wd_in_mbs; /** Frame width expressed in MB units */
308     UWORD16 u2_frm_ht_in_mbs; /** Frame height expressed in MB units */
309 
310     /* Following are derived from the above two */
311     UWORD16 u2_fld_ht_in_mbs; /** Field height expressed in MB units */
312     UWORD16 u2_max_mb_addr; /** Total number of macroblocks in a coded picture */
313     UWORD16 u2_total_num_of_mbs; /** Total number of macroblocks in a coded picture */
314     UWORD32 u4_fld_ht; /** field height */
315     UWORD32 u4_cwidth; /** chroma width */
316     UWORD32 u4_chr_frm_ht; /** chroma height */
317     UWORD32 u4_chr_fld_ht; /** chroma field height */
318     UWORD8 u1_mb_aff_flag; /** 0 - no mb_aff; 1 - uses mb_aff */
319 
320     UWORD8 u1_profile_idc; /** profile value */
321     UWORD8 u1_level_idc; /** level value */
322 
323     /* high profile related syntax elements   */
324     WORD32 i4_chroma_format_idc;
325     WORD32 i4_bit_depth_luma_minus8;
326     WORD32 i4_bit_depth_chroma_minus8;
327     WORD32 i4_qpprime_y_zero_transform_bypass_flag;
328     WORD32 i4_seq_scaling_matrix_present_flag;
329     UWORD8 u1_seq_scaling_list_present_flag[8];
330     UWORD8 u1_use_default_scaling_matrix_flag[8];
331     WORD16 i2_scalinglist4x4[6][16];
332     WORD16 i2_scalinglist8x8[2][64];
333     UWORD8 u1_more_than_one_slice_group_allowed_flag;
334     UWORD8 u1_arbitrary_slice_order_allowed_flag;
335     UWORD8 u1_redundant_slices_allowed_flag;
336     UWORD8 u1_bits_in_frm_num; /** Number of bits in frame num */
337     UWORD16 u2_u4_max_pic_num_minus1; /** Maximum frame num minus 1 */
338     UWORD8 u1_pic_order_cnt_type; /** 0 - 2 indicates the method to code picture order count */
339     UWORD8 u1_log2_max_pic_order_cnt_lsb_minus;
340     WORD32 i4_max_pic_order_cntLsb;
341     UWORD8 u1_num_ref_frames_in_pic_order_cnt_cycle;
342     UWORD8 u1_delta_pic_order_always_zero_flag;
343     WORD32 i4_ofst_for_non_ref_pic;
344     WORD32 i4_ofst_for_top_to_bottom_field;
345     WORD32 i4_ofst_for_ref_frame[MAX_NUM_REF_FRAMES_OFFSET];
346     UWORD8 u1_num_ref_frames;
347     UWORD8 u1_gaps_in_frame_num_value_allowed_flag;
348     UWORD8 u1_frame_mbs_only_flag; /** 1 - frame only; 0 - field/frame pic */
349     UWORD8 u1_direct_8x8_inference_flag;
350     UWORD8 u1_vui_parameters_present_flag;
351     vui_t s_vui;
352 } dec_seq_params_t;
353 
354 typedef struct
355 {
356     UWORD16 u2_frm_wd_in_mbs; /** Frame width expressed in MB units    */
357     UWORD16 u2_frm_ht_in_mbs; /** Frame height expressed in MB units   */
358     UWORD8 u1_frame_mbs_only_flag; /** 1 - frame only; 0 - field/frame pic  */
359     UWORD8 u1_profile_idc; /** profile value                        */
360     UWORD8 u1_level_idc; /** level value                          */
361     UWORD8 u1_direct_8x8_inference_flag;
362     UWORD8 u1_eoseq_pending;
363 } prev_seq_params_t;
364 
365 /** Picture level parameters */
366 typedef struct
367 {
368     dec_seq_params_t *ps_sps; /** applicable seq. parameter set */
369 
370     /* High profile related syntax elements */
371     WORD32 i4_transform_8x8_mode_flag;
372     WORD32 i4_pic_scaling_matrix_present_flag;
373     UWORD8 u1_pic_scaling_list_present_flag[8];
374     UWORD8 u1_pic_use_default_scaling_matrix_flag[8];
375     WORD16 i2_pic_scalinglist4x4[6][16];
376     WORD16 i2_pic_scalinglist8x8[2][64];
377     WORD8 i1_second_chroma_qp_index_offset;
378 
379     UWORD32 u4_slice_group_change_rate;
380     UWORD8 *pu1_slice_groupmb_map; /** MB map with slice membership labels */
381     UWORD8 u1_pic_parameter_set_id; /** id for the picture par set 0-255*/
382     UWORD8 u1_entropy_coding_mode; /** Entropy coding : 0-VLC; 1 - CABAC */
383     UWORD8 u1_num_slice_groups; /** Number of slice groups */
384     UWORD8 u1_pic_init_qp; /** Initial QPY for the picture {-26,25}*/
385     WORD8 i1_chroma_qp_index_offset; /** Chroma QP u4_ofst w.r.t QPY {-12,12} */
386     UWORD8 u1_dblk_filter_parms_flag; /** Slice layer has deblocking filter parameters */
387     UWORD8 u1_constrained_intra_pred_flag; /** Constrained intra prediction u4_flag */
388     UWORD8 u1_redundant_pic_cnt_present_flag; /** Redundant_pic_cnt is in slices using this PPS */
389     UWORD8 u1_pic_order_present_flag; /** Pic order present u4_flag */
390     UWORD8 u1_num_ref_idx_lx_active[2]; /** Maximum reference picture index in the reference list 0 : range [1 - 15] */
391     UWORD8 u1_wted_pred_flag;
392     UWORD8 u1_wted_bipred_idc;
393     UWORD8 u1_pic_init_qs;
394     UWORD8 u1_deblocking_filter_parameters_present_flag;
395     UWORD8 u1_vui_pic_parameters_flag;
396     UWORD8 u1_mb_slice_group_map_type;
397     UWORD8 u1_slice_group_change_direction_flag;
398     UWORD8 u1_frame_cropping_flag;
399     UWORD8 u1_frame_cropping_rect_left_ofst;
400     UWORD8 u1_frame_cropping_rect_right_ofst;
401     UWORD8 u1_frame_cropping_rect_top_ofst;
402     UWORD8 u1_frame_cropping_rect_bottom_ofst;
403     void * pv_codec_handle; /* For Error Handling */
404     WORD32 i4_top_field_order_cnt;
405     WORD32 i4_bottom_field_order_cnt;
406     WORD32 i4_avg_poc;
407     UWORD8 u1_is_valid; /** is Pic Param set valid */
408 } dec_pic_params_t;
409 
410 /** Picture Order Count Paramsters */
411 typedef struct
412 {
413     WORD32 i4_pic_order_cnt_lsb;
414     WORD32 i4_pic_order_cnt_msb;
415     WORD32 i4_delta_pic_order_cnt_bottom;
416     WORD32 i4_delta_pic_order_cnt[2];
417     WORD32 i4_prev_frame_num_ofst;
418     UWORD8 u1_mmco_equalto5;
419     UWORD8 u1_bot_field;
420     UWORD16 u2_frame_num;
421     WORD32 i4_top_field_order_count;
422     WORD32 i4_bottom_field_order_count;
423 } pocstruct_t;
424 
425 /*****************************************************************************/
426 /* parse_mb_pers_info contains necessary mb info data required persistently  */
427 /* in the form of top and left neighbours.                                   */
428 /*****************************************************************************/
429 typedef struct
430 {
431     void *u4_pic_addrress[4]; /* picture address for BS calc */
432     WORD8 pi1_intrapredmodes[4]; /* calc Intra pred modes */
433     UWORD8 pu1_nnz_y[4];
434     UWORD8 pu1_nnz_uv[4];
435     UWORD8 u1_mb_fld;
436     UWORD8 u1_mb_type;
437     UWORD16 u2_luma_csbp; /* Luma csbp used for BS calc */
438     UWORD8 u1_tran_form8x8;
439 } mb_neigbour_params_t;
440 
441 /* This info is required for decoding purposes except Deblockng */
442 typedef struct _DecMbInfo
443 {
444     UWORD8 u1_mb_type; /** macroblock type: I/P/B/SI/SP */
445     UWORD8 u1_chroma_pred_mode;
446     UWORD8 u1_cbp;
447     UWORD8 u1_mb_mc_mode; /** 16x16, 2 16x8, 2 8x16, 4 8x8 */
448     UWORD8 u1_topmb; /** top Mb u4_flag */
449     UWORD8 u1_mb_ngbr_availablity;
450     UWORD8 u1_end_of_slice;
451     UWORD8 u1_mb_field_decodingflag;
452     UWORD8 u1_topleft_mb_fld;
453     UWORD8 u1_topleft_mbtype;
454     WORD8 i1_offset;
455     UWORD8 u1_Mux;
456     UWORD8 u1_qp_div6;
457     UWORD8 u1_qp_rem6;
458     UWORD8 u1_qpc_div6;
459     UWORD8 u1_qpcr_div6;
460     UWORD8 u1_qpc_rem6;
461     UWORD8 u1_qpcr_rem6;
462     UWORD8 u1_tran_form8x8;
463     UWORD8 u1_num_pred_parts;
464     UWORD8 u1_yuv_dc_block_flag;
465     UWORD16 u2_top_right_avail_mask;
466     UWORD16 u2_top_left_avail_mask;
467     UWORD16 u2_luma_csbp; /** Coded 4x4 Sub Block Pattern */
468     UWORD16 u2_chroma_csbp; /** Coded 4x4 Sub Block Pattern */
469     UWORD16 u2_mbx;
470     UWORD16 u2_mby;
471     UWORD16 u2_mask[2];
472 
473     UWORD32 u4_pred_info_pkd_idx;
474 
475     mb_neigbour_params_t *ps_left_mb;
476     mb_neigbour_params_t *ps_top_mb;
477     mb_neigbour_params_t *ps_top_right_mb;
478     mb_neigbour_params_t *ps_curmb;
479 } dec_mb_info_t;
480 
481 
482 /** Slice level parameters */
483 typedef struct
484 {
485     dec_pic_params_t *ps_pps; /** PPS used */
486     WORD32 i4_delta_pic_order_cnt[2];
487     WORD32 i4_poc; /** Pic order cnt of picture to which slice belongs*/
488     UWORD32 u4_idr_pic_id; /** IDR pic ID */
489     UWORD16 u2_first_mb_in_slice; /** Address of first MB in slice*/
490     UWORD16 u2_frame_num; /** Frame number from prev IDR pic */
491 
492     UWORD8 u1_mbaff_frame_flag; /** Mb adaptive frame field u4_flag */
493     UWORD8 u1_field_pic_flag; /** Field picture or not */
494     UWORD8 u1_bottom_field_flag; /** If slice belongs to bot field pic */
495     UWORD8 u1_slice_type; /** I/P/B/SI/SP */
496     WORD32 i4_pic_order_cnt_lsb; /** Picture Order Count */
497     UWORD8 u1_slice_qp; /** Add slice_qp_delta to pic_init_QP */
498     UWORD8 u1_disable_dblk_filter_idc; /** 0-dblk all edges; 1 - suppress; 2 - suppress only edges */
499     WORD8 i1_slice_alpha_c0_offset; /** dblk: alpha and C0 table u4_ofst {-12,12}*/
500     WORD8 i1_slice_beta_offset; /** dblk: beta table u4_ofst {-12, 12}*/
501     UWORD8 u1_sp_for_switch_flag;
502     UWORD8 u1_no_output_of_prior_pics_flag;
503     UWORD8 u1_long_term_reference_flag;
504     UWORD8 u1_num_ref_idx_lx_active[2];
505     UWORD8 u1_cabac_init_idc; /** cabac_init_idc */
506     UWORD8 u1_num_ref_idx_active_override_flag;
507     UWORD8 u1_direct_spatial_mv_pred_flag;
508     WORD32 (*pf_decodeDirect)(struct _DecStruct *ps_dec,
509                               UWORD8 u1_wd_x,
510                               dec_mb_info_t *ps_cur_mb_info,
511                               UWORD8 u1_mb_num);
512     UWORD8 u1_redundant_pic_cnt;
513     WORD8 i1_slice_qs_delta;
514     UWORD8 u1_nal_ref_idc; /** NAL ref idc of the Slice NAL unit */
515     UWORD8 u1_nal_unit_type; /** NAL unit type of the Slice NAL */
516     UWORD8 u1_direct_8x8_inference_flag;
517     UWORD8 u1_mmco_equalto5; /** any of the MMCO command equal to 5 */
518     UWORD8 u1_pic_order_cnt_type;
519     pocstruct_t s_POC;
520     /* DataStructures required for weighted prediction */
521     UWORD16 u2_log2Y_crwd; /** Packed luma and chroma log2_weight_denom */
522     /* [list0/list1]:[ref pics index]:[0-Y 1-Cb 2-Cr] [weight/u4_ofst],
523      weights and offsets are signed numbers, since they are packed, it is defined
524      unsigned. LSB byte : weight and MSB byte: u4_ofst */
525     UWORD32 u4_wt_ofst_lx[2][MAX_REF_BUFS][3];
526     void * pv_codec_handle; /* For Error Handling */
527 
528     /*  This is used when reordering is done in Forward or    */
529     /*  backward lists. This is because reordering can point  */
530     /*  to any valid entry in initial list irrespective of    */
531     /*  num_ref_idx_active which could be overwritten using   */
532     /*  ref_idx_reorder_flag                                  */
533     UWORD8 u1_initial_list_size[2];
534     UWORD32 u4_mbs_in_slice;
535 } dec_slice_params_t;
536 
537 
538 typedef struct
539 {
540     UWORD8 u1_mb_type; /* Bit representations, X- reserved */
541     /** |Field/Frame|X|X|X|X|Bslice u4_flag|PRED_NON_16x16 u4_flag |Intra Mbflag| */
542     UWORD8 u1_mb_qp;
543     UWORD8 u1_deblocking_mode; /** dblk: Mode [ NO / NO TOP / NO LEFT] filter */
544     WORD8 i1_slice_alpha_c0_offset; /** dblk: alpha and C0 table u4_ofst {-12,12}*/
545     WORD8 i1_slice_beta_offset; /** dblk: beta table u4_ofst {-12, 12}*/
546     UWORD8 u1_single_call;
547     UWORD8 u1_topmb_qp;
548     UWORD8 u1_left_mb_qp;
549     UWORD32 u4_bs_table[10]; /* Boundary strength */
550 
551 } deblk_mb_t;
552 
553 typedef struct
554 {
555     UWORD8 u1_mb_type;
556     UWORD8 u1_mb_qp;
557 } deblkmb_neighbour_t;
558 
559 #define MAX_MV_RESIDUAL_INFO_PER_MB    32
560 #define MAX_REFIDX_INFO_PER_MB         4
561 #define PART_NOT_DIRECT                0
562 #define PART_DIRECT_8x8                1
563 #define PART_DIRECT_16x16              2
564 typedef struct
565 {
566     UWORD8 u1_is_direct;
567     UWORD8 u1_pred_mode;
568     UWORD8 u1_sub_mb_num;
569     UWORD8 u1_partheight;
570     UWORD8 u1_partwidth;
571 } parse_part_params_t;
572 
573 typedef struct
574 {
575     UWORD8 u1_isI_mb;
576     UWORD8 u1_num_part;
577     UWORD32 *pu4_wt_offst[MAX_REFIDX_INFO_PER_MB];
578     WORD8 i1_ref_idx[2][MAX_REFIDX_INFO_PER_MB];
579     UWORD8 u1_col_info[MAX_REFIDX_INFO_PER_MB];
580 } parse_pmbarams_t;
581 
582 typedef struct
583 {
584     UWORD8 *pu1_mb_y; /* pointer to N-Mb pad buffer Y (Horz)        */
585     UWORD8 *pu1_mb_u; /* pointer to N-Mb pad buffer U (Horz)        */
586     UWORD8 *pu1_mb_v; /* pointer to N-Mb pad buffer V (Horz)        */
587     UWORD8 *pu1_row_y; /* pointer to row pad buffer Y (Vert)         */
588     UWORD8 *pu1_row_u; /* pointer to row pad buffer U (Vert)         */
589     UWORD8 *pu1_row_v; /* pointer to row pad buffer V (Vert)         */
590     UWORD8 u1_vert_pad_top; /* flip-flop u4_flag remembering pad area (Vert) */
591     UWORD8 u1_vert_pad_bot; /* flip-flop u4_flag remembering pad area (Vert) */
592     UWORD8 u1_horz_pad; /* flip-flop u4_flag remembering pad area (Vert) */
593     UWORD8 u1_pad_len_y_v; /* vertical pad amount for luma               */
594     UWORD8 u1_pad_len_cr_v; /* vertical pad amount for chroma             */
595 } pad_mgr_t;
596 
597 typedef struct code_overlay_ctxt
598 {
599     UWORD8 u1_pb_slice_type;
600     UWORD8 u1_entropy_coding_type;
601     UWORD8 u1_mbaff_frame_flag;
602     UWORD8 u1_b_direct_flag;
603 } code_overlay_ctxt_t;
604 
605 #define ACCEPT_ALL_PICS   (0x00)
606 #define REJECT_CUR_PIC    (0x01)
607 #define REJECT_PB_PICS    (0x02)
608 
609 #define MASK_REJECT_CUR_PIC (0xFE)
610 #define MASK_REJECT_PB_PICS (0xFD)
611 
612 #define PIC_TYPE_UNKNOWN  (0xFF)
613 #define PIC_TYPE_I        (0x00)
614 #define SYNC_FRM_DEFAULT  (0xFFFFFFFF)
615 #define INIT_FRAME        (0xFFFFFF)
616 
617 typedef struct dec_err_status_t
618 {
619     UWORD8 u1_cur_pic_type;
620     UWORD8 u1_pic_aud_i;
621     UWORD8 u1_err_flag;
622     UWORD32 u4_frm_sei_sync;
623     UWORD32 u4_cur_frm;
624 } dec_err_status_t;
625 
626 /**************************************************************************/
627 /* Structure holds information about all high profile toolsets            */
628 /**************************************************************************/
629 typedef struct
630 {
631     /*****************************************/
632     /* variables required for scaling        */
633     /*****************************************/
634     UWORD8 u1_scaling_present;
635     WORD16 *pi2_scale_mat[8];
636 
637     /*************************************************/
638     /* scaling matrices for frame macroblocks after  */
639     /* inverse scanning                              */
640     /*************************************************/
641     WORD16 i2_scalinglist4x4[6][16];
642     WORD16 i2_scalinglist8x8[2][64];
643 
644 
645     /*****************************************/
646     /* variables required for transform8x8   */
647     /*****************************************/
648     UWORD8 u1_transform8x8_present;
649     UWORD8 u1_direct_8x8_inference_flag;
650     /* temporary variable to get noSubMbPartSizeLessThan8x8Flag from ih264d_parse_bmb_non_direct_cavlc */
651     UWORD8 u1_no_submb_part_size_lt8x8_flag;
652 
653     /* needed for inverse scanning */
654     cavlc_cntxt_t s_cavlc_ctxt;
655 
656     /* contexts for the CABAC related parsing */
657     bin_ctxt_model_t *ps_transform8x8_flag;
658     bin_ctxt_model_t *ps_sigcoeff_8x8_frame;
659     bin_ctxt_model_t *ps_last_sigcoeff_8x8_frame;
660     bin_ctxt_model_t *ps_coeff_abs_levelminus1;
661     bin_ctxt_model_t *ps_sigcoeff_8x8_field;
662     bin_ctxt_model_t *ps_last_sigcoeff_8x8_field;
663 
664 /* variables required for intra8x8 */
665 
666 /* variables required for handling different Qp for Cb and Cr */
667 
668 } high_profile_tools_t;
669 
670 typedef struct
671 {
672     UWORD32 u4_num_bufs; /* Number of buffers in each display frame. 2 for 420SP and 3 for 420P and so on */
673     void *buf[3]; /* Pointers to each of the components */
674     UWORD32 u4_bufsize[3];
675     UWORD32 u4_ofst[3];
676 } disp_buf_t;
677 typedef struct _dec_slice_struct
678 {
679     volatile UWORD32 u4_first_mb_in_slice;
680     volatile UWORD32 slice_type;
681     volatile UWORD16 u2_log2Y_crwd;
682     volatile void **ppv_map_ref_idx_to_poc;
683     volatile void *pv_tu_coeff_data_start;
684 } dec_slice_struct_t;
685 
686 /**
687  * Structure to hold coefficient info for a 4x4 transform
688  */
689 typedef struct
690 {
691     /**
692      * significant coefficient map
693      */
694     UWORD16 u2_sig_coeff_map;
695 
696     /**
697      * holds coefficients
698      */
699     WORD16  ai2_level[16];
700 }tu_sblk4x4_coeff_data_t;
701 
702 /**
703  * Structure to hold coefficient info for a 8x8 transform
704  */
705 typedef struct
706 {
707 
708     /**
709      * significant coefficient map
710      */
711     UWORD32 au4_sig_coeff_map[2];
712 
713     /**
714      * holds coefficients
715      */
716     WORD16  ai2_level[64];
717 }tu_blk8x8_coeff_data_t;
718 
719 /** Aggregating structure that is globally available */
720 typedef struct _DecStruct
721 {
722 
723     /* Add below all other static memory allocations and pointers to items
724      that are dynamically allocated once per session */
725     dec_bit_stream_t *ps_bitstrm;
726     dec_seq_params_t *ps_cur_sps;
727     dec_pic_params_t *ps_cur_pps;
728     dec_slice_params_t *ps_cur_slice;
729 
730     dec_pic_params_t *ps_pps;
731     dec_seq_params_t *ps_sps;
732     const UWORD16 *pu2_quant_scale_y;
733     const UWORD16 *pu2_quant_scale_u;
734     const UWORD16 *pu2_quant_scale_v;
735     UWORD16 u2_mbx;
736     UWORD16 u2_mby;
737 
738     UWORD16 u2_frm_wd_y; /** Width for luma buff */
739     UWORD16 u2_frm_ht_y; /** Height for luma buff */
740     UWORD16 u2_frm_wd_uv; /** Width for chroma buff */
741     UWORD16 u2_frm_ht_uv; /** Height for chroma buff */
742     UWORD16 u2_frm_wd_in_mbs; /** Frame width expressed in MB units */
743     UWORD16 u2_frm_ht_in_mbs; /** Frame height expressed in MB units */
744     WORD32 i4_submb_ofst; /** Offset in subMbs from the top left edge */
745     /* Pointer to colocated Zero frame Image, will be used in B_DIRECT mode */
746     /* colZeroFlag | // 0th bit
747      field_flag  | // 1st bit
748      XX          | // 2:3 bit don't cares
749      subMbMode   | // 4:5 bit
750      MbMode      | // 6:7 bit */
751 
752     UWORD8 *pu1_col_zero_flag;
753 
754     UWORD16 u2_pic_wd; /** Width of the picture being decoded */
755     UWORD16 u2_pic_ht; /** Height of the picture being decoded */
756 
757     UWORD8 u1_first_slice_in_stream;
758     UWORD8 u1_mb_ngbr_availablity;
759     UWORD8 u1_ref_idxl0_active_minus1;
760     UWORD8 u1_qp;
761     UWORD8 u1_qp_y_div6;
762     UWORD8 u1_qp_u_div6;
763     UWORD8 u1_qp_y_rem6;
764     UWORD8 u1_qp_u_rem6;
765 
766     /*********************************/
767     /* configurable mb-group numbers */
768     /* very critical to the decoder  */
769     /*********************************/
770     /************************************************************/
771     /* MB_GROUP should be a multiple of 2                       */
772     /************************************************************/
773     UWORD8 u1_recon_mb_grp;
774     UWORD8 u1_recon_mb_grp_pair;
775     /* Variables to handle Cabac */
776     decoding_envirnoment_t s_cab_dec_env; /* < Structure for decoding_envirnoment_t */
777     /* These things need to be updated at each MbLevel */
778     WORD8 i1_next_ctxt_idx; /* < next Ctxt Index */
779     UWORD8 u1_currB_type;
780     WORD8 i1_prev_mb_qp_delta; /* Prev MbQpDelta */
781     UWORD8 u1_nal_unit_type;
782 
783     ctxt_inc_mb_info_t *p_ctxt_inc_mb_map; /* Pointer to ctxt_inc_mb_info_t map */
784     ctxt_inc_mb_info_t *p_left_ctxt_mb_info; /* Pointer to left ctxt_inc_mb_info_t */
785     ctxt_inc_mb_info_t *p_top_ctxt_mb_info; /* Pointer to top ctxt_inc_mb_info_t */
786     ctxt_inc_mb_info_t *ps_curr_ctxt_mb_info; /* Pointer to current ctxt_inc_mb_info_t */
787     ctxt_inc_mb_info_t *ps_def_ctxt_mb_info; /* Pointer to default ctxt_inc_mb_info_t */
788 
789     /* mv contexts for mv decoding using cabac */
790     //UWORD8   u1_top_mv_ctxt_inc[4][4];
791     /* Dimensions for u1_left_mv_ctxt_inc_arr is [2][4][4] for Mbaff case */
792     UWORD8 u1_left_mv_ctxt_inc_arr[2][4][4];
793     UWORD8 (*pu1_left_mv_ctxt_inc)[4];
794 
795     UWORD8 u1_sub_mb_num;
796     UWORD8 u1_B; /** if B slice u1_B = 1 else 0 */
797     WORD16 i2_only_backwarddma_info_idx;
798     mv_pred_t *ps_mv; /** Pointer to the MV bank array */
799     mv_pred_t *ps_mv_bank_cur; /** Pointer to the MV bank array */
800     mv_pred_t s_default_mv_pred; /** Structure containing the default values
801      for MV predictor */
802 
803     pred_info_t *ps_pred; /** Stores info to cfg MC */
804     pred_info_t *ps_pred_start;
805 
806     UWORD32 u4_pred_info_idx;
807     pred_info_pkd_t *ps_pred_pkd;
808     pred_info_pkd_t *ps_pred_pkd_start;
809     UWORD32 u4_pred_info_pkd_idx;
810     UWORD8 *pu1_ref_buff; /** Destination buffer for DMAs */
811     UWORD32 u4_dma_buf_idx;
812 
813     UWORD8 *pu1_y;
814     UWORD8 *pu1_u;
815     UWORD8 *pu1_v;
816 
817     WORD16 *pi2_y_coeff;
818     UWORD8 *pu1_inv_scan;
819 
820     /**
821      * Pointer frame level TU subblock coeff data
822      */
823     void *pv_pic_tu_coeff_data;
824 
825     /**
826      * Pointer to TU subblock coeff data and number of subblocks and scan idx
827      * Incremented each time a coded subblock is processed
828      *
829      */
830     void *pv_parse_tu_coeff_data;
831     void *pv_prev_mb_parse_tu_coeff_data;
832 
833     void *pv_proc_tu_coeff_data;
834 
835     WORD16 *pi2_coeff_data;
836 
837     cavlc_cntxt_t s_cavlc_ctxt;
838 
839     UWORD32 u4_n_leftY[2];
840     UWORD32 u4_n_left_cr[2];
841     UWORD32 u4_n_left_temp_y;
842 
843     UWORD8 pu1_left_nnz_y[4];
844     UWORD8 pu1_left_nnz_uv[4];
845     UWORD32 u4_n_left_temp_uv;
846     /***************************************************************************/
847     /*          Base pointer to all the cabac contexts                         */
848     /***************************************************************************/
849     bin_ctxt_model_t *p_cabac_ctxt_table_t;
850 
851     /***************************************************************************/
852     /* cabac context pointers for every SE mapped into in p_cabac_ctxt_table_t */
853     /***************************************************************************/
854     bin_ctxt_model_t *p_mb_type_t;
855     bin_ctxt_model_t *p_mb_skip_flag_t;
856     bin_ctxt_model_t *p_sub_mb_type_t;
857     bin_ctxt_model_t *p_mvd_x_t;
858     bin_ctxt_model_t *p_mvd_y_t;
859     bin_ctxt_model_t *p_ref_idx_t;
860     bin_ctxt_model_t *p_mb_qp_delta_t;
861     bin_ctxt_model_t *p_intra_chroma_pred_mode_t;
862     bin_ctxt_model_t *p_prev_intra4x4_pred_mode_flag_t;
863     bin_ctxt_model_t *p_rem_intra4x4_pred_mode_t;
864     bin_ctxt_model_t *p_mb_field_dec_flag_t;
865     bin_ctxt_model_t *p_cbp_luma_t;
866     bin_ctxt_model_t *p_cbp_chroma_t;
867     bin_ctxt_model_t *p_cbf_t[NUM_CTX_CAT];
868     bin_ctxt_model_t *p_significant_coeff_flag_t[NUM_CTX_CAT];
869     bin_ctxt_model_t *p_coeff_abs_level_minus1_t[NUM_CTX_CAT];
870 
871     UWORD32 u4_num_pmbair; /** MB pair number */
872     mv_pred_t *ps_mv_left; /** Pointer to left motion vector bank */
873     mv_pred_t *ps_mv_top_left; /** Pointer to top left motion vector bank */
874     mv_pred_t *ps_mv_top_right; /** Pointer to top right motion vector bank */
875 
876     UWORD8 *pu1_left_yuv_dc_csbp;
877 
878     /* c64x_map.inc takes care of only this part
879      If you change/add any members above this,
880      modify c64x_map.inc accordingly */
881 
882     void **pp_ext_g_table_ptr;
883 
884     deblkmb_neighbour_t deblk_left_mb[2];
885     deblkmb_neighbour_t *ps_deblk_top_mb;
886     neighbouradd_t (*ps_left_mvpred_addr)[2]; /* Left MvPred Address Ping Pong*/
887 //  neighbouradd_t  *ps_topMvPredAdd;
888 
889     /***************************************************************************/
890     /*       Ref_idx contexts  are stored in the following way                 */
891     /*  Array Idx 0,1 for reference indices in Forward direction               */
892     /*  Array Idx 2,3 for reference indices in backward direction              */
893     /***************************************************************************/
894 
895     /* Dimensions for u1_left_ref_ctxt_inc_arr is [2][4] for Mbaff:Top and Bot */
896     WORD8 i1_left_ref_idx_ctx_inc_arr[2][4];
897     WORD8 *pi1_left_ref_idx_ctxt_inc;
898 
899     /*************************************************************************/
900     /*               Arrangnment of DC CSBP                                  */
901     /*        bits:  b7  b6  b5  b4  b3  b2  b1  b0                          */
902     /*        CSBP:   x   x   x   x   x  Vdc Udc Ydc                         */
903     /*************************************************************************/
904     /*************************************************************************/
905     /*  Points either to u1_yuv_dc_csbp_topmb or  u1_yuv_dc_csbp_bot_mb     */
906     /*************************************************************************/
907     UWORD8 u1_yuv_dc_csbp_topmb;
908     UWORD8 u1_yuv_dc_csbp_bot_mb;
909 
910     /* DMA SETUP */
911     tfr_ctxt_t s_tran_addrecon_parse;
912     tfr_ctxt_t s_tran_addrecon;
913     tfr_ctxt_t s_tran_iprecon;
914     tfr_ctxt_t *ps_frame_buf_ip_recon;
915     WORD8 i1_recon_in_thread3_flag;
916 
917     /* slice Header Simplification */
918     UWORD8 u1_pr_sl_type;
919     UWORD8 u1_sl_typ_5_9;
920     WORD32 i4_frametype;
921     UWORD32 u4_app_disp_width;
922     WORD32 i4_error_code;
923     UWORD8 u1_first_pb_nal_in_pic;
924     UWORD32 u4_bitoffset;
925 
926     /* Variables added to handle field pics */
927 
928     UWORD8 u1_second_field;
929     WORD32 i4_pic_type;
930     WORD32 i4_content_type;
931     WORD32 i4_decode_header;
932     WORD32 i4_header_decoded;
933     UWORD32 u4_total_frames_decoded;
934 
935     ctxt_inc_mb_info_t *ps_left_mb_ctxt_info; /* structure containing the left MB's
936      context info, incase of Mbaff */
937     pocstruct_t s_prev_pic_poc;
938     pocstruct_t s_cur_pic_poc;
939     WORD32 i4_cur_display_seq;
940     WORD32 i4_prev_max_display_seq;
941     WORD32 i4_max_poc;
942     deblk_mb_t *ps_cur_deblk_mb;
943 
944     /* Pointers to local scratch buffers */
945     deblk_mb_t *ps_deblk_pic;
946 
947     /* Pointers to Picture Buffers (Given by BufAPI Lib) */
948     struct pic_buffer_t *ps_cur_pic; /** Pointer to Current picture buffer */
949 
950     /* Scratch Picture Buffers (Given by BufAPI Lib) */
951     struct pic_buffer_t s_cur_pic;
952 
953     /* Current Slice related information */
954     volatile UWORD16 u2_cur_slice_num;
955     volatile UWORD16 u2_cur_slice_num_dec_thread;
956 
957     /* Variables needed for Buffer API handling */
958     UWORD8 u1_nal_buf_id;
959     UWORD8 u1_pic_buf_id;
960     UWORD8 u1_pic_bufs;
961 
962     WORD16 *pi2_pred1; //[441];  /** Temp predictor buffer for MC */
963     /* Pointer to refernce Pic buffers list, 0:fwd, 1:bwd */
964     pic_buffer_t **ps_ref_pic_buf_lx[2];
965     /* refIdx to POC mapping */
966     void **ppv_map_ref_idx_to_poc;
967     UWORD32 *pu4_defI_wts_ofsts;
968     UWORD32 *pu4_wts_ofsts_mat;
969     UWORD32 *pu4_wt_ofsts;
970     UWORD32 *pu4_mbaff_wt_mat;
971     /* Function pointers to read Params common to CAVLC and CABAC */
972     WORD32 (*pf_parse_inter_mb)(struct _DecStruct * ps_dec,
973                                 dec_mb_info_t * ps_cur_mb_info,
974                                 UWORD8 u1_mb_num,
975                                 UWORD8 u1_num_mbsNby2);
976     WORD32 (*pf_mvpred_ref_tfr_nby2mb)(struct _DecStruct * ps_dec,
977                                      UWORD8 u1_num_mbs,
978                                      UWORD8 u1_num_mbsNby2);
979 
980     WORD32 (*pf_parse_inter_slice)(struct _DecStruct * ps_dec,
981                                    dec_slice_params_t * ps_slice,
982                                    UWORD16 u2_first_mb_in_slice);
983 
984     UWORD32 (*pf_get_mb_info)(struct _DecStruct * ps_dec,
985                               const UWORD16 u2_cur_mb_address,
986                               dec_mb_info_t * ps_cur_mb_info,
987                               UWORD32 u4_mbskip_run);
988 
989     /* Variables for Decode Buffer Management */
990     dpb_manager_t *ps_dpb_mgr;
991     dpb_commands_t *ps_dpb_cmds;
992 
993     /* Variables Required for N MB design */
994     dec_mb_info_t *ps_nmb_info;
995 
996     UWORD8 *pu1_y_intra_pred_line;
997     UWORD8 *pu1_u_intra_pred_line;
998     UWORD8 *pu1_v_intra_pred_line;
999 
1000     UWORD8 *pu1_cur_y_intra_pred_line;
1001     UWORD8 *pu1_cur_u_intra_pred_line;
1002     UWORD8 *pu1_cur_v_intra_pred_line;
1003 
1004     UWORD8 *pu1_cur_y_intra_pred_line_base;
1005     UWORD8 *pu1_cur_u_intra_pred_line_base;
1006     UWORD8 *pu1_cur_v_intra_pred_line_base;
1007 
1008     UWORD8 *pu1_prev_y_intra_pred_line;
1009     UWORD8 *pu1_prev_u_intra_pred_line;
1010     UWORD8 *pu1_prev_v_intra_pred_line;
1011 
1012     UWORD32 u4_intra_pred_line_ofst;
1013 
1014     /* Scratch ping reconstruction pointers for Y U V */
1015     UWORD8 *pu1_y_scratch[2];
1016     UWORD8 *pu1_u_scratch[2];
1017     UWORD8 *pu1_v_scratch[2];
1018     UWORD8 u1_yuv_scratch_idx;
1019     UWORD8 u1_not_wait_rec;
1020     UWORD8 u1_res_changed;
1021 
1022     UWORD8 *pu1_yleft; /** Left Y pointer, used for intra-pred */
1023     UWORD8 *pu1_uleft; /** Left U pointer, used for intra-pred */
1024     UWORD8 *pu1_vleft; /** Left V pointer, used for intra-pred */
1025     UWORD8 u1_y_topleft[2]; /** Left Y pointer, used for intra-pred */
1026     UWORD8 u1_u_topleft[2]; /** Left U pointer, used for intra-pred */
1027     UWORD8 u1_v_topleft[2]; /** Left V pointer, used for intra-pred */
1028 
1029     mv_pred_t *ps_mv_cur; /** pointer to current motion vector bank */
1030     mv_pred_t *ps_mv_top; /** pointer to top motion vector bank */
1031     mv_pred_t *ps_mv_top_right2;/** Pointer to top right motion vector bank */
1032     mv_pred_t *ps_mv_p[2]; /** Scratch ping motion vector bank */
1033     mv_pred_t *ps_mv_top_p[MV_SCRATCH_BUFS]; /** Scratch top pong motion vector bank */
1034     UWORD8 u1_mv_top_p;
1035 
1036     deblk_mb_t *ps_deblk_mbn;
1037     deblk_mb_t *ps_deblk_mbn_dec_thrd;/*pointer used by parsing when spearaet_parse is 1*/
1038     deblk_mb_t *ps_deblk_mbn_curr;
1039     deblk_mb_t *ps_deblk_mbn_prev;
1040 
1041     UWORD8 *pu1_temp_mc_buffer;
1042 
1043     struct _sei *ps_sei;
1044     UWORD8 u1_pic_struct_copy;
1045     /* Variables required for cropping */
1046     UWORD16 u2_disp_width;
1047     UWORD16 u2_disp_height;
1048     UWORD16 u2_crop_offset_y;
1049     UWORD16 u2_crop_offset_uv;
1050 
1051     /* Variable required to get presentation time stamp through application */
1052     UWORD32 u4_pts;
1053 
1054     /* Variables used for gaps in frame number */
1055     UWORD16 u2_prev_ref_frame_num;
1056     UWORD8 u1_vert_up_scale_flag;
1057     iv_mem_rec_t *ps_mem_tab;
1058 
1059     UWORD16 u2_wait_id;
1060 
1061     void *pi4_ctxt_save_register;
1062     void *pi4_ctxt_save_register_dec;
1063 
1064     UWORD8 u1_mb_idx;
1065     struct pic_buffer_t *ps_col_pic;
1066     void (*pf_parse_mvdirect)(struct _DecStruct*,
1067                            struct pic_buffer_t*,
1068                            directmv_t*,
1069                            UWORD8,
1070                            WORD32,
1071                            dec_mb_info_t *);
1072     void *pv_dec_out;
1073     void *pv_dec_in;
1074     void *pv_scratch_sps_pps; /*used temeporarily store sps/ spps while parsing*/
1075 
1076     /* state pointers to mb and partition information */
1077     parse_pmbarams_t *ps_parse_mb_data;
1078     parse_part_params_t *ps_parse_part_params;
1079 
1080     /* scratch pointers to mb and partition information */
1081     parse_part_params_t *ps_part;
1082 
1083     UWORD8 u1_max_dec_frame_buffering;
1084     pad_mgr_t s_pad_mgr;
1085     UWORD8 (*pf_mvpred)(struct _DecStruct *ps_dec,
1086                         struct _DecMbInfo *ps_cur_mb_info,
1087                         mv_pred_t *ps_mv_pred,
1088                         mv_pred_t *ps_mv_nmb,
1089                         mv_pred_t *ps_mv_ntop,
1090                         UWORD8 u1_sub_mb_num,
1091                         UWORD8 uc_mb_part_width,
1092                         UWORD8 uc_lxstart,
1093                         UWORD8 uc_lxend,
1094                         UWORD8 u1_mb_mc_mode);
1095     void (*pf_compute_bs)(struct _DecStruct * ps_dec,
1096                          struct _DecMbInfo * ps_cur_mb_info,
1097                          const UWORD16 u2_mbxn_mb);
1098     UWORD8 u1_init_dec_flag;
1099     prev_seq_params_t s_prev_seq_params;
1100     UWORD8 u1_cur_mb_fld_dec_flag; /* current Mb fld or Frm */
1101 
1102     code_overlay_ctxt_t s_code_overlay_ctxt;
1103     UWORD8 u1_code_overlay;
1104 
1105 //  WORD8 *pi1_cur_predmodes;
1106     WORD8 pi1_left_pred_mode[8];
1107     UWORD8 u1_topleft_mb_fld;
1108     UWORD8 u1_topleft_mbtype;
1109     UWORD8 u1_topleft_mb_fld_bot;
1110     UWORD8 u1_topleft_mbtype_bot;
1111     UWORD8 u1_deblk_mb_grp;
1112     WORD16 i2_prev_slice_mbx;
1113     WORD16 i2_prev_slice_mby;
1114     UWORD16 u2_top_left_mask;
1115     UWORD16 u2_top_right_mask;
1116     dec_err_status_t * ps_dec_err_status;
1117 
1118     UWORD32 *pu4_sos_signal;
1119     UWORD8 u1_mb_idx_mv;
1120     UWORD16 u2_mv_2mb[2];
1121     UWORD32 u4_ref_buf_size;
1122     UWORD32 u4_packet_cnt;
1123     /* to remember the i4_status & input parameters from the sample app */
1124     void *pv_dec_status; // itt_dec_status_t void pointer */
1125     void *pv_dec_params; // itt_dec_prms_t void pointer
1126     void *pv_app_ctxt;
1127     UWORD32 u4_skip_frm_mask;
1128     void *pv_fmt_con_ctxt;
1129     /* for the parallel format conversion */
1130     UWORD8 *pu1_frmt_conv_y[3];
1131     UWORD8 *pu1_frmt_conv_u[3];
1132     UWORD8 *pu1_frmt_conv_v[3];
1133     UWORD8 *pu1_deblk_scr;
1134     UWORD32 u4_deblk_scr_sz;
1135 
1136     /* variable for finding the no.of mbs decoded in the current picture */
1137     UWORD16 u2_total_mbs_coded;
1138     /* member added for supporting fragmented annex - B */
1139 //  frg_annex_read_t s_frag_annex_read;
1140     /* added for vui_t, sei support*/
1141     WORD32 i4_vui_frame_rate;
1142     /* To Store the value of ref_idx_active for previous slice */
1143     /* useful in error handling                                */
1144     UWORD8 u1_num_ref_idx_lx_active_prev;
1145     /* Flag added to come out of process call in annex-b if&if frame is decoded */
1146     /* presence of access unit delimters and pps and sps                        */
1147     UWORD8 u1_frame_decoded_flag;
1148 
1149     /* To keep track of whether the last picture was decoded or not */
1150     /* in case of skip mode set by the application                  */
1151     UWORD8 u1_last_pic_not_decoded;
1152     UWORD32 *pu4_return_remaining_bufs;
1153 
1154     /* Used for disabling deblocking of non-reference pictures */
1155     WORD32 i4_set_low_complexity_mode;
1156     WORD32 i4_disable_deblock;
1157 
1158     WORD32 e_dec_status;
1159     UWORD32 u4_num_fld_in_frm;
1160 
1161     /* Function pointer for 4x4 residual cavlc parsing based on total coeff */
1162     WORD32 (*pf_cavlc_4x4res_block[3])(UWORD32 u4_isdc,
1163                                     UWORD32 u4_total_coeff_trail_one, /**TotalCoefficients<<16+trailingones*/
1164                                     dec_bit_stream_t *ps_bitstrm);
1165 
1166     /* Function pointer array for interpolate functions in called from motion compensattion module */
1167     void (*p_mc_interpolate_x_y[16][3])(UWORD8*,
1168                                         UWORD8*,
1169                                         UWORD8*,
1170                                         UWORD8,
1171                                         UWORD16,
1172                                         UWORD16,
1173                                         UWORD8);
1174 
1175     /**************************************************************************/
1176     /* Function pointer for 4x4 totalcoeff, trlone and residual cavlc parsing */
1177     /* based on u4_n (neigbourinng nnz average)                               */
1178     /* These point to two functions depending on (u4_n > 7) and (u4_n <= 7)   */
1179     /**************************************************************************/
1180     WORD32 (*pf_cavlc_parse4x4coeff[2])(WORD16 *pi2_coeff_block,
1181                                         UWORD32 u4_isdc, /* is it a DC block */
1182                                         WORD32 u4_n,
1183                                         struct _DecStruct *ps_dec, /** Decoder Parameters */
1184                                         UWORD32 *pu4_total_coeff);
1185 
1186     /**************************************************************************/
1187     /* Function pointer for luma 8x8block cavlc parsing based on top and left */
1188     /* neigbour availability.                                                 */
1189     /**************************************************************************/
1190     WORD32 (*pf_cavlc_parse_8x8block[4])(WORD16 *pi2_coeff_block,
1191                                          UWORD32 u4_sub_block_strd,
1192                                          UWORD32 u4_isdc,
1193                                          struct _DecStruct *ps_dec,
1194                                          UWORD8 *pu1_top_nnz,
1195                                          UWORD8 *pu1_left_nnz,
1196                                          UWORD8 u1_tran_form8x8,
1197                                          UWORD8 u1_mb_field_decodingflag,
1198                                          UWORD32 *pu4_csbp);
1199 
1200     /**************************************************************************/
1201     /* Ping pong top and current rows of mb neigbour_params                   */
1202     /**************************************************************************/
1203     mb_neigbour_params_t *ps_nbr_mb_row;
1204     mb_neigbour_params_t *ps_cur_mb_row;
1205     mb_neigbour_params_t *ps_top_mb_row;
1206 
1207     /**************************************************************************/
1208     /* Function pointer for 16x16 and non16x16 Bs1 calculations depending on   */
1209     /* P and B slice.                                                          */
1210     /***************************************************************************/
1211     void (*pf_fill_bs1[2][2])(mv_pred_t *ps_cur_mv_pred,
1212                               mv_pred_t *ps_top_mv_pred,
1213                               void **ppv_map_ref_idx_to_poc,
1214                               UWORD32 *pu4_bs_table, /* pointer to the BsTable array */
1215                               mv_pred_t *ps_leftmost_mv_pred,
1216                               neighbouradd_t *ps_left_addr,
1217                               void **u4_pic_addrress,
1218                               WORD32 i4_ver_mvlimit);
1219 
1220     void (*pf_fill_bs_xtra_left_edge[2])(UWORD32 *pu4_bs, /* Base pointer of BS table */
1221                                          WORD32 u4_left_mb_t_csbp, /* left mbpair's top csbp   */
1222                                          WORD32 u4_left_mb_b_csbp, /* left mbpair's bottom csbp*/
1223                                          WORD32 u4_cur_mb_csbp, /* csbp of current mb */
1224                                          UWORD32 u4_cur_mb_bot /* is top or bottom mb */
1225 
1226                                          );
1227     /* Function pointer array for BP and MP functions for MC*/
1228     void (*p_motion_compensate)(struct _DecStruct * ps_dec,
1229                                dec_mb_info_t *ps_cur_mb_info);
1230 
1231 
1232     void (*p_mc_dec_thread)(struct _DecStruct * ps_dec, dec_mb_info_t *ps_cur_mb_info);
1233 
1234     /* Function pointer array for BP and MP functions for formMbPartInfo*/
1235 
1236     WORD32 (*p_form_mb_part_info)(pred_info_pkd_t *ps_pred_pkd,
1237                                 struct _DecStruct * ps_dec,
1238                                      UWORD16 u2_mb_x,
1239                                      UWORD16 u2_mb_y,
1240                                      WORD32 mb_index,
1241                                      dec_mb_info_t *ps_cur_mb_info);
1242 
1243     WORD32 (*p_form_mb_part_info_thread)(pred_info_pkd_t *ps_pred_pkd,
1244                                 struct _DecStruct * ps_dec,
1245                                      UWORD16 u2_mb_x,
1246                                      UWORD16 u2_mb_y,
1247                                      WORD32 mb_index,
1248                                      dec_mb_info_t *ps_cur_mb_info);
1249 
1250 
1251     /* Required for cabac mbaff bottom mb */
1252     UWORD32 u4_next_mb_skip;
1253 
1254     void (*p_DeblockPicture[2])(struct _DecStruct *);
1255 
1256     /* ! */
1257     UWORD32 u4_ts;
1258     UWORD8 u1_flushfrm;
1259 
1260     /* Output format sent by the application */
1261     UWORD8 u1_chroma_format;
1262     UWORD8 u1_pic_decode_done;
1263     UWORD8 u1_slice_header_done;
1264     UWORD32 u4_level_at_init;
1265     UWORD32 u4_width_at_init;
1266     UWORD32 u4_height_at_init;
1267     WORD32 init_done;
1268     WORD32 process_called;
1269 
1270     /******************************************/
1271     /* For the high profile related variables */
1272     /******************************************/
1273     high_profile_tools_t s_high_profile;
1274     /* CBCR */
1275     UWORD8 u1_qp_v_div6;
1276     UWORD8 u1_qp_v_rem6;
1277     /*
1278      * TO help solve the dangling field case.
1279      * Check for the previous frame number and the current frame number.
1280      */
1281     UWORD16 u2_prv_frame_num;
1282     UWORD8 u1_top_bottom_decoded;
1283     UWORD8 u1_dangling_field;
1284 
1285     /*
1286      * For Low Memory case
1287      */
1288     UWORD32 u4_num_ref_frames_at_init;
1289     UWORD32 u4_num_reorder_frames_at_init;
1290     UWORD32 u4_num_extra_disp_bufs_at_init;
1291     UWORD32 u4_num_disp_bufs_requested;
1292     WORD32 i4_display_delay;
1293     UWORD32 u4_slice_start_code_found;
1294 
1295     UWORD32 u4_nmb_deblk;
1296     UWORD32 u4_use_intrapred_line_copy;
1297     UWORD32 u4_num_mbs_prev_nmb;
1298     UWORD32 u4_num_mbs_cur_nmb;
1299     UWORD32 u4_app_deblk_disable_level;
1300     UWORD32 u4_app_disable_deblk_frm;
1301     WORD32 i4_app_skip_mode;
1302     WORD32 i4_mv_frac_mask;
1303 
1304     disp_buf_t disp_bufs[MAX_DISP_BUFS_NEW];
1305     UWORD32 u4_disp_buf_mapping[MAX_DISP_BUFS_NEW];
1306     UWORD32 u4_disp_buf_to_be_freed[MAX_DISP_BUFS_NEW];
1307     UWORD32 u4_share_disp_buf;
1308     UWORD32 u4_num_disp_bufs;
1309     UWORD32 u4_prev_nal_skipped;
1310     UWORD32 u4_return_to_app;
1311     WORD32 i4_dec_skip_mode;
1312 
1313     UWORD32 u4_bs_deblk_thread_created;
1314     volatile UWORD32 u4_start_recon_deblk;
1315     void *pv_bs_deblk_thread_handle;
1316 
1317     UWORD32 u4_cur_bs_mb_num;
1318     UWORD32 u4_bs_cur_slice_num_mbs;
1319     UWORD32 u4_cur_deblk_mb_num;
1320     volatile UWORD16 u2_cur_slice_num_bs;
1321 
1322     UWORD32 u4_deblk_mb_x;
1323     UWORD32 u4_deblk_mb_y;
1324 
1325 
1326 
1327     iv_yuv_buf_t s_disp_frame_info;
1328     UWORD32 u4_fmt_conv_num_rows;
1329     UWORD32 u4_fmt_conv_cur_row;
1330     ivd_out_bufdesc_t *ps_out_buffer;
1331     ivd_get_display_frame_op_t s_disp_op;
1332     UWORD32 u4_stop_threads;
1333     UWORD32 u4_output_present;
1334 
1335     volatile UWORD16 cur_dec_mb_num;
1336     volatile UWORD16 cur_recon_mb_num;
1337     volatile UWORD16 u2_cur_mb_addr;
1338     WORD16 i2_dec_thread_mb_y;
1339     WORD16 i2_recon_thread_mb_y;
1340 
1341     UWORD8 u1_separate_parse;
1342     UWORD32 u4_dec_thread_created;
1343     void *pv_dec_thread_handle;
1344     volatile UWORD8 *pu1_dec_mb_map;
1345     volatile UWORD8 *pu1_recon_mb_map;
1346     volatile UWORD16 *pu2_slice_num_map;
1347     dec_slice_struct_t *ps_dec_slice_buf;
1348     void *pv_map_ref_idx_to_poc_buf;
1349     dec_mb_info_t *ps_frm_mb_info;
1350     volatile dec_slice_struct_t * volatile ps_parse_cur_slice;
1351     volatile dec_slice_struct_t * volatile ps_decode_cur_slice;
1352     volatile dec_slice_struct_t * volatile ps_computebs_cur_slice;
1353     UWORD32 u4_cur_slice_decode_done;
1354     UWORD32 u4_extra_mem_used;
1355 
1356     /* 2 first slice not parsed , 1 :first slice parsed , 0 :first valid slice header parsed*/
1357     UWORD32 u4_first_slice_in_pic;
1358     UWORD32 u4_num_cores;
1359     IVD_ARCH_T e_processor_arch;
1360     IVD_SOC_T e_processor_soc;
1361 
1362     /**
1363      * Pictures that are are degraded
1364      * 0 : No degrade
1365      * 1 : Only on non-reference frames
1366      * 2 : Use interval specified by u4_nondegrade_interval
1367      * 3 : All non-key frames
1368      * 4 : All frames
1369      */
1370     WORD32 i4_degrade_pics;
1371 
1372     /**
1373      * Interval for pictures which are completely decoded without any degradation
1374      */
1375     WORD32 i4_nondegrade_interval;
1376 
1377     /**
1378      * bit position (lsb is zero): Type of degradation
1379      * 1 : Disable deblocking
1380      * 2 : Faster inter prediction filters
1381      * 3 : Fastest inter prediction filters
1382      */
1383     WORD32 i4_degrade_type;
1384 
1385     /** Degrade pic count, Used to maintain the interval between non-degraded pics
1386      *
1387      */
1388     WORD32 i4_degrade_pic_cnt;
1389 
1390     UWORD32 u4_pic_buf_got;
1391 
1392     /**
1393      * Col flag and mv pred buffer manager
1394      */
1395     void *pv_mv_buf_mgr;
1396 
1397     /**
1398      * Picture buffer manager
1399      */
1400     void *pv_pic_buf_mgr;
1401 
1402     /**
1403      * Display buffer manager
1404      */
1405     void *pv_disp_buf_mgr;
1406 
1407     void *apv_buf_id_pic_buf_map[MAX_DISP_BUFS_NEW];
1408 
1409     UWORD8 au1_pic_buf_id_mv_buf_id_map[MAX_DISP_BUFS_NEW];
1410 
1411     UWORD8 au1_pic_buf_ref_flag[MAX_DISP_BUFS_NEW];
1412 
1413     ih264_default_weighted_pred_ft *pf_default_weighted_pred_luma;
1414 
1415     ih264_default_weighted_pred_ft *pf_default_weighted_pred_chroma;
1416 
1417     ih264_weighted_pred_ft *pf_weighted_pred_luma;
1418 
1419     ih264_weighted_pred_ft *pf_weighted_pred_chroma;
1420 
1421     ih264_weighted_bi_pred_ft *pf_weighted_bi_pred_luma;
1422 
1423     ih264_weighted_bi_pred_ft *pf_weighted_bi_pred_chroma;
1424 
1425     ih264_pad *pf_pad_top;
1426     ih264_pad *pf_pad_bottom;
1427     ih264_pad *pf_pad_left_luma;
1428     ih264_pad *pf_pad_left_chroma;
1429     ih264_pad *pf_pad_right_luma;
1430     ih264_pad *pf_pad_right_chroma;
1431 
1432     ih264_inter_pred_chroma_ft *pf_inter_pred_chroma;
1433 
1434     ih264_inter_pred_luma_ft *apf_inter_pred_luma[16];
1435 
1436     ih264_intra_pred_luma_ft *apf_intra_pred_luma_16x16[4];
1437 
1438     ih264_intra_pred_luma_ft *apf_intra_pred_luma_8x8[9];
1439 
1440     ih264_intra_pred_luma_ft *apf_intra_pred_luma_4x4[9];
1441 
1442     ih264_intra_pred_ref_filtering_ft *pf_intra_pred_ref_filtering;
1443 
1444     ih264_intra_pred_chroma_ft *apf_intra_pred_chroma[4];
1445 
1446     ih264_iquant_itrans_recon_ft *pf_iquant_itrans_recon_luma_4x4;
1447 
1448     ih264_iquant_itrans_recon_ft *pf_iquant_itrans_recon_luma_4x4_dc;
1449 
1450     ih264_iquant_itrans_recon_ft *pf_iquant_itrans_recon_luma_8x8;
1451 
1452     ih264_iquant_itrans_recon_ft *pf_iquant_itrans_recon_luma_8x8_dc;
1453 
1454     ih264_iquant_itrans_recon_chroma_ft *pf_iquant_itrans_recon_chroma_4x4;
1455 
1456     ih264_iquant_itrans_recon_chroma_ft *pf_iquant_itrans_recon_chroma_4x4_dc;
1457 
1458     ih264_ihadamard_scaling_ft *pf_ihadamard_scaling_4x4;
1459 
1460     /**
1461      * deblock vertical luma edge with blocking strength 4
1462      */
1463     ih264_deblk_edge_bs4_ft *pf_deblk_luma_vert_bs4;
1464 
1465     /**
1466      * deblock vertical luma edge with blocking strength less than 4
1467      */
1468     ih264_deblk_edge_bslt4_ft *pf_deblk_luma_vert_bslt4;
1469 
1470     /**
1471      * deblock vertical luma edge with blocking strength 4 for mbaff
1472      */
1473     ih264_deblk_edge_bs4_ft *pf_deblk_luma_vert_bs4_mbaff;
1474 
1475     /**
1476      * deblock vertical luma edge with blocking strength less than 4 for mbaff
1477      */
1478     ih264_deblk_edge_bslt4_ft *pf_deblk_luma_vert_bslt4_mbaff;
1479 
1480     /**
1481      * deblock vertical chroma edge with blocking strength 4
1482      */
1483     ih264_deblk_chroma_edge_bs4_ft *pf_deblk_chroma_vert_bs4;
1484 
1485     /**
1486      * deblock vertical chroma edge with blocking strength less than 4
1487      */
1488     ih264_deblk_chroma_edge_bslt4_ft *pf_deblk_chroma_vert_bslt4;
1489 
1490     /**
1491      * deblock vertical chroma edge with blocking strength 4 for mbaff
1492      */
1493     ih264_deblk_chroma_edge_bs4_ft *pf_deblk_chroma_vert_bs4_mbaff;
1494 
1495     /**
1496      * deblock vertical chroma edge with blocking strength less than 4 for mbaff
1497      */
1498     ih264_deblk_chroma_edge_bslt4_ft *pf_deblk_chroma_vert_bslt4_mbaff;
1499 
1500     /**
1501      * deblock horizontal luma edge with blocking strength 4
1502      */
1503     ih264_deblk_edge_bs4_ft *pf_deblk_luma_horz_bs4;
1504 
1505     /**
1506      * deblock horizontal luma edge with blocking strength less than 4
1507      */
1508     ih264_deblk_edge_bslt4_ft *pf_deblk_luma_horz_bslt4;
1509 
1510     /**
1511      * deblock horizontal chroma edge with blocking strength 4
1512      */
1513     ih264_deblk_chroma_edge_bs4_ft *pf_deblk_chroma_horz_bs4;
1514 
1515     /**
1516      * deblock horizontal chroma edge with blocking strength less than 4
1517      */
1518     ih264_deblk_chroma_edge_bslt4_ft *pf_deblk_chroma_horz_bslt4;
1519 
1520 
1521 } dec_struct_t;
1522 
1523 #endif /* _H264_DEC_STRUCTS_H */
1524