encoder/irc_picture_type.h

/******************************************************************************
 *
 * 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 _PIC_HANDLING_H_
#define _PIC_HANDLING_H_

/*
 * Basic Understanding:
 * irc_add_pic_to_stack(_re_enc):
 * This functions converts the input (or display) order to encoding order
 * */
typedef struct pic_handling_t *pic_handling_handle;

WORD32 irc_pic_handling_num_fill_use_free_memtab(pic_handling_handle *pps_pic_handling,
                                                 itt_memtab_t *ps_memtab,
                                                 ITT_FUNC_TYPE_E e_func_type);

void irc_init_pic_handling(pic_handling_handle ps_pic_handling,
                           WORD32 i4_intra_frm_int,
                           WORD32 i4_inter_frm_int,
                           WORD32 i4_max_inter_frm_int,
                           WORD32 i4_is_gop_closed);

void irc_add_pic_to_stack(pic_handling_handle ps_pic_handling,
                          WORD32 i4_enc_pic_id);

WORD32 irc_add_pic_to_stack_re_enc(pic_handling_handle ps_pic_handling,
                                   WORD32 i4_enc_pic_id,
                                   picture_type_e e_pic_type);

void irc_get_pic_from_stack(pic_handling_handle ps_pic_handling,
                            WORD32 *pi4_pic_id,
                            WORD32 *pi4_pic_disp_order_no,
                            picture_type_e *pe_pic_type);

WORD32 irc_is_last_frame_in_gop(pic_handling_handle ps_pic_handling);

void irc_flush_frame_from_pic_stack(pic_handling_handle ps_pic_handling);

/* NITT TBR The below two functions should be made a single function */
void irc_skip_encoded_frame(pic_handling_handle ps_pic_handling,
                            picture_type_e e_pic_type);

void irc_update_pic_handling(pic_handling_handle ps_pic_handling,
                             picture_type_e e_pic_type);

/*
 * Function returns the number of frames that have been encoded in the GOP in
 * which the force I frame takes impact
 */
WORD32 irc_pic_type_get_frms_in_gop_force_I_frm(pic_handling_handle ps_pic_handling);

void irc_set_force_I_frame_flag(pic_handling_handle ps_pic_handling);

WORD32 irc_get_forced_I_frame_cur_frm_flag(pic_handling_handle ps_pic_handling);

void irc_reset_forced_I_frame_cur_frm_flag(pic_handling_handle ps_pic_handling);

/* Normal get functions */
WORD32 irc_pic_type_get_inter_frame_interval(pic_handling_handle ps_pic_handling);

WORD32 irc_pic_type_get_intra_frame_interval(pic_handling_handle ps_pic_handling);

WORD32 irc_pic_type_get_disp_order_no(pic_handling_handle ps_pic_handling);

void irc_pic_handling_register_new_int_frm_interval(pic_handling_handle ps_pic_handling,
                                                    WORD32 i4_intra_frm_int);

void irc_pic_handling_register_new_inter_frm_interval(pic_handling_handle ps_pic_handling,
                                                      WORD32 i4_inter_frm_int);

void irc_pic_type_get_rem_frms_in_gop(pic_handling_handle ps_pic_handling,
                                      WORD32 ai4_rem_frms_in_gop[MAX_PIC_TYPE]);

void irc_pic_type_get_frms_in_gop(pic_handling_handle ps_pic_handling,
                                  WORD32 ai4_frms_in_gop[MAX_PIC_TYPE]);

#endif /* _PIC_HANDLING_H_ */