AOMedia AV1 Codec
encode_strategy.h
Go to the documentation of this file.
1/*
2 * Copyright (c) 2019, Alliance for Open Media. All rights reserved
3 *
4 * This source code is subject to the terms of the BSD 2 Clause License and
5 * the Alliance for Open Media Patent License 1.0. If the BSD 2 Clause License
6 * was not distributed with this source code in the LICENSE file, you can
7 * obtain it at www.aomedia.org/license/software. If the Alliance for Open
8 * Media Patent License 1.0 was not distributed with this source code in the
9 * PATENTS file, you can obtain it at www.aomedia.org/license/patent.
10 */
11
15#ifndef AOM_AV1_ENCODER_ENCODE_STRATEGY_H_
16#define AOM_AV1_ENCODER_ENCODE_STRATEGY_H_
17
18#ifdef __cplusplus
19extern "C" {
20#endif
21
22#include <stdint.h>
23
24#include "aom/aom_encoder.h"
25
26#include "av1/encoder/encoder.h"
27#include "av1/encoder/firstpass.h"
28
55int av1_encode_strategy(AV1_COMP *const cpi, size_t *const size,
56 uint8_t *const dest, unsigned int *frame_flags,
57 int64_t *const time_stamp, int64_t *const time_end,
58 const aom_rational64_t *const timestamp_ratio,
59 int *const pop_lookahead, int flush);
60
62// Set individual buffer update flags based on frame reference type.
63// force_refresh_all is used when we have a KEY_FRAME or S_FRAME. It forces all
64// refresh_*_frame flags to be set, because we refresh all buffers in this case.
65void av1_configure_buffer_updates(AV1_COMP *const cpi,
66 RefreshFrameInfo *const refresh_frame,
67 const FRAME_UPDATE_TYPE type,
68 const REFBUF_STATE refbuf_state,
69 int force_refresh_all);
70
71int av1_get_refresh_frame_flags(const AV1_COMP *const cpi,
72 const EncodeFrameParams *const frame_params,
73 FRAME_UPDATE_TYPE frame_update_type,
74 int gf_index,
75#if CONFIG_FRAME_PARALLEL_ENCODE
76 int cur_disp_order,
77 RefFrameMapPair ref_frame_map_pairs[REF_FRAMES],
78#endif // CONFIG_FRAME_PARALLEL_ENCODE
79 const RefBufferStack *const ref_buffer_stack);
80
81int av1_get_refresh_ref_frame_map(int refresh_frame_flags);
82
83void av1_update_ref_frame_map(const AV1_COMP *cpi,
84 FRAME_UPDATE_TYPE frame_update_type,
85 REFBUF_STATE refbuf_state, int ref_map_index,
86 RefBufferStack *ref_buffer_stack);
87
100void av1_get_ref_frames(const RefBufferStack *ref_buffer_stack,
101#if CONFIG_FRAME_PARALLEL_ENCODE
102 RefFrameMapPair ref_frame_map_pairs[REF_FRAMES],
103 int cur_frame_disp,
104#if CONFIG_FRAME_PARALLEL_ENCODE_2
105 const AV1_COMP *cpi, int gf_index,
106 int is_parallel_encode,
107#endif // CONFIG_FRAME_PARALLEL_ENCODE_2
108#endif // CONFIG_FRAME_PARALLEL_ENCODE
109 int remapped_ref_idx[REF_FRAMES]);
110
111int is_forced_keyframe_pending(struct lookahead_ctx *lookahead,
112 const int up_to_index,
113 const COMPRESSOR_STAGE compressor_stage);
114
115static AOM_INLINE int is_frame_droppable(
116 const SVC *const svc,
117 const ExtRefreshFrameFlagsInfo *const ext_refresh_frame_flags) {
118 // Droppable frame is only used by external refresh flags. VoD setting won't
119 // trigger its use case.
120 if (svc->set_ref_frame_config)
121 return svc->non_reference_frame;
122 else if (ext_refresh_frame_flags->update_pending)
123 return !(ext_refresh_frame_flags->alt_ref_frame ||
124 ext_refresh_frame_flags->alt2_ref_frame ||
125 ext_refresh_frame_flags->bwd_ref_frame ||
126 ext_refresh_frame_flags->golden_frame ||
127 ext_refresh_frame_flags->last_frame);
128 else
129 return 0;
130}
131
132static AOM_INLINE int get_current_frame_ref_type(const AV1_COMP *const cpi) {
133 // We choose the reference "type" of this frame from the flags which indicate
134 // which reference frames will be refreshed by it. More than one of these
135 // flags may be set, so the order here implies an order of precedence. This is
136 // just used to choose the primary_ref_frame (as the most recent reference
137 // buffer of the same reference-type as the current frame).
138
139 switch (cpi->ppi->gf_group.layer_depth[cpi->gf_frame_index]) {
140 case 0: return 0;
141 case 1: return 1;
142 case MAX_ARF_LAYERS:
143 case MAX_ARF_LAYERS + 1: return 4;
144 default: return 7;
145 }
146}
147
148#if CONFIG_FRAME_PARALLEL_ENCODE
149#if CONFIG_FRAME_PARALLEL_ENCODE_2
150int av1_calc_refresh_idx_for_intnl_arf(
151 AV1_COMP *cpi, RefFrameMapPair ref_frame_map_pairs[REF_FRAMES],
152 int gf_index);
153#endif // CONFIG_FRAME_PARALLEL_ENCODE_2
154#endif // CONFIG_FRAME_PARALLEL_ENCODE
156#ifdef __cplusplus
157} // extern "C"
158#endif
159
160#endif // AOM_AV1_ENCODER_ENCODE_STRATEGY_H_
Describes the encoder algorithm interface to applications.
Declares top-level encoder structures and functions.
int av1_encode_strategy(AV1_COMP *const cpi, size_t *const size, uint8_t *const dest, unsigned int *frame_flags, int64_t *const time_stamp, int64_t *const time_end, const aom_rational64_t *const timestamp_ratio, int *const pop_lookahead, int flush)
Implement high-level encode strategy.
The stucture of SVC.
Definition svc_layercontext.h:87