Functions
static void	calculate_gf_length (AV1_COMP *cpi, int max_gop_length, int max_intervals)
	Determine the length of future GF groups.

static void	define_gf_group_pass0 (AV1_COMP *cpi)
	Define a GF group in one pass mode when no look ahead stats are available.

static void	define_gf_group (AV1_COMP cpi, EncodeFrameParams frame_params, int is_final_pass)
	Define a GF group.

static int	define_kf_interval (AV1_COMP cpi, const FIRSTPASS_INFO firstpass_info, int num_frames_to_detect_scenecut, int search_start_idx)
	Determine the location of the next key frame.

static void	find_next_key_frame (AV1_COMP cpi, FIRSTPASS_STATS this_frame)
	Determine the next key frame group.

Detailed Description

Algorithms regarding determining the length of GF groups and defining GF group structures.

Function Documentation

◆ calculate_gf_length()

static void calculate_gf_length	(	AV1_COMP *	cpi,
		int	max_gop_length,
		int	max_intervals )

static

Determine the length of future GF groups.

This function decides the gf group length of future frames in batch

Parameters

[in]	cpi	Top-level encoder structure
[in]	max_gop_length	Maximum length of the GF group
[in]	max_intervals	Maximum number of intervals to decide

Remarks: Nothing is returned. Instead, cpi->ppi->rc.gf_intervals is changed to store the decided GF group lengths.

References AV1_COMP::common, FIRSTPASS_STATS::cor_coeff, PRIMARY_RATE_CONTROL::cur_gf_index, RATE_CONTROL::frames_to_key, PRIMARY_RATE_CONTROL::gf_intervals, AV1_PRIMARY::gf_state, has_no_stats_stage(), AV1Common::height, RATE_CONTROL::intervals_till_gf_calculate_due, AV1_PRIMARY::lap_enabled, FIRSTPASS_STATS::noise_var, AV1_PRIMARY::p_rc, AV1_COMP::ppi, AV1_COMP::rc, AV1_PRIMARY::twopass, AV1_COMP::twopass_frame, and AV1Common::width.

Referenced by av1_get_second_pass_params().

◆ define_gf_group_pass0()

static void define_gf_group_pass0 ( AV1_COMP * cpi )

static

Define a GF group in one pass mode when no look ahead stats are available.

This function defines the structure of a GF group, along with various parameters regarding bit-allocation and quality setup in the special case of one pass encoding where no lookahead stats are avialable.

Parameters

[in] cpi Top-level encoder structure

Remarks: Nothing is returned. Instead, cpi->ppi->gf_group is changed.

References AOM_CBR, av1_cyclic_refresh_set_golden_update(), av1_gop_setup_structure(), PRIMARY_RATE_CONTROL::cur_gf_index, RATE_CONTROL::frames_to_key, AV1_PRIMARY::gf_group, PRIMARY_RATE_CONTROL::gf_intervals, PRIMARY_RATE_CONTROL::gfu_boost, RATE_CONTROL::intervals_till_gf_calculate_due, RateControlCfg::mode, AV1_COMP::oxcf, AV1_PRIMARY::p_rc, AV1_COMP::ppi, AV1_COMP::rc, and AV1EncoderConfig::rc_cfg.

Referenced by define_gf_group().

◆ define_gf_group()

static void define_gf_group	(	AV1_COMP *	cpi,
		EncodeFrameParams *	frame_params,
		int	is_final_pass )

static

Define a GF group.

This function defines the structure of a GF group, along with various parameters regarding bit-allocation and quality setup.

Parameters

[in]	cpi	Top-level encoder structure
[in]	frame_params	Structure with frame parameters
[in]	is_final_pass	Whether this is the final pass for the GF group, or a trial (non-zero)

Remarks: Nothing is returned. Instead, cpi->ppi->gf_group is changed.

References AOM_Q, AOM_RC_THIRD_PASS, av1_gop_setup_structure(), AV1_COMP::common, RateControlCfg::cq_level, PRIMARY_RATE_CONTROL::cur_gf_index, define_gf_group_pass0(), EncodeFrameParams::frame_type, RATE_CONTROL::frames_to_key, AV1_COMP::gf_frame_index, AV1_PRIMARY::gf_group, PRIMARY_RATE_CONTROL::gf_intervals, has_no_stats_stage(), AV1Common::height, AV1_PRIMARY::internal_altref_allowed, RATE_CONTROL::intervals_till_gf_calculate_due, AV1_PRIMARY::lap_enabled, RateControlCfg::mode, AV1_COMP::oxcf, AV1_PRIMARY::p_rc, AV1EncoderConfig::pass, AV1_COMP::ppi, AV1_COMP::rc, AV1EncoderConfig::rc_cfg, EncodeFrameParams::show_frame, AV1_PRIMARY::twopass, AV1_COMP::twopass_frame, and AV1Common::width.

Referenced by av1_get_second_pass_params().

◆ define_kf_interval()

static int define_kf_interval	(	AV1_COMP *	cpi,
		const FIRSTPASS_INFO *	firstpass_info,
		int	num_frames_to_detect_scenecut,
		int	search_start_idx )

static

Determine the location of the next key frame.

This function decides the placement of the next key frame when a scenecut is detected or the maximum key frame distance is reached.

Parameters

[in]	cpi	Top-level encoder structure
[in]	firstpass_info	struct for firstpass info
[in]	num_frames_to_detect_scenecut	Maximum lookahead frames.
[in]	search_start_idx	the start index for searching key frame. Set it to one if we already know the current frame is key frame. Otherwise, set it to zero.