encoder/est_sad.h

/******************************************************************************
 *
 * Copyright (C) 2018 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
*/
/*!
******************************************************************************
* \file est_sad.h
*
* \brief
*    This file contain SAD estimation functions  declarations
*
* \date
*
* \author
*    ittiam
*
******************************************************************************
*/

#ifndef _EST_SAD_H_
#define _EST_SAD_H_

/* "est_sad_t->i4_use_est_intra_sad" Flag to control how the I frame SAD is estimated.
If set to zero
    - it uses the Intra sad calculated by the previous P frame as
   the estimated sad for the current I frame
else
    - it uses the ratio of P frame sads of the previous two GOPS and
    scales the I Frame sad with this ratio to estimate the current
    I frame SAD
*/

/* Estimating the Average SAD for the current picture type is done by:
1) if picture_type is I
   - Estimated SAD = (n-1)th intra frame interval(ifi) P frame Avg SAD *
         ( prev I frame SAD / (n-2)nd intra frame interval(ifi) P frame Avg SAD)
   - if only one IFI is encoded use the previous I frame SAD
2) if picture type is P
   - Estimate SAD is previous P frame SAD
3) The first P frame in a IFI could use a little better logic to decide the
   estimated SAD but currently we assume the last coded P frames SAD */

/*****************************************************************************/
/* Structure                                                                 */
/*****************************************************************************/
typedef struct est_sad_t *est_sad_handle;

/*****************************************************************************/
/* Function Declarations                                                     */
/*****************************************************************************/
WORD32 est_sad_num_fill_use_free_memtab(
    est_sad_handle *est_sad, itt_memtab_t *ps_memtab, ITT_FUNC_TYPE_E e_func_type);

void init_est_sad(est_sad_handle est_sad, WORD32 i4_use_est_frame_sad);

UWORD32 get_est_sad(est_sad_handle est_sad, picture_type_e e_pic_type);

void update_actual_sad(est_sad_handle est_sad, UWORD32 u4_actual_sad, picture_type_e e_pic_type);

void update_actual_sad_for_intra(est_sad_handle est_sad, WORD32 i4_intra_frm_cost);

void update_prev_frame_intra_sad(est_sad_handle ps_est_sad, WORD32 i4_intra_frm_sad);

WORD32 get_prev_frame_intra_sad(est_sad_handle ps_est_sad);

void update_prev_frame_sad(est_sad_handle ps_est_sad, WORD32 i4_frm_sad, picture_type_e e_pic_type);

WORD32 get_prev_frame_sad(est_sad_handle ps_est_sad, picture_type_e e_pic_type);

void reset_est_sad(est_sad_handle ps_est_sad);

WORD32 update_ppic_sad(est_sad_handle est_sad, WORD32 i4_est_sad, WORD32 i4_prev_p_sad);
#endif