Home | History | Annotate | Download | only in decoder
      1 /******************************************************************************
      2 *
      3 * Copyright (C) 2012 Ittiam Systems Pvt Ltd, Bangalore
      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 
     19 /**
     20  *******************************************************************************
     21  * @file
     22  *  ihevcd_structs.h
     23  *
     24  * @brief
     25  *  Structure definitions used in the decoder
     26  *
     27  * @author
     28  *  Harish
     29  *
     30  * @par List of Functions:
     31  *
     32  * @remarks
     33  *  None
     34  *
     35  *******************************************************************************
     36  */
     37 
     38 #ifndef _IHEVCD_STRUCTS_H_
     39 #define _IHEVCD_STRUCTS_H_
     40 typedef enum
     41 {
     42     INIT_DONE, HEADER_DONE, FIRST_FRAME_DONE,
     43 }CODEC_STATE_T;
     44 
     45 
     46 
     47 typedef struct _codec_t codec_t;
     48 
     49 /** Structure to hold format conversion context */
     50 typedef struct
     51 {
     52     /** Current row for which format conversion should be done */
     53     WORD32 i4_cur_row;
     54 
     55     /** Number of rows for which format conversion should be done */
     56     WORD32 i4_num_rows;
     57 }fmt_conv_t;
     58 
     59 /**
     60  * Bitstream structure
     61  */
     62 typedef struct
     63 {
     64     /**
     65      * Bitstream buffer base pointer
     66      */
     67     UWORD8 *pu1_buf_base;
     68 
     69     /**
     70      * Bitstream bit offset in current word. Value between 0 and 31
     71      */
     72     UWORD32 u4_bit_ofst;
     73 
     74     /**
     75      * Current bitstream buffer pointer
     76      */
     77     UWORD32 *pu4_buf;
     78 
     79     /**
     80      * Current word
     81      */
     82     UWORD32 u4_cur_word;
     83 
     84     /**
     85      * Next word
     86      */
     87     UWORD32 u4_nxt_word;
     88 
     89     /**
     90      * Max address for bitstream
     91      */
     92     UWORD8 *pu1_buf_max;
     93 }bitstrm_t;
     94 
     95 /**
     96 ******************************************************************************
     97  *  @brief      Cabac context for decoder
     98 ******************************************************************************
     99  */
    100 typedef struct cab_ctxt
    101 {
    102     /*********************************************************************/
    103     /*  CABAC ENGINE related fields                                      */
    104     /*********************************************************************/
    105     /** cabac interval range  R */
    106     UWORD32  u4_range;
    107 
    108     /** cabac interval offset O  */
    109     UWORD32  u4_ofst;
    110 
    111     /*********************************************************************/
    112     /*  CABAC context models                                             */
    113     /*********************************************************************/
    114     /** All Context models stored in pscked form pState[bits6-1] | MPS[bit0] */
    115     UWORD8  au1_ctxt_models[IHEVC_CAB_CTXT_END];
    116 
    117     /** Context models memorized after decoding 2nd CTB in a row to be used
    118      * during entropy sync cases
    119      */
    120     UWORD8 au1_ctxt_models_sync[IHEVC_CAB_CTXT_END];
    121 
    122 }cab_ctxt_t;
    123 
    124 typedef enum
    125 {
    126     CMD_PROCESS,
    127     CMD_FMTCONV,
    128 }JOBQ_CMD_T;
    129 
    130 /**
    131  * Structure to represent a processing job entry
    132  */
    133 typedef struct
    134 {
    135     /**
    136      * Command
    137      * Currently: PROCESS, FMTCONV are the only two jobs
    138      */
    139     WORD32 i4_cmd;
    140     /**
    141      * CTB x of the starting CTB
    142      */
    143     WORD16 i2_ctb_x;
    144 
    145     /**
    146      * CTB y of the starting CTB
    147      */
    148 
    149     WORD16 i2_ctb_y;
    150 
    151     /**
    152      * Number of CTBs that need to be processed in this job
    153      */
    154     WORD16 i2_ctb_cnt;
    155 
    156     /**
    157      *  Slice index for the current CTB
    158      */
    159     WORD16 i2_slice_idx;
    160 
    161     /**
    162      * TU coefficient data offset for the current job
    163      */
    164     WORD32 i4_tu_coeff_data_ofst;
    165 }proc_job_t;
    166 /**
    167  * Structure to represent a MV Bank buffer
    168  */
    169 typedef struct
    170 {
    171     /**
    172      *  Pointer to hold PU index for each CTB in a picture
    173      */
    174     UWORD32 *pu4_pic_pu_idx;
    175 
    176     /**
    177      * Pointer to hold pu_t for each PU in a picture
    178      */
    179     pu_t *ps_pic_pu;
    180 
    181     /**
    182      * Pointer to hold PU map for each CTB in a picture
    183      */
    184     UWORD8 *pu1_pic_pu_map;
    185 
    186     /**
    187      * Pointer to hold the Slice map
    188      */
    189     UWORD16 *pu1_pic_slice_map;
    190 
    191     /**
    192      * Absolute POC for the current MV Bank
    193      */
    194     WORD32 i4_abs_poc;
    195 
    196     /**
    197      * Absolute POCs of reference List 0 for all slices in the frame from which this frame is reconstructed
    198      */
    199     WORD32 ai4_l0_collocated_poc[MAX_SLICE_HDR_CNT][MAX_DPB_SIZE];
    200 
    201     /**
    202      * Flag to indicate Long Term reference for POCs of reference List 0 for all slices in the frame from which this frame is reconstructed
    203      */
    204     WORD8 ai1_l0_collocated_poc_lt[MAX_SLICE_HDR_CNT][MAX_DPB_SIZE];
    205 
    206     /**
    207      * Absolute POCs of reference List 1 for all slices in the frame from which this frame is reconstructed
    208      */
    209     WORD32 ai4_l1_collocated_poc[MAX_SLICE_HDR_CNT][MAX_DPB_SIZE];
    210     /**
    211      * Flag to indicate Long Term reference for POCs of reference List 1 for all slices in the frame from which this frame is reconstructed
    212      */
    213     WORD8 ai1_l1_collocated_poc_lt[MAX_SLICE_HDR_CNT][MAX_DPB_SIZE];
    214 
    215 }mv_buf_t;
    216 
    217 typedef struct
    218 {
    219     /**
    220      * Pointer to current PPS
    221      */
    222     pps_t *ps_pps;
    223 
    224     /**
    225      * Pointer to current SPS
    226      */
    227     sps_t *ps_sps;
    228 
    229     /**
    230      * Pointer to current slice header structure
    231      */
    232     slice_header_t *ps_slice_hdr;
    233 
    234     /**
    235      * CTB's x position within a picture in raster scan in CTB units
    236      */
    237     WORD32 i4_ctb_x;
    238 
    239     /**
    240      * CTB's y position within a picture in raster scan in CTB units
    241      */
    242 
    243     WORD32 i4_ctb_y;
    244 
    245     /**
    246      * Current PU structure - set to CTB pu_t pointer at the start of CTB processing and incremented
    247      * for every TU
    248      */
    249     pu_t *ps_pu;
    250 
    251     /**
    252      * Pointer to frame level pu_t for the current frame being parsed
    253      * where MVs and Intra pred modes will be updated
    254      */
    255     pu_t *ps_pic_pu;
    256 
    257     /**
    258      * Store the current tile's information. This is needed for the computation of mvs.
    259      */
    260     tile_t *ps_tile;
    261 
    262     /**
    263      * Points to an array of PU indices which is used to identify
    264      * start index of pu_t in ps_pic_pu and also to identify number of
    265      * PUs in the current CTB by subtracting current idx from next CTB's
    266      * PU idx
    267      */
    268     UWORD32 *pu4_pic_pu_idx;
    269 
    270     /** PU Index map per CTB. The indices in this map are w.r.t picture pu array and not
    271      * w.r.t CTB pu array.
    272      * This will be used during mv prediction and since neighbours will have different CTB pu map
    273      * it will be easier if they all have indices w.r.t picture level PU array rather than CTB level
    274      * PU array.
    275      * pu1_pic_pu_map is map w.r.t CTB's pu_t array
    276      */
    277     UWORD32 *pu4_pic_pu_idx_map;
    278 
    279     /**
    280       * Pointer to pu_map for the current frame being parsed
    281       * where MVs and Intra pred modes will be updated
    282       */
    283     UWORD8 *pu1_pic_pu_map;
    284 
    285     /**
    286      *  PU count in current CTB
    287      */
    288     WORD32 i4_ctb_pu_cnt;
    289 
    290     /**
    291      *  PU count in current CTB
    292      */
    293     WORD32 i4_ctb_start_pu_idx;
    294 
    295     /**
    296      *  Top availability for current CTB level
    297      */
    298     UWORD8 u1_top_ctb_avail;
    299 
    300     /**
    301      *  Top right availability for current CTB level
    302      */
    303     UWORD8 u1_top_rt_ctb_avail;
    304     /**
    305      *  Top left availability for current CTB level
    306      */
    307     UWORD8 u1_top_lt_ctb_avail;
    308     /**
    309      *  left availability for current CTB level
    310      */
    311     UWORD8 u1_left_ctb_avail;
    312 
    313 }mv_ctxt_t;
    314 
    315 typedef struct
    316 {
    317     /**
    318      * Pointer to current PPS
    319      */
    320     pps_t *ps_pps;
    321 
    322     /**
    323      * Pointer to current SPS
    324      */
    325     sps_t *ps_sps;
    326 
    327     /*
    328      * Pointer to codec context
    329      */
    330     codec_t *ps_codec;
    331 
    332     /**
    333      * Index of the current Tile being parsed
    334      */
    335     tile_t *ps_tile;
    336 
    337     /**
    338      * Pointer to the current slice header
    339      */
    340     slice_header_t *ps_slice_hdr;
    341 
    342     /**
    343      *  TU count in current CTB
    344      */
    345     WORD32 i4_ctb_tu_cnt;
    346 
    347     /**
    348      * CTB's x position within a picture in raster scan in CTB units
    349      */
    350     WORD32 i4_ctb_x;
    351 
    352     /**
    353      * CTB's y position within a picture in raster scan in CTB units
    354      */
    355 
    356     WORD32 i4_ctb_y;
    357 
    358     /**
    359      * CTB's x position within a Tile in raster scan in CTB units
    360      */
    361     WORD32 i4_ctb_tile_x;
    362 
    363     /**
    364      * CTB's y position within a Tile in raster scan in CTB units
    365      */
    366 
    367     WORD32 i4_ctb_tile_y;
    368 
    369     /**
    370      * CTB's x position within a Slice in raster scan in CTB units
    371      */
    372     WORD32 i4_ctb_slice_x;
    373 
    374     /**
    375      * CTB's y position within a Slice in raster scan in CTB units
    376      */
    377 
    378     WORD32 i4_ctb_slice_y;
    379 
    380     /* Two bits per edge.
    381     Stored in format. BS[15] | BS[14] | .. |BS[0]*/
    382     UWORD32 *pu4_pic_vert_bs;
    383 
    384     /**
    385      * Horizontal Boundary strength
    386      */
    387 
    388     /* Two bits per edge.
    389     Stored in format. BS[15] | BS[14] | .. |BS[0]*/
    390     UWORD32 *pu4_pic_horz_bs;
    391 
    392     /**
    393      * Flags to indicate if QP is constant through out a CTB - 1 bit for each CTB
    394      * The bits are packed from LSB to MSB
    395      * To get the flag corresponding to CTB with (ctb_x, ctb_y), use
    396      *      pu4_qp_const_in_ctb[(ctb_x + pic_wd_in_ctb * ctb_y) >> 3] & (1 << ((ctb_x + pic_wd_in_ctb * ctb_y) & 7))
    397      */
    398     UWORD8 *pu1_pic_qp_const_in_ctb;
    399 
    400     /**
    401      *  Qp array stored for each 8x8 pixels
    402      */
    403     UWORD8  *pu1_pic_qp;
    404 
    405     /**
    406      * Current TU structure - set to CTB tu_t pointer at the start of CTB processing and incremented
    407      * for every TU
    408      */
    409     tu_t *ps_tu;
    410 
    411     /**
    412      * Points to an array of TU indices which is used to identify
    413      * start index of tu_t in ps_pic_tu and also to identify number of
    414      * TUs in the current CTB by subtracting current idx from next CTB's
    415      * TU idx
    416      */
    417     UWORD32 *pu4_pic_tu_idx;
    418 
    419     /**
    420      * Points to an array of PU indices which is used to identify
    421      * start index of pu_t in ps_pic_pu and also to identify number of
    422      * PUs in the current CTB by subtracting current idx from next CTB's
    423      * PU idx
    424      */
    425     UWORD32 *pu4_pic_pu_idx;
    426 
    427     /**
    428      * Current PU structure - set to CTB pu_t pointer at the start of CTB processing and incremented
    429      * for every TU
    430      */
    431     pu_t *ps_pu;
    432 
    433     /**
    434      * Pointer to frame level pu_t for the current frame being parsed
    435      * where MVs and Intra pred modes will be updated
    436      */
    437     pu_t *ps_pic_pu;
    438 
    439     /** PU Index map per CTB. The indices in this map are w.r.t picture pu array and not
    440      * w.r.t CTB pu array.
    441      * This will be used during mv prediction and since neighbours will have different CTB pu map
    442      * it will be easier if they all have indices w.r.t picture level PU array rather than CTB level
    443      * PU array.
    444      * pu1_pic_pu_map is map w.r.t CTB's pu_t array
    445      */
    446     UWORD32 *pu4_pic_pu_idx_map;
    447 
    448     /**
    449      * Variable to store the next ctb count to compute pu idx
    450      */
    451     WORD32 i4_next_pu_ctb_cnt;
    452 
    453     /**
    454      * Variable to store the next ctb count to compute tu idx
    455      */
    456     WORD32 i4_next_tu_ctb_cnt;
    457     /**
    458      * Points to the array of slice indices which is used to identify the slice
    459      *  to which each CTB in a frame belongs.
    460      */
    461     UWORD16 *pu1_slice_idx;
    462 }bs_ctxt_t;
    463 
    464 typedef struct
    465 {
    466     /**
    467      * Pointer to current PPS
    468      */
    469     pps_t *ps_pps;
    470 
    471     /**
    472      * Pointer to current SPS
    473      */
    474     sps_t *ps_sps;
    475 
    476     /*
    477      * Pointer to codec context
    478      */
    479     codec_t *ps_codec;
    480 
    481     /**
    482      * Pointer to current slice header structure
    483      */
    484     slice_header_t *ps_slice_hdr;
    485 
    486     /**
    487      * Pointer to the structure that contains BS and QP frame level arrays
    488      */
    489     bs_ctxt_t s_bs_ctxt;
    490 
    491     /**
    492      * CTB's x position within a picture in raster scan in CTB units
    493      */
    494     WORD32 i4_ctb_x;
    495 
    496     /**
    497      * CTB's y position within a picture in raster scan in CTB units
    498      */
    499 
    500     WORD32 i4_ctb_y;
    501 
    502     /**
    503      * Current pictures loop filter flag map at 8x8 level
    504      */
    505     UWORD8 *pu1_pic_no_loop_filter_flag;
    506 
    507     /**
    508      * Current CTB's no_loop_filter_flags
    509      * each element corresponds to one row - including the left CTB's last 8x8
    510      */
    511     UWORD16 au2_ctb_no_loop_filter_flag[9];
    512 
    513     /*
    514      * Pointer to 0th luma pixel in current pic
    515      */
    516     UWORD8 *pu1_cur_pic_luma;
    517 
    518     /*
    519      * Pointer to 0th chroma pixel in current pic
    520      */
    521     UWORD8 *pu1_cur_pic_chroma;
    522 
    523     /* Points to the array of slice indices which is used to identify the slice
    524     *  to which each CTB in a frame belongs.
    525     */
    526     UWORD16 *pu1_slice_idx;
    527 
    528     /* Specifies if the chroma format is yuv420sp_vu */
    529     WORD32 is_chroma_yuv420sp_vu;
    530 
    531 }deblk_ctxt_t;
    532 
    533 typedef struct
    534 {
    535     /**
    536      * Pointer to current PPS
    537      */
    538     pps_t *ps_pps;
    539 
    540     /**
    541      * Pointer to current SPS
    542      */
    543     sps_t *ps_sps;
    544 
    545     /* Pointer to codec context
    546      *
    547      */
    548     codec_t *ps_codec;
    549 
    550     /**
    551      * Pointer to base slice header structure
    552      */
    553     slice_header_t *ps_slice_hdr_base;
    554 
    555     /**
    556      * Pointer to current slice header structure
    557      */
    558     slice_header_t *ps_slice_hdr;
    559 
    560     /**
    561      * Pointer to current tile structure
    562      */
    563     tile_t *ps_tile;
    564     /**
    565      * CTB's x position within a picture in raster scan in CTB units
    566      */
    567     WORD32 i4_ctb_x;
    568 
    569     /**
    570      * CTB's y position within a picture in raster scan in CTB units
    571      */
    572 
    573     WORD32 i4_ctb_y;
    574 
    575     /**
    576      * Current pictures loop filter flag map at 8x8 level
    577      */
    578     UWORD8 *pu1_pic_no_loop_filter_flag;
    579 
    580     /*
    581      * Pointer to 0th luma pixel in current pic
    582      */
    583     UWORD8 *pu1_cur_pic_luma;
    584 
    585     /*
    586      * Pointer to 0th chroma pixel in current pic
    587      */
    588     UWORD8 *pu1_cur_pic_chroma;
    589 
    590     /**
    591      * Pointer to frame level sao_t for the current frame being parsed
    592      */
    593     sao_t *ps_pic_sao;
    594 
    595     /**
    596      * Temporary buffer needed during SAO processing
    597      */
    598     UWORD8 *pu1_tmp_buf_luma;
    599 
    600     /**
    601      * Temporary buffer needed during SAO processing
    602      */
    603     UWORD8 *pu1_tmp_buf_chroma;
    604 
    605     /**
    606      * Left column of luma pixels - used by SAO
    607      */
    608     UWORD8 *pu1_sao_src_left_luma;
    609 
    610     /**
    611      * Top row of luma pixels - used by SAO
    612      */
    613     UWORD8 *pu1_sao_src_top_luma;
    614 
    615     /**
    616      * Left column of chroma pixels(interleaved) - used by SAO
    617      */
    618     UWORD8 *pu1_sao_src_left_chroma;
    619 
    620     /**
    621      * Top row of chroma pixels(interleaved) - used by SAO
    622      */
    623     UWORD8 *pu1_sao_src_top_chroma;
    624 
    625     /**
    626      * Top-left luma pixel - used by SAO (for the top CTB row)
    627      */
    628     UWORD8 *pu1_sao_src_luma_top_left_ctb;
    629 
    630     /**
    631      * Top-left chroma pixel(interleaved) - used by SAO (for the top CTB row)
    632      */
    633     UWORD8 *pu1_sao_src_chroma_top_left_ctb;
    634 
    635     /**
    636      * Top-left luma pixel - used by SAO (for the current  CTB row)
    637      */
    638     UWORD8 *pu1_sao_src_top_left_luma_curr_ctb;
    639 
    640     /**
    641      * Top-left chroma pixel(interleaved) - used by SAO (for the current CTB row)
    642      */
    643     UWORD8 *pu1_sao_src_top_left_chroma_curr_ctb;
    644 
    645     /**
    646      * Top-right luma pixel - used by SAO (for the top CTB row)
    647      */
    648     UWORD8 *pu1_sao_src_top_left_luma_top_right;
    649 
    650     /**
    651      * Top-right chroma pixel(interleaved) - used by SAO (for the top CTB row)
    652      */
    653     UWORD8 *pu1_sao_src_top_left_chroma_top_right;
    654 
    655     /**
    656      * Bottom-left luma pixel - used by SAO
    657      */
    658     UWORD8 u1_sao_src_top_left_luma_bot_left;
    659     /**
    660      *  Pointer to array that stores bottom left luma pixel per row(interleaved) - used by SAO
    661      */
    662     UWORD8 *pu1_sao_src_top_left_luma_bot_left;
    663 
    664     /**
    665      * Bottom left chroma pixel(interleaved) - used by SAO
    666      */
    667     UWORD8 au1_sao_src_top_left_chroma_bot_left[2];
    668     /**
    669      *  Pointer to array that stores bottom left chroma pixel per row(interleaved) - used by SAO
    670      */
    671     UWORD8 *pu1_sao_src_top_left_chroma_bot_left;
    672 
    673     /*
    674      * Slice counter in a picture.
    675      */
    676     UWORD32 i4_cur_slice_idx;
    677     /**
    678      * Points to the array of slice indices which is used to identify the slice
    679      *  to which each CTB in a frame belongs.
    680      */
    681     UWORD16 *pu1_slice_idx;
    682     /**
    683      * Points to the array of tile indices which is used to identify the slice
    684      *  to which each CTB in a frame belongs.
    685      */
    686     UWORD16 *pu1_tile_idx;
    687 
    688     /* Specifies if the chroma format is yuv420sp_vu */
    689     WORD32 is_chroma_yuv420sp_vu;
    690 
    691 }sao_ctxt_t;
    692 
    693 typedef struct
    694 {
    695     /** Log2 CU's size */
    696     WORD32 i4_log2_cb_size;
    697 
    698     /** CU's x position */
    699     WORD32 i4_pos_x;
    700 
    701     /** CU's y position */
    702     WORD32 i4_pos_y;
    703     /**
    704      * Transquant Bypass enable flag at CU level - To be replicated at TU level
    705      */
    706     WORD32 i4_cu_transquant_bypass;
    707     /**
    708      * Prediction mode
    709      */
    710     WORD32 i4_pred_mode;
    711 
    712     /**
    713      * Partition mode
    714      */
    715     WORD32 i4_part_mode;
    716 
    717     /**
    718      * Intra luma pred mode for current CU. In case of PART2Nx2N
    719      * the first value is replicated to avoid checks later
    720      */
    721     WORD32 ai4_intra_luma_pred_mode[4];
    722 
    723     /**
    724      * Previous intra luma pred flag used for intra pred mode computation
    725      */
    726     WORD32 ai4_prev_intra_luma_pred_flag[4];
    727 
    728     /**
    729      * mpm index used in intra prediction mode computation
    730      */
    731     WORD32 ai4_mpm_idx[4];
    732     /**
    733      * Remaining intra pred mode
    734      */
    735     WORD32 ai4_rem_intra_luma_pred_mode[4];
    736     /**
    737      * Chroma pred mode index to be used to compute intra pred mode for chroma
    738      */
    739     WORD32 i4_intra_chroma_pred_mode_idx;
    740     /**
    741      * Maximum transform depth
    742      */
    743     WORD32 i4_max_trafo_depth;
    744 
    745     /**
    746      *  Luma CBF for current TU
    747      */
    748     UWORD8 i1_cbf_luma;
    749 
    750     /**
    751      * Cb CBF
    752      */
    753     UWORD8 ai1_cbf_cb[MAX_TRAFO_DEPTH];
    754 
    755     /**
    756      * Cr CBF
    757      */
    758     UWORD8 ai1_cbf_cr[MAX_TRAFO_DEPTH];
    759 
    760     /**
    761      * Intra split flag
    762      */
    763     WORD32 i4_intra_split_flag;
    764 
    765     /**
    766      * Current QP
    767      */
    768     WORD32 i4_qp;
    769 
    770     /**
    771      * Number of TUs in CU parsed before a change in QP is signaled
    772      */
    773     WORD32 i4_tu_cnt;
    774 
    775     /**
    776      * Cu QP delta
    777      */
    778     WORD32 i4_cu_qp_delta;
    779 
    780 }parse_cu_t;
    781 /**
    782  * Structure contains few common state variables such as CTB positions, current SPS, PPS ids etc which are to be
    783  * used in the parsing thread. By keeping it a different structure it is being explicitly signalled that these
    784  * variables are specific to Parsing threads context and other threads should not update these elements
    785  */
    786 typedef struct
    787 {
    788     /**
    789      * CTB's x position within a picture in raster scan in CTB units
    790      */
    791     WORD32 i4_ctb_x;
    792 
    793     /**
    794      * CTB's y position within a picture in raster scan in CTB units
    795      */
    796 
    797     WORD32 i4_ctb_y;
    798 
    799     /**
    800      * CTB's x position within a Tile in raster scan in CTB units
    801      */
    802     WORD32 i4_ctb_tile_x;
    803 
    804     /**
    805      * CTB's y position within a Tile in raster scan in CTB units
    806      */
    807 
    808     WORD32 i4_ctb_tile_y;
    809 
    810     /**
    811      * CTB's x position within a Slice in raster scan in CTB units
    812      */
    813     WORD32 i4_ctb_slice_x;
    814 
    815     /**
    816      * CTB's y position within a Slice in raster scan in CTB units
    817      */
    818 
    819     WORD32 i4_ctb_slice_y;
    820 
    821     /**
    822      * Index of the current Tile being parsed
    823      */
    824     tile_t *ps_tile;
    825 
    826     /**
    827      * Current slice idx - Used in multi-core cases to ensure slice header is
    828      * preserved till the last CB of the slice is decoded
    829      */
    830     WORD32 i4_cur_slice_idx;
    831     /**
    832      * Current slice idx - Used in multi-core cases to ensure slice header is
    833      * preserved till the last CB of the slice is decoded
    834      */
    835     WORD32 i4_cur_independent_slice_idx;
    836 
    837     /**
    838      * Current slice idx - Used in multi-core cases to ensure slice header is
    839      * preserved till the last CB of the slice is decoded
    840      */
    841     WORD32 i4_cur_tile_idx;
    842 
    843     /**
    844      * Pointer to current PPS
    845      */
    846     pps_t *ps_pps;
    847 
    848     /**
    849      * Pointer to current SPS
    850      */
    851     sps_t *ps_sps;
    852 
    853     /**
    854      * Signal that pic_init is called first time
    855      */
    856     WORD32 i4_first_pic_init;
    857 
    858     /**
    859      * Flag to indicate if CU QP delta is coded.
    860      * By default it is set to 0 at the beginning of coding quad tree
    861      */
    862     WORD32 i4_is_cu_qp_delta_coded;
    863 
    864     /**
    865      * CU Qp delta
    866      * By default it is set to 0 at the beginning of coding quad tree
    867      */
    868     WORD32 i4_cu_qp_delta;
    869 
    870     /**
    871      * Bitstream structure
    872      */
    873     bitstrm_t s_bitstrm;
    874 
    875     /**
    876      * Pointer frame level TU subblock coeff data
    877      */
    878     void *pv_pic_tu_coeff_data;
    879 
    880     /**
    881      * Pointer to TU subblock coeff data and number of coded subblocks and scan idx
    882      * Incremented each time a coded subblock is parsed
    883      *
    884      */
    885     void *pv_tu_coeff_data;
    886 
    887     /**
    888      * Current TU structure - set to CTB tu_t pointer at the start of CTB parsing and incremented
    889      * for every TU
    890      */
    891     tu_t *ps_tu;
    892 
    893     /**
    894      * Current ctb's TU map
    895      */
    896     UWORD8 *pu1_tu_map;
    897 
    898     /**
    899      * Current PU structure - set to CTB pu_t pointer at the start of CTB parsing and incremented
    900      * for every TU
    901      */
    902     pu_t *ps_pu;
    903 
    904     /**
    905      * Points to the array of slice indices which is used to identify the independent slice
    906      *  to which each CTB in a frame belongs.
    907      */
    908     UWORD16 *pu1_slice_idx;
    909 
    910     /**
    911      * Current PU index in a frame
    912      */
    913     WORD32 i4_pic_pu_idx;
    914 
    915     /**
    916      * Current TU index in a frame
    917      */
    918     WORD32 i4_pic_tu_idx;
    919 
    920     /**
    921      * Current PU structure - set to CTB pu_map pointer at the start of CTB parsing
    922      */
    923     UWORD8 *pu1_pu_map;
    924 
    925     /**
    926      * Current QP
    927      */
    928     WORD32 u4_qp;
    929 
    930     /**
    931      * Current Group's QP
    932      */
    933     WORD32 u4_qpg;
    934 
    935     /**
    936      * Number of PCM blocks in current CTB - Needed only during parsing
    937      * If needed during recon then move it to ctb_t
    938      */
    939     WORD32 i4_ctb_num_pcm_blks;
    940 
    941     /**
    942      * PCM flag for the current CU
    943      */
    944     WORD32 i4_cu_pcm_flag;
    945 
    946     /**
    947      * CU related information to be used to populate tu_t and pu_t during
    948      * pred unit and transform tree parsing.
    949      */
    950     parse_cu_t s_cu;
    951 
    952     /**
    953      * Pointer to pu_map for the current frame being parsed
    954      */
    955     UWORD8 *pu1_pic_pu_map;
    956 
    957     /**
    958      * Pointer to frame level pu_t for the current frame being parsed
    959      * where MVs and Intra pred modes will be updated
    960      */
    961     pu_t *ps_pic_pu;
    962 
    963     /**
    964      * Pointer to tu_map for the current frame being parsed
    965      */
    966     UWORD8 *pu1_pic_tu_map;
    967 
    968     /**
    969      * Pointer to frame level tu_t for the current frame being parsed
    970      * where transform unit related info will be updated
    971      */
    972     tu_t *ps_pic_tu;
    973 
    974     /**
    975      * Points to an array of TU indices which is used to identify
    976      * start index of tu_t in ps_pic_tu and also to identify number of
    977      * TUs in the current CTB by subtracting current idx from next CTB's
    978      * TU idx
    979      */
    980     UWORD32 *pu4_pic_tu_idx;
    981 
    982     /**
    983      * Points to an array of PU indices which is used to identify
    984      * start index of pu_t in ps_pic_pu and also to identify number of
    985      * PUs in the current CTB by subtracting current idx from next CTB's
    986      * PU idx
    987      */
    988     UWORD32 *pu4_pic_pu_idx;
    989 
    990 
    991     /**
    992      * Current pictures intra mode map at 8x8 level
    993      */
    994     UWORD8 *pu1_pic_intra_flag;
    995 
    996     /**
    997      * Current pictures loop filter flag map at 8x8 level
    998      */
    999     UWORD8 *pu1_pic_no_loop_filter_flag;
   1000 
   1001     /**
   1002      * Array to hold one row (top) of skip_flag flag stored at (8x8) level
   1003      * 1 bit per (8x8)
   1004      * read and written as a UWORD32
   1005      * LSB gives skip_flag for 0th 8x8 and MSB gives skip_flag for 31st 8x8 and so on
   1006      * This is independent of CTB size or minCU size
   1007      * Packed format requires extra calculations in extracting required bits but makes it easier
   1008      * to store skip data for larger sizes such as 32 x 32 where 4 bits need to be set instead of
   1009      * 4 bytes or for 64 x 64 where 8 bits need to be set instead of 8 bytes.
   1010      */
   1011     UWORD32 *pu4_skip_cu_top;
   1012 
   1013     /**
   1014      * Array to hold one 64 pixel column (left) of skip_flag flag stored at (8x8) level
   1015      * 1 bit per (8x8)
   1016      * read and written as a UWORD32
   1017      * LSB gives skip_flag for 0th 8x8 and MSB gives skip for 31st 8x8 and so on
   1018      * This is independent of CTB size and allocated to store data for 64 pixels, of
   1019      * this only first ctb_size number of bits (starting from MSB) will have valid data
   1020      * This is also independent of min CU size and data is stored at 8x8 level.
   1021      * Since only 8 bits are needed to represent left 64 pixels at 8x8 level, this is not an array
   1022      */
   1023     UWORD32 u4_skip_cu_left;
   1024 
   1025     /**
   1026      * Array to hold one row (top) of coding_tree_depth stored at (8x8) level
   1027      * 2 bits per (8x8) pixels
   1028      * read and written as a WORD32
   1029      * 2 LSBits give coding_tree_depth for 0th 8x8 and 2 MSBits give coding_tree_depth for 15th 8x8 and so on
   1030      * This is independent of CTB size or minCU size
   1031      */
   1032     UWORD32 *pu4_ct_depth_top;
   1033 
   1034     /**
   1035      * Array to hold one 64 pixel column (left) of coding_tree_depth stored at (8x8) level
   1036      * 2 bits per (8x8) pixels
   1037      * read and written as a WORD32
   1038      * 2 LSBits give coding_tree_depth for 0th 8x8 and 2 MSBits give coding_tree_depth for 15th 8x8 and so on
   1039      * This is independent of CTB size and allocated to store data for 64 pixels, of
   1040      * this only first ctb_size * 2 number of bits (starting from MSB) will have valid data
   1041      * This is also independent of min CU size and data is stored at 8x8 level.
   1042      * Since only 16 bits are needed to represent left 64 pixels at 8x8 level, this is not an array
   1043      */
   1044     UWORD32 u4_ct_depth_left;
   1045 
   1046     /**
   1047      * Array to hold top (one row) luma_intra_pred_mode stored at (4x4) level for a CTB
   1048      * 8 bits per (4x4) pixels
   1049      * read and written as a UWORD8
   1050      * This is independent of CTB size or minCU size
   1051      * This is independent of CTB size and allocated to store data for 64 pixels i.e. 64 bits is the size
   1052      * Note this data is used only within a CTB, There is no inter CTB dependencies for this
   1053      */
   1054     UWORD8 *pu1_luma_intra_pred_mode_top;
   1055 
   1056     /**
   1057      * Array to hold  left (one column) luma_intra_pred_mode stored at (4x4) level for a CTB
   1058      * 8 bits per (4x4) pixels
   1059      * read and written as a UWORD8
   1060      * This is independent of CTB size and allocated to store data for 64 pixels i.e. 64 bits is the size
   1061      * This is also independent of min CU size and data is stored at 8x8 level.
   1062      * This is used for prediction of next CTB within a row in a slice or tile
   1063      */
   1064     UWORD8 *pu1_luma_intra_pred_mode_left;
   1065 
   1066 
   1067     /**
   1068      * Pointer to base of Video parameter set structure array
   1069      */
   1070     vps_t *ps_vps_base;
   1071 
   1072     /**
   1073      * Pointer to base of Sequence parameter set structure array
   1074      */
   1075     sps_t *ps_sps_base;
   1076 
   1077     /**
   1078      * Pointer to base of Picture parameter set structure array
   1079      */
   1080     pps_t *ps_pps_base;
   1081 
   1082     /**
   1083      * Pointer to base of slice header structure array
   1084      */
   1085     slice_header_t *ps_slice_hdr_base;
   1086 
   1087     /**
   1088      * Pointer to current slice header structure
   1089      */
   1090     slice_header_t *ps_slice_hdr;
   1091 
   1092 
   1093     /**
   1094      * Error code during parse stage
   1095      */
   1096     WORD32 i4_error_code;
   1097 
   1098     /**
   1099      * Void pointer to process job context
   1100      */
   1101     void *pv_proc_jobq;
   1102 
   1103     /* Cabac context */
   1104     cab_ctxt_t s_cabac;
   1105 
   1106     /* Current Coding tree depth */
   1107     WORD32 i4_ct_depth;
   1108 
   1109     /** Flag to signal end of frame */
   1110     WORD32 i4_end_of_frame;
   1111 
   1112     /**
   1113      * Index of the next CTB parsed
   1114      */
   1115     WORD32 i4_next_ctb_indx;
   1116 
   1117     /**
   1118      * Pointer to the structure that contains BS and QP frame level arrays
   1119      */
   1120     bs_ctxt_t s_bs_ctxt;
   1121 
   1122     /**
   1123      * Pointer to the structure that contains deblock context
   1124      */
   1125     deblk_ctxt_t s_deblk_ctxt;
   1126 
   1127     /**
   1128      * Pointer to the structure that contains sao context
   1129      */
   1130     sao_ctxt_t s_sao_ctxt;
   1131 
   1132     /**
   1133      * QP Array for the current CTB
   1134      * Used in QP prediction
   1135      */
   1136     WORD8 ai1_8x8_cu_qp[MAX_CU_IN_CTB];
   1137 
   1138 
   1139     /**
   1140      * Pointer to frame level sao_t for the current frame being parsed
   1141      */
   1142     sao_t *ps_pic_sao;
   1143 
   1144     /**
   1145      * Abs POC count of the frame
   1146      */
   1147     WORD32 i4_abs_pic_order_cnt;
   1148 
   1149     /**
   1150      * Pointer points to mv_buffer of current frame
   1151      */
   1152     mv_buf_t *ps_cur_mv_buf;
   1153 
   1154     /**
   1155      * Variable to store the next ctb count to compute pu idx
   1156      */
   1157     WORD32 i4_next_pu_ctb_cnt;
   1158 
   1159     /**
   1160      * Variable to store the next ctb count to compute tu idx
   1161      */
   1162     WORD32 i4_next_tu_ctb_cnt;
   1163 
   1164 
   1165 }parse_ctxt_t;
   1166 
   1167 /**
   1168  * Pixel processing thread context
   1169  */
   1170 
   1171 typedef struct
   1172 {
   1173     /* Pointer to codec context
   1174      *
   1175      */
   1176     codec_t *ps_codec;
   1177 
   1178     /**
   1179      * CTB's x position within a picture in raster scan in CTB units
   1180      */
   1181     WORD32 i4_ctb_x;
   1182 
   1183     /**
   1184      * CTB's y position within a picture in raster scan in CTB units
   1185      */
   1186 
   1187     WORD32 i4_ctb_y;
   1188 
   1189     /**
   1190      * CTB's x position within a Tile in raster scan in CTB units
   1191      */
   1192     WORD32 i4_ctb_tile_x;
   1193 
   1194     /**
   1195      * CTB's y position within a Tile in raster scan in CTB units
   1196      */
   1197 
   1198     WORD32 i4_ctb_tile_y;
   1199 
   1200     /**
   1201      * CTB's x position within a Slice in raster scan in CTB units
   1202      */
   1203     WORD32 i4_ctb_slice_x;
   1204 
   1205     /**
   1206      * CTB's y position within a Slice in raster scan in CTB units
   1207      */
   1208 
   1209     WORD32 i4_ctb_slice_y;
   1210 
   1211     /**
   1212      * Current tile being processed
   1213      */
   1214     tile_t *ps_tile;
   1215 
   1216     /**
   1217      * Current slice idx - Used in multi-core cases to store slice index for
   1218      * each ctb for sao filtering.
   1219      */
   1220     WORD32 i4_cur_slice_idx;
   1221 
   1222     /**
   1223      * Current tile idx - Used in multi-core cases to store tile index for
   1224      * each ctb for sao filtering.
   1225      */
   1226     WORD32 i4_cur_tile_idx;
   1227     /**
   1228      * Pointer to current PPS
   1229      */
   1230     pps_t *ps_pps;
   1231 
   1232     /**
   1233      * Pointer to current SPS
   1234      */
   1235     sps_t *ps_sps;
   1236 
   1237     /**
   1238      * Pointer to current slice header structure
   1239      */
   1240     slice_header_t *ps_slice_hdr;
   1241 
   1242     /**
   1243      * Error code during parse stage
   1244      */
   1245     WORD32 i4_error_code;
   1246 
   1247     /**
   1248      * Signal that pic_init is called first time
   1249      */
   1250     WORD32 i4_first_pic_init;
   1251 
   1252     /**
   1253      * Pointer frame level TU subblock coeff data
   1254      */
   1255     void *pv_pic_tu_coeff_data;
   1256 
   1257     /**
   1258      * Pointer to TU subblock coeff data and number of subblocks and scan idx
   1259      * Incremented each time a coded subblock is processed
   1260      *
   1261      */
   1262     void *pv_tu_coeff_data;
   1263 
   1264     /**
   1265      * Current TU structure - set to CTB tu_t pointer at the start of CTB processing and incremented
   1266      * for every TU
   1267      */
   1268     tu_t *ps_tu;
   1269 
   1270     /**
   1271      * Current ctb's TU map
   1272      */
   1273     UWORD8 *pu1_tu_map;
   1274 
   1275     /**
   1276      * Current PU structure - set to CTB pu_t pointer at the start of CTB processing and incremented
   1277      * for every TU
   1278      */
   1279     pu_t *ps_pu;
   1280 
   1281     /**
   1282      * Points to an array of TU indices which is used to identify
   1283      * start index of tu_t in ps_pic_tu and also to identify number of
   1284      * TUs in the current CTB by subtracting current idx from next CTB's
   1285      * TU idx
   1286      */
   1287     UWORD32 *pu4_pic_tu_idx;
   1288 
   1289     /**
   1290      * Points to an array of PU indices which is used to identify
   1291      * start index of pu_t in ps_pic_pu and also to identify number of
   1292      * PUs in the current CTB by subtracting current idx from next CTB's
   1293      * PU idx
   1294      */
   1295     UWORD32 *pu4_pic_pu_idx;
   1296 
   1297     /**
   1298      * Pointer to tu_map for the current frame being parsed
   1299      */
   1300     UWORD8 *pu1_pic_tu_map;
   1301 
   1302     /**
   1303       * Pointer to pu_map for the current frame being parsed
   1304       * where MVs and Intra pred modes will be updated
   1305       */
   1306     UWORD8 *pu1_pic_pu_map;
   1307 
   1308     /**
   1309      * Pointer to frame level pu_t for the current frame being parsed
   1310      * where MVs and Intra pred modes will be updated
   1311      */
   1312     pu_t *ps_pic_pu;
   1313 
   1314     /** PU Index map per CTB. The indices in this map are w.r.t picture pu array and not
   1315      * w.r.t CTB pu array.
   1316      * This will be used during mv prediction and since neighbours will have different CTB pu map
   1317      * it will be easier if they all have indices w.r.t picture level PU array rather than CTB level
   1318      * PU array.
   1319      * pu1_pic_pu_map is map w.r.t CTB's pu_t array
   1320      */
   1321     UWORD32 *pu4_pic_pu_idx_map;
   1322 
   1323     /**
   1324      * PU Index of top 4x4 neighbors stored for an entire row
   1325      */
   1326     UWORD32 *pu4_pic_pu_idx_top;
   1327 
   1328     /**
   1329      * PU Index of left 4x4 neighbors stored for 64 pixels
   1330      */
   1331     UWORD32 *pu4_pic_pu_idx_left;
   1332 
   1333     /**
   1334      * Holds top left PU index at CTB level - top left gets overwritten
   1335      * by left CTB while updating top array. Before updating top at CTB
   1336      * level required top-left index is backed up in the following
   1337      */
   1338     UWORD32 u4_ctb_top_left_pu_idx;
   1339 
   1340     /**
   1341      * Pointer to frame level tu_t for the current frame being parsed
   1342      * where transform unit related info will be updated
   1343      */
   1344     tu_t *ps_pic_tu;
   1345 
   1346 
   1347     /**
   1348     * Current PU structure - set to CTB pu_map pointer at the start of CTB parsing
   1349     */
   1350     UWORD8 *pu1_pu_map;
   1351 
   1352     /** Current MV Bank's buffer ID */
   1353     WORD32 i4_cur_mv_bank_buf_id;
   1354 
   1355     /**
   1356      * Current pictures intra mode map at 8x8 level
   1357      */
   1358     UWORD8 *pu1_pic_intra_flag;
   1359 
   1360     /**
   1361      * Current pictures loop filter flag map at 8x8 level
   1362      */
   1363     UWORD8 *pu1_pic_no_loop_filter_flag;
   1364 
   1365     /**
   1366      * Void pointer to process job context
   1367      */
   1368 
   1369     void *pv_proc_jobq;
   1370 
   1371     /**
   1372      * Number of CTBs to be processed in the current Job
   1373      */
   1374     WORD32 i4_ctb_cnt;
   1375     /**
   1376      * ID for the current context - Used for debugging
   1377      */
   1378     WORD32 i4_id;
   1379 
   1380     /**
   1381      * Flag to indicate if parsing status has to be checked
   1382      * Needed when parsing and processing are done in different threads
   1383      */
   1384     WORD32 i4_check_parse_status;
   1385 
   1386     /**
   1387      * Flag to indicate if processing status of top row CTBs has to be checked
   1388      * Needed when processing of different rows is done in different threads
   1389      */
   1390     WORD32 i4_check_proc_status;
   1391 
   1392     /**
   1393      * Holds Intra dequantization matrices
   1394      */
   1395     WORD16 *api2_dequant_intra_matrix[4];
   1396 
   1397     /**
   1398      * Holds Inter dequantization matrices
   1399      */
   1400     WORD16 *api2_dequant_inter_matrix[4];
   1401 
   1402 
   1403     /**
   1404      * Temporary buffer 1 - Used as a scratch in inter_pred_ctb()
   1405      */
   1406     WORD16 *pi2_inter_pred_tmp_buf1;
   1407 
   1408     /**
   1409      * Temporary buffer 2 - Used as a scratch in inter_pred_ctb()
   1410      */
   1411     WORD16 *pi2_inter_pred_tmp_buf2;
   1412 
   1413     /**
   1414      * Temporary buffer 3 - Used as a scratch in inter_pred_ctb()
   1415      */
   1416     WORD16 *pi2_inter_pred_tmp_buf3;
   1417 
   1418     /**
   1419      * The above temporary buffers' stride
   1420      */
   1421     WORD32 i4_inter_pred_tmp_buf_strd;
   1422     /**
   1423      * Picture stride
   1424      * Used as prediction stride, destination stride while computing inverse transform
   1425      */
   1426     WORD32 i4_pic_strd;
   1427 
   1428     /**
   1429      * Picture qp offset for U
   1430      */
   1431     WORD8 i1_pic_cb_qp_offset;
   1432 
   1433     /**
   1434      * Slice qp offset for U
   1435      */
   1436     WORD32 i1_slice_cb_qp_offset;
   1437 
   1438     /**
   1439      * Picture qp offset for V
   1440      */
   1441     WORD8 i1_pic_cr_qp_offset;
   1442 
   1443     /**
   1444      * Slice qp offset for V
   1445      */
   1446     WORD32 i1_slice_cr_qp_offset;
   1447 
   1448     /** Pointer to current picture buffer structure */
   1449     pic_buf_t *ps_cur_pic;
   1450 
   1451     /** Current pic_buf's picture buffer id */
   1452     WORD32 i4_cur_pic_buf_id;
   1453 
   1454     /** Pointer to 0th luma pixel in current pic */
   1455     UWORD8 *pu1_cur_pic_luma;
   1456 
   1457     /** Pointer to 0th chroma pixel in current pic */
   1458     UWORD8 *pu1_cur_pic_chroma;
   1459 
   1460     /** Intermediate buffer to be used during inverse transform */
   1461     WORD16 *pi2_itrans_intrmd_buf;
   1462 
   1463     /** Buffer to hold output of inverse scan */
   1464     WORD16 *pi2_invscan_out;
   1465 
   1466     /**
   1467      *  Top availability for current CTB level
   1468      */
   1469     UWORD8 u1_top_ctb_avail;
   1470 
   1471     /**
   1472      *  Top right availability for current CTB level
   1473      */
   1474     UWORD8 u1_top_rt_ctb_avail;
   1475     /**
   1476      *  Top left availability for current CTB level
   1477      */
   1478     UWORD8 u1_top_lt_ctb_avail;
   1479     /**
   1480      *  left availability for current CTB level
   1481      */
   1482     UWORD8 u1_left_ctb_avail;
   1483     /**
   1484      *  TU count in current CTB
   1485      */
   1486     WORD32 i4_ctb_tu_cnt;
   1487 
   1488     /**
   1489      *  Recon pointer to current CTB luma
   1490      */
   1491     UWORD8 *pu1_cur_ctb_luma;
   1492     /**
   1493      *  Recon pointer to current CTB chroma
   1494      */
   1495     UWORD8 *pu1_cur_ctb_chroma;
   1496 
   1497     /**
   1498      *  PU count in current CTB
   1499      */
   1500     WORD32 i4_ctb_pu_cnt;
   1501 
   1502     /**
   1503      *  PU count in current CTB
   1504      */
   1505     WORD32 i4_ctb_start_pu_idx;
   1506 
   1507     /* Pointer to a structure describing output display buffer */
   1508     ivd_out_bufdesc_t *ps_out_buffer;
   1509 
   1510     /** Flag to indicate if ps_proc was intialized at least once in a frame.
   1511      * This is needed to handle cases where a core starts to handle format conversion jobs directly
   1512      */
   1513     WORD32 i4_init_done;
   1514 
   1515     /**
   1516      * Pointer to the structure that contains BS and QP frame level arrays
   1517      */
   1518     bs_ctxt_t s_bs_ctxt;
   1519 
   1520     /**
   1521      * Pointer to the structure that contains deblock context
   1522      */
   1523     deblk_ctxt_t s_deblk_ctxt;
   1524 
   1525     /**
   1526      * Pointer to the structure that contains sao context
   1527      */
   1528     sao_ctxt_t s_sao_ctxt;
   1529 
   1530     /**
   1531      * Points to the array of slice indices which is used to identify the independent
   1532      * slice to which each CTB in a frame belongs.
   1533      */
   1534     UWORD16 *pu1_slice_idx;
   1535 
   1536     /**
   1537      * Points to the array of slice indices which is used to identify the slice
   1538      *  to which each CTB in a frame belongs.
   1539      */
   1540     UWORD16 *pu1_tile_idx;
   1541     /**
   1542      * Variable to store the next ctb count to compute pu idx
   1543      */
   1544     WORD32 i4_next_pu_ctb_cnt;
   1545 
   1546     /**
   1547      * Variable to store the next ctb count to compute tu idx
   1548      */
   1549     WORD32 i4_next_tu_ctb_cnt;
   1550     /**
   1551      * Number of ctb's to process in one loop
   1552      */
   1553     WORD32 i4_nctb;
   1554 }process_ctxt_t;
   1555 
   1556 typedef void (*pf_inter_pred)(void *,
   1557                               void *,
   1558                               WORD32,
   1559                               WORD32,
   1560                               WORD8 *,
   1561                               WORD32,
   1562                               WORD32);
   1563 
   1564 
   1565 typedef void (*pf_intra_pred)(UWORD8 *pu1_ref,
   1566                               WORD32 src_strd,
   1567                               UWORD8 *pu1_dst,
   1568                               WORD32 dst_strd,
   1569                               WORD32 nt,
   1570                               WORD32 mode);
   1571 
   1572 typedef void (*pf_itrans_recon)(WORD16 *pi2_src,
   1573                                 WORD16 *pi2_tmp,
   1574                                 UWORD8 *pu1_pred,
   1575                                 UWORD8 *pu1_dst,
   1576                                 WORD32 src_strd,
   1577                                 WORD32 pred_strd,
   1578                                 WORD32 dst_strd,
   1579                                 WORD32 zero_cols,
   1580                                 WORD32 zero_rows);
   1581 
   1582 typedef void (*pf_recon)(WORD16 *pi2_src,
   1583                          UWORD8 *pu1_pred,
   1584                          UWORD8 *pu1_dst,
   1585                          WORD32 src_strd,
   1586                          WORD32 pred_strd,
   1587                          WORD32 dst_strd,
   1588                          WORD32 zero_cols);
   1589 
   1590 typedef void (*pf_itrans_recon_dc)(UWORD8 *pu1_pred,
   1591                                    UWORD8 *pu1_dst,
   1592                                    WORD32 pred_strd,
   1593                                    WORD32 dst_strd,
   1594                                    WORD32 log2_trans_size,
   1595                                    WORD16 i2_coeff_value);
   1596 
   1597 
   1598 typedef void (*pf_sao_luma)(UWORD8 *,
   1599                             WORD32,
   1600                             UWORD8 *,
   1601                             UWORD8 *,
   1602                             UWORD8 *,
   1603                             UWORD8 *,
   1604                             UWORD8 *,
   1605                             UWORD8 *,
   1606                             WORD8 *,
   1607                             WORD32,
   1608                             WORD32);
   1609 
   1610 typedef void (*pf_sao_chroma)(UWORD8 *,
   1611                               WORD32,
   1612                               UWORD8 *,
   1613                               UWORD8 *,
   1614                               UWORD8 *,
   1615                               UWORD8 *,
   1616                               UWORD8 *,
   1617                               UWORD8 *,
   1618                               WORD8 *,
   1619                               WORD8 *,
   1620                               WORD32,
   1621                               WORD32);
   1622 
   1623 /**
   1624  * Codec context
   1625  */
   1626 
   1627 struct _codec_t
   1628 {
   1629     /**
   1630      * Width : pic_width_in_luma_samples
   1631      */
   1632     WORD32 i4_wd;
   1633 
   1634     /**
   1635      * Height : pic_height_in_luma_samples
   1636      */
   1637     WORD32 i4_ht;
   1638 
   1639     /**
   1640      * Display width after cropping
   1641      */
   1642     WORD32 i4_disp_wd;
   1643 
   1644     /**
   1645      * Display height after cropping
   1646      */
   1647     WORD32 i4_disp_ht;
   1648 
   1649     /**
   1650      * Display stride
   1651      */
   1652     WORD32 i4_disp_strd;
   1653 
   1654     /**
   1655      * Stride of reference buffers.
   1656      * For shared mode even display buffer will use the same stride
   1657      */
   1658     WORD32 i4_strd;
   1659 
   1660     /**
   1661      * Number of cores to be used
   1662      */
   1663     WORD32 i4_num_cores;
   1664 
   1665     /**
   1666      * RASL output flag
   1667      */
   1668     WORD32 i4_rasl_output_flag;
   1669 
   1670     /**
   1671      * This flag is set if the next picture received is a CRA and has to be treated as a first pic in the video sequence
   1672      * For example, it is set, if an EOS (end of stream) NAL is received
   1673      */
   1674     WORD32 i4_cra_as_first_pic;
   1675 
   1676     /**
   1677      * Pictures that are are degraded
   1678      * 0 : No degrade
   1679      * 1 : Only on non-reference frames
   1680      * 2 : Use interval specified by u4_nondegrade_interval
   1681      * 3 : All non-key frames
   1682      * 4 : All frames
   1683      */
   1684     WORD32                                     i4_degrade_pics;
   1685 
   1686     /**
   1687      * Interval for pictures which are completely decoded without any degradation
   1688      */
   1689     WORD32                                     i4_nondegrade_interval;
   1690 
   1691     /**
   1692      * bit position (lsb is zero): Type of degradation
   1693      * 0 : Disable SAO
   1694      * 1 : Disable deblocking
   1695      * 2 : Faster inter prediction filters
   1696      * 3 : Fastest inter prediction filters
   1697      */
   1698     WORD32                                     i4_degrade_type;
   1699 
   1700     /** Degrade pic count, Used to maintain the interval between non-degraded pics
   1701      *
   1702      */
   1703     WORD32  i4_degrade_pic_cnt;
   1704 
   1705     /**
   1706      * Total number of display buffers to be used
   1707      * In case of shared mode, this will be number of reference frames
   1708      */
   1709     WORD32 i4_num_disp_bufs;
   1710 
   1711     /**
   1712      * Flag to enable shared display buffer mode
   1713      */
   1714     WORD32 i4_share_disp_buf;
   1715 
   1716     /**
   1717      * Chroma format of display buffers.
   1718      In shared mode only 420SP_UV and 420SP_VU are supported
   1719      */
   1720     IV_COLOR_FORMAT_T e_chroma_fmt;
   1721 
   1722     /**
   1723      * Chroma format of reference buffers.
   1724      * In non-shared mode it will be 420SP_UV
   1725      * In shared mode only 420SP_UV and 420SP_VU are supported
   1726      */
   1727     IV_COLOR_FORMAT_T e_ref_chroma_fmt;
   1728 
   1729     /**
   1730      * Frame skip mode
   1731      */
   1732     IVD_FRAME_SKIP_MODE_T e_pic_skip_mode;
   1733 
   1734     /**
   1735      * Display or decode order dump of output
   1736      */
   1737     IVD_DISPLAY_FRAME_OUT_MODE_T e_pic_out_order;
   1738 
   1739     /**
   1740      * Coding type of the picture that is decoded
   1741      */
   1742     IV_PICTURE_CODING_TYPE_T e_dec_pic_type;
   1743 
   1744     /**
   1745      * Flag to signal if a frame was decoded in this call
   1746      */
   1747     WORD32 i4_pic_decoded;
   1748 
   1749     /**
   1750      * Flag to signal if picture data is present in the current input bitstream
   1751      */
   1752     WORD32 i4_pic_present;
   1753 
   1754     /**
   1755      * Flag to disable deblocking of a frame
   1756      */
   1757     WORD32 i4_disable_deblk_pic;
   1758 
   1759     /**
   1760      * Flag to disable sao of a frame
   1761      */
   1762     WORD32 i4_disable_sao_pic;
   1763 
   1764     /**
   1765      * Flag to use full pel MC
   1766      */
   1767     WORD32 i4_fullpel_inter_pred;
   1768     /**
   1769      * Flush mode
   1770      */
   1771     WORD32 i4_flush_mode;
   1772 
   1773     /**
   1774      * Decode header mode
   1775      */
   1776     WORD32 i4_header_mode;
   1777 
   1778     /**
   1779      * Header in slice mode
   1780      */
   1781     WORD32 i4_header_in_slice_mode;
   1782 
   1783     /**
   1784      * Flag to signal sps done
   1785      */
   1786     WORD32 i4_sps_done;
   1787 
   1788     /**
   1789      * Flag to signal pps done
   1790      */
   1791     WORD32 i4_pps_done;
   1792 
   1793     /**
   1794      * To signal successful completion of init
   1795      */
   1796     WORD32 i4_init_done;
   1797 
   1798     /**
   1799      * To signal that at least one picture was decoded
   1800      */
   1801     WORD32 i4_first_pic_done;
   1802 
   1803     /**
   1804      * To signal error in slice
   1805      */
   1806     WORD32 i4_slice_error;
   1807 
   1808     /**
   1809      * Reset flag - Codec is reset if this flag is set
   1810      */
   1811     WORD32 i4_reset_flag;
   1812 
   1813     /**
   1814      * Number of pictures decoded till now
   1815      */
   1816     UWORD32 u4_pic_cnt;
   1817 
   1818     /**
   1819      * Number of pictures displayed till now
   1820      */
   1821     UWORD32 u4_disp_cnt;
   1822 
   1823     /**
   1824      * Current error code
   1825      */
   1826     WORD32 i4_error_code;
   1827 
   1828     /**
   1829      * Pointer to input bitstream. This is incremented everytime a NAL is processed
   1830      */
   1831     UWORD8 *pu1_inp_bitsbuf;
   1832 
   1833     /**
   1834      * Offset to first byte after the start code in current NAL
   1835      */
   1836     WORD32 i4_nal_ofst;
   1837 
   1838     /**
   1839      * Length of the NAL unit including the emulation bytes
   1840      */
   1841     WORD32 i4_nal_len;
   1842 
   1843     /**
   1844      * Number of emulation prevention bytes present in the current NAL
   1845      */
   1846     WORD32 i4_num_emln_bytes;
   1847 
   1848     /**
   1849      * Number of bytes remaining in the input bitstream
   1850      */
   1851     /**
   1852      * Decremented everytime a NAL is processed
   1853      */
   1854     WORD32 i4_bytes_remaining;
   1855 
   1856     /**
   1857      * Pointer to bitstream after emulation prevention
   1858      */
   1859     UWORD8 *pu1_bitsbuf;
   1860 
   1861     /**
   1862      * Pointer to static bitstream after emulation prevention
   1863      * This is a fixed size buffer used initially till SPS is decoded
   1864      */
   1865     UWORD8 *pu1_bitsbuf_static;
   1866 
   1867     /**
   1868      * Pointer to dynamic bitstream after emulation prevention
   1869      * This is allocated after SPS is done, based on width and height
   1870      */
   1871     UWORD8 *pu1_bitsbuf_dynamic;
   1872 
   1873     /**
   1874      * Size of intermediate bitstream buffer
   1875      */
   1876     UWORD32 u4_bitsbuf_size;
   1877 
   1878     /**
   1879      * Size of intermediate static bitstream buffer
   1880      */
   1881     UWORD32 u4_bitsbuf_size_static;
   1882 
   1883     /**
   1884      * Size of intermediate dynamic bitstream buffer
   1885      */
   1886     UWORD32 u4_bitsbuf_size_dynamic;
   1887 
   1888     /**
   1889      * Pointer to hold TU data for a set of CTBs or a picture
   1890      */
   1891     void *pv_tu_data;
   1892 
   1893     /**
   1894      * Process Job queue buffer base
   1895      */
   1896     void *pv_proc_jobq_buf;
   1897 
   1898     /**
   1899      * Process Job Queue mem tab size
   1900      */
   1901     WORD32 i4_proc_jobq_buf_size;
   1902 
   1903     /** Parse status: one byte per CTB */
   1904     UWORD8 *pu1_parse_map;
   1905 
   1906     /** Process status: one byte per CTB */
   1907     UWORD8 *pu1_proc_map;
   1908     /**
   1909      * Current pictures intra mode map at 8x8 level
   1910      */
   1911     UWORD8 *pu1_pic_intra_flag;
   1912 
   1913     /**
   1914      * No LPF buffer base
   1915      */
   1916     UWORD8 *pu1_pic_no_loop_filter_flag_base;
   1917 
   1918     /**
   1919      * Current pictures loop filter flag map at 8x8 level
   1920      */
   1921     UWORD8 *pu1_pic_no_loop_filter_flag;
   1922     /**
   1923      * MV Bank buffer manager
   1924      */
   1925     void *pv_mv_buf_mgr;
   1926 
   1927     /**
   1928      * Pointer to MV Buf structure array
   1929      */
   1930     void *ps_mv_buf;
   1931 
   1932     /**
   1933      * Base address for Motion Vector bank buffer
   1934      */
   1935     void *pv_mv_bank_buf_base;
   1936 
   1937     /**
   1938      * MV Bank size allocated
   1939      */
   1940     WORD32 i4_total_mv_bank_size;
   1941 
   1942     /**
   1943      * Picture buffer manager
   1944      */
   1945     void *pv_pic_buf_mgr;
   1946 
   1947     /**
   1948      * Pointer to Pic Buf structure array
   1949      */
   1950     void *ps_pic_buf;
   1951 
   1952     /**
   1953      * Base address for Picture buffer
   1954      */
   1955     void *pv_pic_buf_base;
   1956 
   1957     /**
   1958      * Total pic buffer size allocated
   1959      */
   1960     WORD32 i4_total_pic_buf_size;
   1961 
   1962     /**
   1963      * Current chroma buffer base - used for shared mode with 420p output
   1964      */
   1965     UWORD8 *pu1_cur_chroma_ref_buf;
   1966 
   1967     /**
   1968      * Picture buffer manager
   1969      */
   1970     void *pv_disp_buf_mgr;
   1971 
   1972     /**
   1973      * Current display buffer's buffer ID
   1974      */
   1975     WORD32 i4_disp_buf_id;
   1976 
   1977     /**
   1978      * Current display buffer
   1979      */
   1980     pic_buf_t *ps_disp_buf;
   1981 
   1982     /**
   1983      * Pointer to dpb manager structure
   1984      */
   1985     void *pv_dpb_mgr;
   1986 
   1987     /**
   1988      * Scaling matrices for each PPS
   1989      */
   1990     WORD16 *pi2_scaling_mat;
   1991 
   1992     /**
   1993      * Array containing Tile information for each PPS
   1994      */
   1995     tile_t *ps_tile;
   1996 
   1997     /**
   1998      * Timestamp associated with the current display output
   1999      */
   2000     UWORD32 u4_ts;
   2001 
   2002     /**
   2003      * Pointer to base of Video parameter set structure array
   2004      */
   2005     vps_t *ps_vps_base;
   2006 
   2007     /**
   2008      * Pointer to base of Sequence parameter set structure array
   2009      */
   2010     sps_t *ps_sps_base;
   2011 
   2012     /**
   2013      * Pointer to base of Picture parameter set structure array
   2014      */
   2015     pps_t *ps_pps_base;
   2016 
   2017     /**
   2018      * Pointer to base of slice header structure array
   2019      */
   2020     slice_header_t *ps_slice_hdr_base;
   2021     /**
   2022      * Pointer to base of entry point offsets in a frame
   2023      */
   2024     WORD32 *pi4_entry_ofst;
   2025 
   2026     /**
   2027      * Current offset in pi4_entry_ofst
   2028      */
   2029     WORD32 i4_cur_entry_ofst;
   2030 
   2031     /**
   2032      *  Parsing context
   2033      */
   2034     parse_ctxt_t s_parse;
   2035 
   2036     /**
   2037      * Processing context - One for each processing thread
   2038      */
   2039     process_ctxt_t as_process[MAX_PROCESS_THREADS];
   2040 
   2041     /**
   2042      * Thread handle for each of the processing threads
   2043      */
   2044     void *apv_process_thread_handle[MAX_PROCESS_THREADS];
   2045 
   2046     /**
   2047      * Thread created flag for each of the processing threads
   2048      */
   2049     WORD32 ai4_process_thread_created[MAX_PROCESS_THREADS];
   2050 
   2051     /**
   2052      * Void pointer to process job context
   2053      */
   2054     void *pv_proc_jobq;
   2055 
   2056     /* Number of CTBs processed together for better instruction cache handling */
   2057     WORD32 i4_proc_nctb;
   2058 
   2059     /**
   2060      * Previous POC lsb
   2061      */
   2062     WORD32 i4_prev_poc_lsb;
   2063 
   2064     /**
   2065      * Previous POC msb
   2066      */
   2067     WORD32 i4_prev_poc_msb;
   2068 
   2069     /**
   2070      * Max POC lsb that has arrived till now
   2071      */
   2072     WORD32 i4_max_prev_poc_lsb;
   2073 
   2074     /** Context for format conversion */
   2075     fmt_conv_t s_fmt_conv;
   2076 
   2077     /** Pointer to a structure describing output display buffer */
   2078     ivd_out_bufdesc_t *ps_out_buffer;
   2079     /**
   2080      * Variable to store the next ctb count to compute pu idx
   2081      */
   2082     WORD32 i4_next_pu_ctb_cnt;
   2083 
   2084     /**
   2085      * Variable to store the next ctb count to compute tu idx
   2086      */
   2087     WORD32 i4_next_tu_ctb_cnt;
   2088 
   2089     /**  Active SPS id - mainly to be used during codec initializations in shared mode */
   2090     WORD32 i4_sps_id;
   2091 
   2092     /**  Number of ctbs to be decoded in one process call */
   2093     UWORD32 u4_nctb;
   2094 
   2095     /** Flag to enable scheduling of format conversion jobs ahead of processing jobs */
   2096     UWORD32 u4_enable_fmt_conv_ahead;
   2097 
   2098     /** Mask used to change MVs to full pel when configured to run in reduced complexity mode */
   2099     WORD32 i4_mv_frac_mask;
   2100 
   2101     /** Memory holding tile indices */
   2102     UWORD8 *pu1_tile_idx_base;
   2103 
   2104     /** Callback for aligned allocation */
   2105     void *(*pf_aligned_alloc)(void *pv_mem_ctxt, WORD32 alignment, WORD32 size);
   2106 
   2107     /** Callback for aligned free */
   2108     void (*pf_aligned_free)(void *pv_mem_ctxt, void *pv_buf);
   2109 
   2110     /** Memory context passed from application */
   2111     void *pv_mem_ctxt;
   2112 
   2113     /** Base address of reference buffrers allocated */
   2114     UWORD8 *pu1_ref_pic_buf_base;
   2115 
   2116     /** Flag to indicate if dynamic buffers are allocated */
   2117     UWORD32 u4_allocate_dynamic_done;
   2118 
   2119     /** Flag to signal display order */
   2120     IVD_DISPLAY_FRAME_OUT_MODE_T  e_frm_out_mode;
   2121 
   2122     /**  Funtion pointers for inter_pred leaf level functions */
   2123     pf_inter_pred apf_inter_pred[22];
   2124 
   2125     /**  Funtion pointers for inter_pred_luma leaf level functions */
   2126     pf_intra_pred apf_intra_pred_luma[11];
   2127 
   2128     /**  Funtion pointers for inter_pred_chroma leaf level functions */
   2129     pf_intra_pred apf_intra_pred_chroma[11];
   2130 
   2131     /**  Funtion pointers for itrans_recon leaf level functions */
   2132     pf_itrans_recon apf_itrans_recon[8];
   2133 
   2134     /**  Funtion pointers for recon leaf level functions */
   2135     pf_recon apf_recon[8];
   2136 
   2137     /**  Funtion pointers for itrans_recon_dc leaf level functions */
   2138     pf_itrans_recon_dc apf_itrans_recon_dc[2];
   2139 
   2140     /**  Funtion pointers for sao_luma leaf level functions */
   2141     pf_sao_luma apf_sao_luma[4];
   2142 
   2143     /**  Funtion pointers for sao_chroma leaf level functions */
   2144     pf_sao_chroma apf_sao_chroma[4];
   2145 
   2146     /**  Funtion pointers for all the leaf level functions */
   2147     func_selector_t s_func_selector;
   2148     /**  Processor architecture */
   2149     IVD_ARCH_T e_processor_arch;
   2150     /**  Processor soc */
   2151     IVD_SOC_T e_processor_soc;
   2152 
   2153     /** Display buffer array - for shared mode */
   2154     ivd_out_bufdesc_t s_disp_buffer[IVD_VIDDEC_MAX_IO_BUFFERS];
   2155 
   2156     /** Number of active display buffers - for shared mode */
   2157     WORD32  i4_share_disp_buf_cnt;
   2158 };
   2159 
   2160 #endif /* _IHEVCD_STRUCTS_H_ */
   2161