/****************************************************************************** * * Copyright (C) 2015 The Android Open Source Project * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at: * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. * ***************************************************************************** * Originally developed and contributed by Ittiam Systems Pvt. Ltd, Bangalore */ #ifndef _IH264D_DPB_MANAGER_H_ #define _IH264D_DPB_MANAGER_H_ /*! *************************************************************************** * \file ih264d_dpb_manager.h * * \brief * Decoded Picture Buffer Manager Include File * * Detailed_description * * \date * 19-12-2002 * * \author Sriram Sethuraman *************************************************************************** */ #include "ih264_typedefs.h" #include "ih264_macros.h" #include "ih264_platform_macros.h" #include "ih264d_bitstrm.h" #include "ih264d_defs.h" #define END_OF_MMCO 0 #define MARK_ST_PICNUM_AS_NONREF 1 #define MARK_LT_INDEX_AS_NONREF 2 #define MARK_ST_PICNUM_AS_LT_INDEX 3 #define SET_MAX_LT_INDEX 4 #define RESET_REF_PICTURES 5 #define SET_LT_INDEX 6 #define RESET_NONREF_PICTURES 7 #define RESET_ALL_PICTURES 8 struct field_t { /* picNum of tbe reference field */ WORD32 i4_pic_num; /* assigned when used for long term reference */ /* else MAX_REF_BUFS+1 */ UWORD8 u1_long_term_frame_idx; /* 0 : unused for reference */ /* 1 : used for short term reference */ /* 2 : used for long term reference */ UWORD8 u1_reference_info; }; struct dpb_info_t { struct pic_buffer_t *ps_pic_buf; /** Pointer to picture buffer structure */ WORD32 i4_frame_num; /** frame number of picture - unique for each ref*/ struct dpb_info_t *ps_prev_short;/** Link to the DPB with previous picNum */ struct dpb_info_t *ps_prev_long; /** Link to the DPB with previous long term frame*/ struct field_t s_top_field; /** Contains information of the top_field reference info, pic num and longt term frame idx */ struct field_t s_bot_field; /** Contains information of the bot_field reference info, pic num and longt term frame idx */ UWORD8 u1_buf_id; /** bufID from bufAPI */ UWORD8 u1_used_as_ref; /** whether buffer is used as ref for frame or complementary reference field pair */ UWORD8 u1_lt_idx; /** If buf is assigned long-term index; else MAX_REF_BUFS+1 */ }; typedef struct { struct pic_buffer_t *ps_def_dpb[MAX_REF_BUFS];/** DPB in default index order */ struct pic_buffer_t *ps_mod_dpb[2][2 * MAX_REF_BUFS];/** DPB in reordered index order, 0-fwd,1-bwd */ struct pic_buffer_t *ps_init_dpb[2][2 * MAX_REF_BUFS];/** DPB in reordered index order, 0-fwd,1-bwd */ struct dpb_info_t *ps_dpb_st_head; /** Pointer to the most recent picNum */ struct dpb_info_t *ps_dpb_ht_head; /** Pointer to the smallest LT index */ struct dpb_info_t as_dpb_info[MAX_REF_BUFS]; /** Physical storage for dpbInfo for ref bufs */ UWORD8 u1_num_st_ref_bufs; /** Number of short term ref. buffers */ UWORD8 u1_num_lt_ref_bufs; /** Number of long term ref. buffer */ UWORD8 u1_max_lt_pic_idx_plus1; /** Maximum long term pictures - 0 to max_long_term_pic_idx */ UWORD8 u1_num_gaps; /** Total number of outstanding gaps */ void * pv_codec_handle; /* For Error Handling */ WORD32 i4_max_frm_num; /** Max frame number */ WORD32 ai4_gaps_start_frm_num[MAX_FRAMES];/** start frame number for a gap seqn */ WORD32 ai4_gaps_end_frm_num[MAX_FRAMES]; /** start frame number for a gap seqn */ WORD8 ai1_gaps_per_seq[MAX_FRAMES]; /** number of gaps with each gap seqn */ WORD32 ai4_poc_buf_id_map[MAX_FRAMES][3]; WORD8 i1_poc_buf_id_entries; WORD8 i1_gaps_deleted; UWORD16 u2_pic_wd; UWORD16 u2_pic_ht; }dpb_manager_t; /** Structure store the MMC Commands */ struct MMCParams { UWORD32 u4_mmco; /** memory managemet control operation */ UWORD32 u4_diff_pic_num; /** diff Of Pic Nums Minus1 */ UWORD32 u4_lt_idx; /** Long Term Pic Idx */ UWORD32 u4_max_lt_idx_plus1; /** MaxLongTermPicIdxPlus1 */ }; typedef struct { UWORD8 u1_dpb_commands_read; /** Flag to indicate that DBP commands are read */ UWORD8 u1_buf_mode; /** decoder Pic bugffering mode*/ UWORD8 u1_num_of_commands; /** Number of MMC commands */ /* These variables are ised in case of IDR pictures only */ UWORD8 u1_idr_pic; /** = 1 ,IDR pic */ UWORD8 u1_no_output_of_prior_pics_flag; UWORD8 u1_long_term_reference_flag; struct MMCParams as_mmc_params[MAX_REF_BUFS]; /* < Buffer to store MMC commands */ UWORD8 u1_dpb_commands_read_slc; }dpb_commands_t; void ih264d_init_ref_bufs(dpb_manager_t *ps_dpb_mgr); WORD32 ih264d_insert_st_node(dpb_manager_t *ps_dpb_mgr, struct pic_buffer_t *ps_pic_buf, UWORD8 u1_buf_id, UWORD32 u2_cur_pic_num); WORD32 ih264d_update_default_index_list(dpb_manager_t *ps_dpb_mgr); WORD32 ih264d_do_mmco_buffer(dpb_commands_t *ps_dpb_cmds, dpb_manager_t *ps_dpb_mgr, UWORD8 u1_numRef_frames_for_seq, UWORD32 u4_cur_pic_num, UWORD32 u2_u4_max_pic_num_minus1, UWORD8 u1_nal_unit_type, struct pic_buffer_t *ps_pic_buf, UWORD8 u1_buf_id, UWORD8 u1_fld_pic_flag, UWORD8 u1_curr_pic_in_err); void ih264d_release_pics_in_dpb(void *pv_dec, UWORD8 u1_disp_bufs); void ih264d_reset_ref_bufs(dpb_manager_t *ps_dpb_mgr); WORD32 ih264d_delete_st_node_or_make_lt(dpb_manager_t *ps_dpb_mgr, WORD32 u4_pic_num, UWORD32 u4_lt_idx, UWORD8 u1_fld_pic_flag); WORD32 ih264d_delete_gap_frm_mmco(dpb_manager_t *ps_dpb_mgr, WORD32 i4_frame_num, UWORD8 *pu1_del_node); WORD32 ih264d_delete_gap_frm_sliding(dpb_manager_t *ps_dpb_mgr, WORD32 i4_frame_num, UWORD8 *pu1_del_node); WORD32 ih264d_do_mmco_for_gaps(dpb_manager_t *ps_dpb_mgr, UWORD8 u1_num_ref_frames); WORD32 ih264d_insert_pic_in_display_list(dpb_manager_t *ps_dpb_mgr, UWORD8 u1_buf_id, WORD32 i4_display_poc, UWORD32 u4_frame_num); void ih264d_delete_nonref_nondisplay_pics(dpb_manager_t *ps_dpb_mgr); #endif /* _IH264D_DPB_MANAGER_H_ */