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 /*****************************************************************************/
     22 /* File Includes                                                             */
     23 /*****************************************************************************/
     24 
     25 /* System include files */
     26 #include <stdio.h>
     27 
     28 /* User include files */
     29 #include "irc_datatypes.h"
     30 #include "irc_common.h"
     31 #include "irc_cntrl_param.h"
     32 #include "irc_mem_req_and_acq.h"
     33 #include "irc_fixed_point_error_bits.h"
     34 
     35 typedef struct error_bits_t
     36 {
     37     /* Max tgt frm rate so that dynamic change in frm rate can be handled */
     38     WORD32 i4_max_tgt_frm_rate;
     39 
     40     /* Cur frm rate */
     41     WORD32 i4_cur_tgt_frm_rate;
     42 
     43     /* tgt frame rate*/
     44     WORD32 i4_tgt_frm_rate;
     45 
     46     /* tgt frm rate increment */
     47     WORD32 i4_tgt_frm_rate_incr;
     48 
     49     /* flag to indicate 1 second is up */
     50     UWORD8 u1_compute_error_bits;
     51 
     52     /* Bitrate/frame rate value added over a period */
     53     WORD32 i4_accum_bitrate;
     54 
     55     /* bitrate */
     56     WORD32 i4_bitrate;
     57 
     58 } error_bits_t;
     59 
     60 WORD32 irc_error_bits_num_fill_use_free_memtab(error_bits_t **pps_error_bits,
     61                                                itt_memtab_t *ps_memtab,
     62                                                ITT_FUNC_TYPE_E e_func_type)
     63 {
     64     WORD32 i4_mem_tab_idx = 0;
     65     error_bits_t s_error_bits_temp;
     66 
     67     /*
     68      * Hack for all alloc, during which we don't have any state memory.
     69      * Dereferencing can cause issues
     70      */
     71     if(e_func_type == GET_NUM_MEMTAB || e_func_type == FILL_MEMTAB)
     72         (*pps_error_bits) = &s_error_bits_temp;
     73 
     74     /* For src rate control state structure */
     75     if(e_func_type != GET_NUM_MEMTAB)
     76     {
     77         fill_memtab(&ps_memtab[i4_mem_tab_idx], sizeof(error_bits_t),
     78                     ALIGN_128_BYTE, PERSISTENT, DDR);
     79         use_or_fill_base(&ps_memtab[0], (void**)pps_error_bits, e_func_type);
     80     }
     81     i4_mem_tab_idx++;
     82 
     83     return (i4_mem_tab_idx);
     84 }
     85 
     86 /*******************************************************************************
     87  * @brief Calculates the error bits due to fixed point divisions
     88  ******************************************************************************/
     89 void irc_init_error_bits(error_bits_t *ps_error_bits,
     90                          WORD32 i4_max_tgt_frm_rate,
     91                          WORD32 i4_bitrate)
     92 {
     93     /* Initializing the parameters*/
     94     ps_error_bits->i4_cur_tgt_frm_rate = 0;
     95     ps_error_bits->i4_max_tgt_frm_rate = i4_max_tgt_frm_rate;
     96 
     97     /* Value by which i4_cur_tgt_frm_rate is incremented every VOP*/
     98     ps_error_bits->i4_tgt_frm_rate_incr = 1000;
     99 
    100     /*Compute error bits is set to 1 at the end of 1 second*/
    101     ps_error_bits->u1_compute_error_bits = 0;
    102     ps_error_bits->i4_tgt_frm_rate = i4_max_tgt_frm_rate;
    103     ps_error_bits->i4_accum_bitrate = 0;
    104     ps_error_bits->i4_bitrate = i4_bitrate;
    105 }
    106 
    107 /*******************************************************************************
    108  * @brief Updates the error state
    109  ******************************************************************************/
    110 void irc_update_error_bits(error_bits_t *ps_error_bits)
    111 {
    112     WORD32 i4_bits_per_frame;
    113 
    114     X_PROD_Y_DIV_Z(ps_error_bits->i4_bitrate, 1000,
    115                    ps_error_bits->i4_tgt_frm_rate, i4_bits_per_frame);
    116 
    117     /*
    118      * This value is incremented every at the end of every VOP by
    119      * i4_tgt_frm_rate_incr
    120      */
    121     ps_error_bits->i4_cur_tgt_frm_rate += ps_error_bits->i4_tgt_frm_rate_incr;
    122     if(ps_error_bits->u1_compute_error_bits == 1)
    123     {
    124         ps_error_bits->i4_accum_bitrate = 0;
    125     }
    126     ps_error_bits->i4_accum_bitrate += i4_bits_per_frame;
    127 
    128     /*
    129      * When current tgt frm rate is equal or greater than max tgt frame rate
    130      * 1 second is up , compute the error bits
    131      */
    132     if(ps_error_bits->i4_cur_tgt_frm_rate >= ps_error_bits->i4_max_tgt_frm_rate)
    133     {
    134         ps_error_bits->i4_cur_tgt_frm_rate -=
    135                         ps_error_bits->i4_max_tgt_frm_rate;
    136         ps_error_bits->u1_compute_error_bits = 1;
    137     }
    138     else
    139     {
    140         ps_error_bits->u1_compute_error_bits = 0;
    141     }
    142 }
    143 
    144 /*******************************************************************************
    145  * @brief Returns the error bits for the current frame if there are any
    146  *
    147  ******************************************************************************/
    148 WORD32 irc_get_error_bits(error_bits_t *ps_error_bits)
    149 {
    150     WORD32 i4_error_bits = 0;
    151 
    152     /*If 1s is up calculate error for the last 1s worth of frames*/
    153     if(ps_error_bits->u1_compute_error_bits == 1)
    154     {
    155         /*Error = Actual bitrate - bits_per_frame * num of frames*/
    156         i4_error_bits = ps_error_bits->i4_bitrate
    157                         - ps_error_bits->i4_accum_bitrate;
    158     }
    159 
    160     return (i4_error_bits);
    161 }
    162 
    163 /* *****************************************************************************
    164  *
    165  * @brief Change the frame rate parameter for the error bits state
    166  *
    167  ******************************************************************************/
    168 void irc_change_frm_rate_in_error_bits(error_bits_t *ps_error_bits,
    169                                        WORD32 i4_tgt_frm_rate)
    170 {
    171     /* Value by which i4_cur_tgt_frm_rate is incremented every VOP*/
    172     ps_error_bits->i4_tgt_frm_rate_incr = (ps_error_bits->i4_max_tgt_frm_rate
    173                                            * 1000) / i4_tgt_frm_rate;
    174     ps_error_bits->i4_tgt_frm_rate = i4_tgt_frm_rate;
    175 }
    176 
    177 /*******************************************************************************
    178  * @brief Change the bitrate value for error bits module
    179  ******************************************************************************/
    180 void irc_change_bitrate_in_error_bits(error_bits_t *ps_error_bits,
    181                                       WORD32 i4_bitrate)
    182 {
    183     ps_error_bits->i4_bitrate = i4_bitrate;
    184 }
    185 
    186