granicus.if.org Git - libvpx/blob - vp9/encoder/vp9_svc_layercontext.h

   1 /*
   2  *  Copyright (c) 2014 The WebM project authors. 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 VP9_ENCODER_VP9_SVC_LAYERCONTEXT_H_
  12 #define VP9_ENCODER_VP9_SVC_LAYERCONTEXT_H_
  13
  14 #include "vpx/vpx_encoder.h"
  15
  16 #include "vp9/encoder/vp9_ratectrl.h"
  17
  18 #ifdef __cplusplus
  19 extern "C" {
  20 #endif
  21
  22 typedef struct {
  23   RATE_CONTROL rc;
  24   int target_bandwidth;
  25   int spatial_layer_target_bandwidth;  // Target for the spatial layer.
  26   double framerate;
  27   int avg_frame_size;
  28   int max_q;
  29   int min_q;
  30   int scaling_factor_num;
  31   int scaling_factor_den;
  32   TWO_PASS twopass;
  33   vpx_fixed_buf_t rc_twopass_stats_in;
  34   unsigned int current_video_frame_in_layer;
  35   int is_key_frame;
  36   int frames_from_key_frame;
  37   FRAME_TYPE last_frame_type;
  38   struct lookahead_entry *alt_ref_source;
  39   int alt_ref_idx;
  40   int gold_ref_idx;
  41   int has_alt_frame;
  42   size_t layer_size;
  43   struct vpx_psnr_pkt psnr_pkt;
  44   // Cyclic refresh parameters (aq-mode=3), that need to be updated per-frame.
  45   int sb_index;
  46   signed char *map;
  47   uint8_t *last_coded_q_map;
  48   uint8_t *consec_zero_mv;
  49   uint8_t speed;
  50 } LAYER_CONTEXT;
  51
  52 typedef struct {
  53   int spatial_layer_id;
  54   int temporal_layer_id;
  55   int number_spatial_layers;
  56   int number_temporal_layers;
  57
  58   int spatial_layer_to_encode;
  59   int first_spatial_layer_to_encode;
  60   int rc_drop_superframe;
  61
  62   // Workaround for multiple frame contexts
  63   enum { ENCODED = 0, ENCODING, NEED_TO_ENCODE } encode_empty_frame_state;
  64   struct lookahead_entry empty_frame;
  65   int encode_intra_empty_frame;
  66
  67   // Store scaled source frames to be used for temporal filter to generate
  68   // a alt ref frame.
  69   YV12_BUFFER_CONFIG scaled_frames[MAX_LAG_BUFFERS];
  70   // Temp buffer used for 2-stage down-sampling, for real-time mode.
  71   YV12_BUFFER_CONFIG scaled_temp;
  72   int scaled_one_half;
  73   int scaled_temp_is_alloc;
  74
  75   // Layer context used for rate control in one pass temporal CBR mode or
  76   // two pass spatial mode.
  77   LAYER_CONTEXT layer_context[VPX_MAX_LAYERS];
  78   // Indicates what sort of temporal layering is used.
  79   // Currently, this only works for CBR mode.
  80   VP9E_TEMPORAL_LAYERING_MODE temporal_layering_mode;
  81   // Frame flags and buffer indexes for each spatial layer, set by the
  82   // application (external settings).
  83   int ext_frame_flags[VPX_MAX_LAYERS];
  84   int ext_lst_fb_idx[VPX_MAX_LAYERS];
  85   int ext_gld_fb_idx[VPX_MAX_LAYERS];
  86   int ext_alt_fb_idx[VPX_MAX_LAYERS];
  87   int ref_frame_index[REF_FRAMES];
  88   int force_zero_mode_spatial_ref;
  89   int current_superframe;
  90   int use_base_mv;
  91   // Used to control the downscaling filter for source scaling, for 1 pass CBR.
  92   // downsample_filter_phase: = 0 will do sub-sampling (no weighted average),
  93   // = 8 will center the target pixel and get a symmetric averaging filter.
  94   // downsample_filter_type: 4 filters may be used: eighttap_regular,
  95   // eighttap_smooth, eighttap_sharp, and bilinear.
  96   INTERP_FILTER downsample_filter_type[VPX_SS_MAX_LAYERS];
  97   int downsample_filter_phase[VPX_SS_MAX_LAYERS];
  98 } SVC;
  99
 100 struct VP9_COMP;
 101
 102 // Initialize layer context data from init_config().
 103 void vp9_init_layer_context(struct VP9_COMP *const cpi);
 104
 105 // Update the layer context from a change_config() call.
 106 void vp9_update_layer_context_change_config(struct VP9_COMP *const cpi,
 107                                             const int target_bandwidth);
 108
 109 // Prior to encoding the frame, update framerate-related quantities
 110 // for the current temporal layer.
 111 void vp9_update_temporal_layer_framerate(struct VP9_COMP *const cpi);
 112
 113 // Update framerate-related quantities for the current spatial layer.
 114 void vp9_update_spatial_layer_framerate(struct VP9_COMP *const cpi,
 115                                         double framerate);
 116
 117 // Prior to encoding the frame, set the layer context, for the current layer
 118 // to be encoded, to the cpi struct.
 119 void vp9_restore_layer_context(struct VP9_COMP *const cpi);
 120
 121 // Save the layer context after encoding the frame.
 122 void vp9_save_layer_context(struct VP9_COMP *const cpi);
 123
 124 // Initialize second pass rc for spatial svc.
 125 void vp9_init_second_pass_spatial_svc(struct VP9_COMP *cpi);
 126
 127 // Increment number of video frames in layer
 128 void vp9_inc_frame_in_layer(struct VP9_COMP *const cpi);
 129
 130 // Check if current layer is key frame in spatial upper layer
 131 int vp9_is_upper_layer_key_frame(const struct VP9_COMP *const cpi);
 132
 133 // Get the next source buffer to encode
 134 struct lookahead_entry *vp9_svc_lookahead_pop(struct VP9_COMP *const cpi,
 135                                               struct lookahead_ctx *ctx,
 136                                               int drain);
 137
 138 // Start a frame and initialize svc parameters
 139 int vp9_svc_start_frame(struct VP9_COMP *const cpi);
 140
 141 int vp9_one_pass_cbr_svc_start_layer(struct VP9_COMP *const cpi);
 142
 143 void vp9_free_svc_cyclic_refresh(struct VP9_COMP *const cpi);
 144
 145 void vp9_svc_reset_key_frame(struct VP9_COMP *const cpi);
 146
 147 #ifdef __cplusplus
 148 }  // extern "C"
 149 #endif
 150
 151 #endif  // VP9_ENCODER_VP9_SVC_LAYERCONTEXT_