blob: b4d3db286b2f9c6825f2e5e52bee05e66109841f [file] [log] [blame]
* Copyright (c) 2019, Alliance for Open Media. All rights reserved
* This source code is subject to the terms of the BSD 2 Clause License and
* the Alliance for Open Media Patent License 1.0. If the BSD 2 Clause License
* was not distributed with this source code in the LICENSE file, you can
* obtain it at 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
#ifdef __cplusplus
extern "C" {
/*!\cond */
struct AV1_COMP;
struct EncodeFrameParams;
struct EncodeFrameInput;
#include "av1/encoder/encoder.h"
static INLINE BLOCK_SIZE convert_length_to_bsize(int length) {
switch (length) {
case 64: return BLOCK_64X64;
case 32: return BLOCK_32X32;
case 16: return BLOCK_16X16;
case 8: return BLOCK_8X8;
case 4: return BLOCK_4X4;
assert(0 && "Invalid block size for tpl model");
return BLOCK_16X16;
typedef struct AV1TplRowMultiThreadSync {
// Synchronization objects for top-right dependency.
pthread_mutex_t *mutex_;
pthread_cond_t *cond_;
// Buffer to store the macroblock whose encoding is complete.
// num_finished_cols[i] stores the number of macroblocks which finished
// encoding in the ith macroblock row.
int *num_finished_cols;
// Number of extra macroblocks of the top row to be complete for encoding
// of the current macroblock to start. A value of 1 indicates top-right
// dependency.
int sync_range;
// Number of macroblock rows.
int rows;
// Number of threads processing the current tile.
int num_threads_working;
} AV1TplRowMultiThreadSync;
typedef struct AV1TplRowMultiThreadInfo {
// Row synchronization related function pointers.
void (*sync_read_ptr)(AV1TplRowMultiThreadSync *tpl_mt_sync, int r, int c);
void (*sync_write_ptr)(AV1TplRowMultiThreadSync *tpl_mt_sync, int r, int c,
int cols);
} AV1TplRowMultiThreadInfo;
// TODO(jingning): This needs to be cleaned up next.
// TPL stats buffers are prepared for every frame in the GOP,
// including (internal) overlays and (internal) arfs.
// In addition, frames in the lookahead that are outside of the GOP
// are also used.
// Thus it should use
// (gop_length) + (# overlays) + (MAX_LAG_BUFFERS - gop_len) =
// MAX_LAG_BUFFERS + (# overlays)
// 2 * MAX_LAG_BUFFERS is therefore a safe estimate.
// TODO(bohanli): test setting it to 1.5 * MAX_LAG_BUFFER
// The first REF_FRAMES + 1 buffers are reserved.
// tpl_data->tpl_frame starts after REF_FRAMES + 1
typedef struct TplDepStats {
int64_t intra_cost;
int64_t inter_cost;
int64_t srcrf_dist;
int64_t recrf_dist;
int64_t srcrf_rate;
int64_t recrf_rate;
int64_t mc_dep_rate;
int64_t mc_dep_dist;
int ref_frame_index;
int64_t pred_error[INTER_REFS_PER_FRAME];
int64_t mc_count;
int64_t mc_saved;
} TplDepStats;
typedef struct TplDepFrame {
uint8_t is_valid;
TplDepStats *tpl_stats_ptr;
const YV12_BUFFER_CONFIG *gf_picture;
YV12_BUFFER_CONFIG *rec_picture;
int ref_map_index[REF_FRAMES];
int stride;
int width;
int height;
int mi_rows;
int mi_cols;
int base_rdmult;
uint32_t frame_display_index;
} TplDepFrame;
/*!\endcond */
* \brief Params related to temporal dependency model.
typedef struct TplParams {
* Block granularity of tpl score storage.
uint8_t tpl_stats_block_mis_log2;
* Tpl motion estimation block 1d size. tpl_bsize_1d >= 16.
uint8_t tpl_bsize_1d;
* Buffer to store the frame level tpl information for each frame in a gf
* group. tpl_stats_buffer[i] stores the tpl information of ith frame in a gf
* group
TplDepFrame tpl_stats_buffer[MAX_LENGTH_TPL_FRAME_STATS];
* Buffer to store tpl stats at block granularity.
* tpl_stats_pool[i][j] stores the tpl stats of jth block of ith frame in a gf
* group.
TplDepStats *tpl_stats_pool[MAX_LAG_BUFFERS];
* Buffer to store tpl reconstructed frame.
* tpl_rec_pool[i] stores the reconstructed frame of ith frame in a gf group.
* Pointer to tpl_stats_buffer.
TplDepFrame *tpl_frame;
* Scale factors for the current frame.
struct scale_factors sf;
* GF group index of the current frame.
int frame_idx;
* Array of pointers to the frame buffers holding the source frame.
* src_ref_frame[i] stores the pointer to the source frame of the ith
* reference frame type.
const YV12_BUFFER_CONFIG *src_ref_frame[INTER_REFS_PER_FRAME];
* Array of pointers to the frame buffers holding the tpl reconstructed frame.
* ref_frame[i] stores the pointer to the tpl reconstructed frame of the ith
* reference frame type.
* Parameters related to synchronization for top-right dependency in row based
* multi-threading of tpl
AV1TplRowMultiThreadSync tpl_mt_sync;
* Frame border for tpl frame.
int border_in_pixels;
} TplParams;
/*!\brief Implements temporal dependency modelling for a GOP (GF/ARF
* group) and selects between 16 and 32 frame GOP structure.
*\ingroup tpl_modelling
* \param[in] cpi Top - level encoder instance structure
* \param[in] gop_eval Flag if it is in the GOP length decision stage
* \param[in] frame_params Per frame encoding parameters
* \param[in] frame_input Input frame buffers
* \return Indicates whether or not we should use a longer GOP length.
int av1_tpl_setup_stats(struct AV1_COMP *cpi, int gop_eval,
const struct EncodeFrameParams *const frame_params,
const struct EncodeFrameInput *const frame_input);
/*!\cond */
int av1_tpl_ptr_pos(int mi_row, int mi_col, int stride, uint8_t right_shift);
void av1_tpl_rdmult_setup(struct AV1_COMP *cpi);
void av1_tpl_rdmult_setup_sb(struct AV1_COMP *cpi, MACROBLOCK *const x,
BLOCK_SIZE sb_size, int mi_row, int mi_col);
void av1_mc_flow_dispenser_row(struct AV1_COMP *cpi, MACROBLOCK *x, int mi_row,
BLOCK_SIZE bsize, TX_SIZE tx_size);
/*!\endcond */
#ifdef __cplusplus
} // extern "C"