/******************************************************************************
*
* 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_ */