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