Home | History | Annotate | Download | only in encoder
      1 /******************************************************************************
      2  *
      3  * Copyright (C) 2015 The Android Open Source Project
      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  * Originally developed and contributed by Ittiam Systems Pvt. Ltd, Bangalore
     19 */
     20 
     21 #ifndef _EST_SAD_H_
     22 #define _EST_SAD_H_
     23 
     24 /*
     25  * "est_sad_t->i4_use_est_intra_sad" Flag to control how the I frame SAD is estimated.
     26  * If set to zero
     27  * - it uses the Intra sad calculated by the previous P frame as
     28  * the estimated sad for the current I frame
     29  * else
     30  * - it uses the ratio of P frame sads of the previous two GOPS and
     31  * scales the I Frame sad with this ratio to estimate the current
     32  * I frame SAD
     33  */
     34 
     35 /* Estimating the Average SAD for the current picture type is done by:
     36  * 1) if picture_type is I
     37  * - Estimated SAD = (n-1)th intra frame interval(ifi) P frame Avg SAD *
     38  * ( prev I frame SAD / (n-2)nd intra frame interval(ifi) P frame Avg SAD)
     39  * - if only one IFI is encoded use the previous I frame SAD
     40  * 2) if picture type is P
     41  * - Estimate SAD is previous P frame SAD
     42  * 3) The first P frame in a IFI could use a little better logic to decide the
     43  * estimated SAD but currently we assume the last coded P frames SAD
     44  a*/
     45 
     46 typedef struct est_sad_t *est_sad_handle;
     47 
     48 WORD32 irc_est_sad_num_fill_use_free_memtab(est_sad_handle *est_sad,
     49                                             itt_memtab_t *ps_memtab,
     50                                             ITT_FUNC_TYPE_E e_func_type);
     51 
     52 void irc_init_est_sad(est_sad_handle est_sad, WORD32 i4_use_est_frame_sad);
     53 
     54 UWORD32 irc_get_est_sad(est_sad_handle est_sad, picture_type_e e_pic_type);
     55 
     56 void irc_update_actual_sad(est_sad_handle est_sad,
     57                            UWORD32 u4_actual_sad,
     58                            picture_type_e e_pic_type);
     59 
     60 void irc_update_actual_sad_for_intra(est_sad_handle est_sad,
     61                                      WORD32 i4_intra_frm_cost);
     62 
     63 void irc_reset_est_sad(est_sad_handle ps_est_sad);
     64 #endif
     65