blob: 6a8c91e27babe8a5f1db17a1457254a08ca5066f [file] [log] [blame] [edit]
/*
* Copyright (c) 2021, Alliance for Open Media. All rights reserved
*
* This source code is subject to the terms of the BSD 3-Clause Clear License
* and the Alliance for Open Media Patent License 1.0. If the BSD 3-Clause Clear
* License was not distributed with this source code in the LICENSE file, you
* can obtain it at aomedia.org/license/software-license/bsd-3-c-c/. If the
* Alliance for Open Media Patent License 1.0 was not distributed with this
* source code in the PATENTS file, you can obtain it at
* aomedia.org/license/patent-license/.
*/
#ifndef AOM_AV1_ENCODER_PASS2_STRATEGY_H_
#define AOM_AV1_ENCODER_PASS2_STRATEGY_H_
#ifdef __cplusplus
extern "C" {
#endif
struct AV1_COMP;
struct EncodeFrameParams;
/*!\endcond */
/*!
* \brief accumulated stats and features in a gf group
*/
typedef struct {
/*!\cond */
double gf_group_err;
double gf_group_raw_error;
double gf_group_skip_pct;
double gf_group_inactive_zone_rows;
double mv_ratio_accumulator;
double decay_accumulator;
double zero_motion_accumulator;
double loop_decay_rate;
double last_loop_decay_rate;
double this_frame_mv_in_out;
double mv_in_out_accumulator;
double abs_mv_in_out_accumulator;
double avg_sr_coded_error;
double avg_tr_coded_error;
double avg_pcnt_second_ref;
double avg_pcnt_third_ref;
double avg_pcnt_third_ref_nolast;
double avg_new_mv_count;
double avg_wavelet_energy;
double avg_raw_err_stdev;
int non_zero_stdev_count;
/*!\endcond */
} GF_GROUP_STATS;
/*!
* \brief accumulated stats and features for a frame
*/
typedef struct {
/*!\cond */
double frame_err;
double frame_coded_error;
double frame_sr_coded_error;
double frame_tr_coded_error;
/*!\endcond */
} GF_FRAME_STATS;
/*!cond */
void av1_init_single_pass_lap(AV1_COMP *cpi);
/*!\endcond */
/*!\brief Main per frame entry point for second pass of two pass encode
*
*\ingroup rate_control
*
* This function is called for each frame in the second pass of a two pass
* encode. It checks the frame type and if a new KF or GF/ARF is due.
* When a KF is due it calls find_next_key_frame() to work out how long
* this key frame group will be and assign bits to the key frame.
* At the start of a new GF/ARF group it calls calculate_gf_length()
* and define_gf_group() which are the main functions responsible for
* defining the size and structure of the new GF/ARF group.
*
* \param[in] cpi Top - level encoder instance structure
* \param[in] frame_params Per frame encoding parameters
*
* \return No return but analyses first pass stats and assigns a target
* number of bits to the current frame and a target Q range.
*/
void av1_get_second_pass_params(struct AV1_COMP *cpi,
struct EncodeFrameParams *const frame_params);
/*!\brief Adjustments to two pass and rate control after each frame.
*
*\ingroup rate_control
*
* This function is called after each frame to make adjustments to
* heuristics and data structures that relate to rate control.
*
* \param[in] cpi Top - level encoder instance structure
*
* \return No return value but this function updates various rate control
* related data structures that for example track overshoot and
* undershoot.
*/
void av1_twopass_postencode_update(struct AV1_COMP *cpi);
/*!\brief Distributes bits to frames in a group
*
*\ingroup rate_control
*
* This function decides on the allocation of bits between the different
* frames and types of frame in a GF/ARF group.
*
* \param[in] cpi Top - level encoder instance structure
* \param[in] rc Rate control data
* \param[in] gf_group GF/ARF group data structure
* \param[in] is_key_frame Indicates if the first frame in the group is
* also a key frame.
* \param[in] use_arf Are ARF frames enabled or is this a GF only
* uni-directional group.
* \param[in] gf_group_bits Bits available to be allocated.
*
* \return No return but updates the rate control and group data structures
* to reflect the allocation of bits.
*/
void av1_gop_bit_allocation(const AV1_COMP *cpi, RATE_CONTROL *const rc,
GF_GROUP *gf_group, int is_key_frame, int use_arf,
int64_t gf_group_bits);
#ifdef __cplusplus
} // extern "C"
#endif
#endif // AOM_AV1_ENCODER_PASS2_STRATEGY_H_