irc_est_sad.h revision 8d3d303c7942ced6a987a52db8977d768dc3605f 
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
46typedef struct est_sad_t *est_sad_handle;
47
48WORD32 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
52void irc_init_est_sad(est_sad_handle est_sad, WORD32 i4_use_est_frame_sad);
53
54UWORD32 irc_get_est_sad(est_sad_handle est_sad, picture_type_e e_pic_type);
55
56void irc_update_actual_sad(est_sad_handle est_sad,
57                           UWORD32 u4_actual_sad,
58                           picture_type_e e_pic_type);
59
60void irc_update_actual_sad_for_intra(est_sad_handle est_sad,
61                                     WORD32 i4_intra_frm_cost);
62
63void irc_reset_est_sad(est_sad_handle ps_est_sad);
64#endif
65