AOMedia AV1 Codec
svc_layercontext.h
1 /*
2  * Copyright (c) 2019, Alliance for Open Media. All Rights Reserved.
3  *
4  * Use of this source code is governed by a BSD-style license
5  * that can be found in the LICENSE file in the root of the source
6  * tree. An additional intellectual property rights grant can be found
7  * in the file PATENTS. All contributing project authors may
8  * be found in the AUTHORS file in the root of the source tree.
9  */
10 
11 #ifndef AOM_AV1_ENCODER_SVC_LAYERCONTEXT_H_
12 #define AOM_AV1_ENCODER_SVC_LAYERCONTEXT_H_
13 
14 #include "av1/encoder/aq_cyclicrefresh.h"
15 #include "av1/encoder/encoder.h"
16 #include "av1/encoder/ratectrl.h"
17 
18 #ifdef __cplusplus
19 extern "C" {
20 #endif
21 
26 typedef struct {
28  RATE_CONTROL rc;
29  int framerate_factor;
30  int64_t layer_target_bitrate;
31  int scaling_factor_num;
32  int scaling_factor_den;
33  int64_t target_bandwidth;
34  int64_t spatial_layer_target_bandwidth;
35  double framerate;
36  int avg_frame_size;
37  int max_q;
38  int min_q;
39  int frames_from_key_frame;
45  int sb_index;
49  int8_t *map;
53  uint8_t *last_coded_q_map;
54 
59 
68 
72  uint8_t speed;
76  unsigned char group_index;
86 
91 typedef struct SVC {
93  int spatial_layer_id;
94  int temporal_layer_id;
95  int number_spatial_layers;
96  int number_temporal_layers;
97  int external_ref_frame_config;
98  int non_reference_frame;
105  int reference[INTER_REFS_PER_FRAME];
107  int ref_idx[INTER_REFS_PER_FRAME];
108  int refresh[REF_FRAMES];
109  double base_framerate;
110  unsigned int current_superframe;
111  unsigned int buffer_time_index[REF_FRAMES];
112  unsigned char buffer_spatial_layer[REF_FRAMES];
113  int skip_mvsearch_last;
114  int skip_mvsearch_gf;
115  int spatial_layer_fb[REF_FRAMES];
116  int temporal_layer_fb[REF_FRAMES];
117  int num_encoded_top_layer;
118  int first_layer_denoise;
125 
130 
136 
141 } SVC;
142 
143 struct AV1_COMP;
144 
155 void av1_init_layer_context(struct AV1_COMP *const cpi);
156 
168 void av1_update_layer_context_change_config(struct AV1_COMP *const cpi,
169  const int64_t target_bandwidth);
170 
183 void av1_update_temporal_layer_framerate(struct AV1_COMP *const cpi);
184 
196 void av1_restore_layer_context(struct AV1_COMP *const cpi);
197 
208 void av1_save_layer_context(struct AV1_COMP *const cpi);
209 
220 void av1_free_svc_cyclic_refresh(struct AV1_COMP *const cpi);
221 
233 void av1_svc_reset_temporal_layers(struct AV1_COMP *const cpi, int is_key);
234 
245 void av1_one_pass_cbr_svc_start_layer(struct AV1_COMP *const cpi);
246 
257 int av1_svc_primary_ref_frame(const struct AV1_COMP *const cpi);
258 
271 void av1_get_layer_resolution(const int width_org, const int height_org,
272  const int num, const int den, int *width_out,
273  int *height_out);
274 #ifdef __cplusplus
275 } // extern "C"
276 #endif
277 
278 #endif // AOM_AV1_ENCODER_SVC_LAYERCONTEXT_H_
Declares top-level encoder structures and functions.
int av1_svc_primary_ref_frame(const struct AV1_COMP *const cpi)
Get primary reference frame for current layer.
void av1_update_temporal_layer_framerate(struct AV1_COMP *const cpi)
Prior to encoding the frame, update framerate-related quantities for the current temporal layer.
Definition: svc_layercontext.c:142
void av1_svc_reset_temporal_layers(struct AV1_COMP *const cpi, int is_key)
Reset on key frame: reset counters, references and buffer updates.
Definition: svc_layercontext.c:301
void av1_restore_layer_context(struct AV1_COMP *const cpi)
Prior to encoding the frame, set the layer context, for the current layer to be encoded,...
Definition: svc_layercontext.c:166
void av1_save_layer_context(struct AV1_COMP *const cpi)
Save the layer context after encoding the frame.
Definition: svc_layercontext.c:213
void av1_init_layer_context(struct AV1_COMP *const cpi)
Initialize layer context data from init_config().
Definition: svc_layercontext.c:23
struct SVC SVC
The stucture of SVC.
void av1_free_svc_cyclic_refresh(struct AV1_COMP *const cpi)
Free the memory used for cyclic refresh in layer context.
Definition: svc_layercontext.c:289
void av1_one_pass_cbr_svc_start_layer(struct AV1_COMP *const cpi)
Before encoding, set resolutions and allocate compressor data.
Definition: svc_layercontext.c:328
void av1_get_layer_resolution(const int width_org, const int height_org, const int num, const int den, int *width_out, int *height_out)
Get resolution for current layer.
Definition: svc_layercontext.c:314
void av1_update_layer_context_change_config(struct AV1_COMP *const cpi, const int64_t target_bandwidth)
Update the layer context from a change_config() call.
Definition: svc_layercontext.c:90
#define AOM_MAX_LAYERS
Definition: aomcx.h:1417
#define AOM_MAX_SS_LAYERS
Definition: aomcx.h:1418
Top level encoder structure.
Definition: encoder.h:2042
The stucture of quantities related to each spatial and temporal layer.
Definition: svc_layercontext.h:26
int actual_num_seg1_blocks
Definition: svc_layercontext.h:58
int sb_index
Definition: svc_layercontext.h:45
int counter_encode_maxq_scene_change
Definition: svc_layercontext.h:67
uint8_t speed
Definition: svc_layercontext.h:72
int actual_num_seg2_blocks
Definition: svc_layercontext.h:63
int max_mv_magnitude
Definition: svc_layercontext.h:84
uint8_t * last_coded_q_map
Definition: svc_layercontext.h:53
int is_key_frame
Definition: svc_layercontext.h:80
unsigned char group_index
Definition: svc_layercontext.h:76
int8_t * map
Definition: svc_layercontext.h:49
Rate Control parameters and status.
Definition: ratectrl.h:118
The stucture of SVC.
Definition: svc_layercontext.h:91
LAYER_CONTEXT layer_context[32]
Definition: svc_layercontext.h:124
int force_zero_mode_spatial_ref
Definition: svc_layercontext.h:140
int reference[INTER_REFS_PER_FRAME]
Definition: svc_layercontext.h:105
InterpFilter downsample_filter_type[4]
Definition: svc_layercontext.h:129
int downsample_filter_phase[4]
Definition: svc_layercontext.h:135