diff mbox series

[FFmpeg-devel,v4] avcodec/libvpxenc: add a way to set VP9E_SET_SVC_REF_FRAME_CONFIG

Message ID 20201229195153.1871025-1-wonkap@google.com
State Superseded
Headers show
Series [FFmpeg-devel,v4] avcodec/libvpxenc: add a way to set VP9E_SET_SVC_REF_FRAME_CONFIG
Related show

Checks

Context Check Description
andriy/x86_make success Make finished
andriy/x86_make_fate success Make fate finished
andriy/PPC64_make success Make finished
andriy/PPC64_make_fate success Make fate finished

Commit Message

Wonkap Jang Dec. 29, 2020, 7:51 p.m. UTC
In order to fine-control referencing schemes in VP9 encoding, there
is a need to use VP9E_SET_SVC_REF_FRAME_CONFIG method. This commit
provides a way to use the API through frame metadata.
---
 doc/encoders.texi      | 32 +++++++++++++++++
 libavcodec/libvpxenc.c | 81 ++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 113 insertions(+)

Comments

Wonkap Jang Dec. 29, 2020, 7:54 p.m. UTC | #1
Hi James,

On Tue, Dec 29, 2020 at 11:51 AM Wonkap Jang <wonkap@google.com> wrote:

> In order to fine-control referencing schemes in VP9 encoding, there
> is a need to use VP9E_SET_SVC_REF_FRAME_CONFIG method. This commit
> provides a way to use the API through frame metadata.
> ---
>  doc/encoders.texi      | 32 +++++++++++++++++
>  libavcodec/libvpxenc.c | 81 ++++++++++++++++++++++++++++++++++++++++++
>  2 files changed, 113 insertions(+)
>
> diff --git a/doc/encoders.texi b/doc/encoders.texi
> index 0b1c69e982..11cf4d89d0 100644
> --- a/doc/encoders.texi
> +++ b/doc/encoders.texi
> @@ -2129,6 +2129,38 @@ midpoint is passed in rather than calculated for a
> specific clip or chunk.
>  The valid range is [0, 10000]. 0 (default) uses standard VBR.
>  @item enable-tpl @var{boolean}
>  Enable temporal dependency model.
> +@item ref-frame-config
> +Using per-frame metadata, set members of the structure
> @code{vpx_svc_ref_frame_config_t} in @code{vpx/vp8cx.h} to fine-control
> referencing schemes and frame buffer management.
> +@*Use a :-separated list of key=value pairs.
> +For example,
> +@example
> +av_dict_set(&av_frame->metadata, "ref-frame-config", \
>
> +"rfc_update_buffer_slot=7:rfc_lst_fb_idx=0:rfc_gld_fb_idx=1:rfc_alt_fb_idx=2:rfc_reference_last=0:rfc_reference_golden=0:rfc_reference_alt_ref=0");
> +@end example
> +@table @option
> +@item rfc_update_buffer_slot
> +Indicates the buffer slot number to update
> +@item rfc_update_last
> +Indicates whether to update the LAST frame
> +@item rfc_update_golden
> +Indicates whether to update GOLDEN frame
> +@item rfc_update_alt_ref
> +Indicates whether to update ALT_REF frame
> +@item rfc_lst_fb_idx
> +LAST frame buffer index
> +@item rfc_gld_fb_idx
> +GOLDEN frame buffer index
> +@item rfc_alt_fb_idx
> +ALT_REF frame buffer index
> +@item rfc_reference_last
> +Indicates whetehr to reference LAST frame
> +@item rfc_reference_golden
> +Indicates whether to reference GOLDEN frame
> +@item rfc_reference_alt_ref
> +Indicates whether to reference ALT_REF frame
> +@item rfc_reference_duration
> +Indicates frame duration
> +@end table
>  @end table
>
>  @end table
> diff --git a/libavcodec/libvpxenc.c b/libavcodec/libvpxenc.c
> index a7c76eb835..4943a9e32c 100644
> --- a/libavcodec/libvpxenc.c
> +++ b/libavcodec/libvpxenc.c
> @@ -125,6 +125,10 @@ typedef struct VPxEncoderContext {
>       * encounter a frame with ROI side data.
>       */
>      int roi_warned;
> +#if CONFIG_LIBVPX_VP9_ENCODER && defined
> (VPX_CTRL_VP9E_SET_MAX_INTER_BITRATE_PCT)
> +    vpx_svc_ref_frame_config_t ref_frame_config;
> +    AVDictionary *vpx_ref_frame_config;
> +#endif
>  } VPxContext;
>
>  /** String mappings for enum vp8e_enc_control_id */
> @@ -152,6 +156,7 @@ static const char *const ctlidstr[] = {
>      [VP9E_SET_SVC_LAYER_ID]            = "VP9E_SET_SVC_LAYER_ID",
>  #if VPX_ENCODER_ABI_VERSION >= 12
>      [VP9E_SET_SVC_PARAMETERS]          = "VP9E_SET_SVC_PARAMETERS",
> +    [VP9E_SET_SVC_REF_FRAME_CONFIG]    = "VP9E_SET_SVC_REF_FRAME_CONFIG",
>  #endif
>      [VP9E_SET_SVC]                     = "VP9E_SET_SVC",
>  #if VPX_ENCODER_ABI_VERSION >= 11
> @@ -394,6 +399,21 @@ static void vp8_ts_parse_int_array(int *dest, char
> *value, size_t value_len, int
>      }
>  }
>
> +#if CONFIG_LIBVPX_VP9_ENCODER && defined
> (VPX_CTRL_VP9E_SET_MAX_INTER_BITRATE_PCT)
> +static void vp8_ts_parse_int64_array(int64_t *dest, char *value, size_t
> value_len, int max_entries)
> +{
> +    int dest_idx = 0;
> +    char *saveptr = NULL;
> +    char *token = av_strtok(value, ",", &saveptr);
> +
> +    while (token && dest_idx < max_entries) {
> +        dest[dest_idx++] = strtoul(token, NULL, 10);
> +        token = av_strtok(NULL, ",", &saveptr);
> +    }
> +}
> +
> +#endif
> +
>  static void set_temporal_layer_pattern(int layering_mode,
> vpx_codec_enc_cfg_t *cfg,
>                                         int *layer_flags, int
> *flag_periodicity)
>  {
> @@ -541,6 +561,49 @@ static int vpx_ts_param_parse(VPxContext *ctx, struct
> vpx_codec_enc_cfg *enccfg,
>      return 0;
>  }
>
> +#if CONFIG_LIBVPX_VP9_ENCODER && defined
> (VPX_CTRL_VP9E_SET_MAX_INTER_BITRATE_PCT)
> +static int vpx_ref_frame_config_parse(VPxContext *ctx, const struct
> vpx_codec_enc_cfg *enccfg,
> +                              char *key, char *value, enum AVCodecID
> codec_id)
> +{
> +    size_t value_len = strlen(value);
> +    int ss_number_layers = enccfg->ss_number_layers;
> +    vpx_svc_ref_frame_config_t *ref_frame_config = &ctx->ref_frame_config;
> +
> +    if (!value_len)
> +        return -1;
> +
> +    if (codec_id != AV_CODEC_ID_VP9)
> +        return -1;
> +
> +    if (!strcmp(key, "rfc_update_buffer_slot")) {
> +        vp8_ts_parse_int_array(ref_frame_config->update_buffer_slot,
> value, value_len, ss_number_layers);
> +    } else if (!strcmp(key, "rfc_update_last")) {
> +        vp8_ts_parse_int_array(ref_frame_config->update_last, value,
> value_len, ss_number_layers);
> +    } else if (!strcmp(key, "rfc_update_golden")) {
> +        vp8_ts_parse_int_array(ref_frame_config->update_golden, value,
> value_len, ss_number_layers);
> +    } else if (!strcmp(key, "rfc_update_alt_ref")) {
> +        vp8_ts_parse_int_array(ref_frame_config->update_alt_ref, value,
> value_len, ss_number_layers);
> +    } else if (!strcmp(key, "rfc_lst_fb_idx")) {
> +        vp8_ts_parse_int_array(ref_frame_config->lst_fb_idx, value,
> value_len, ss_number_layers);
> +    } else if (!strcmp(key, "rfc_gld_fb_idx")) {
> +        vp8_ts_parse_int_array(ref_frame_config->gld_fb_idx, value,
> value_len, ss_number_layers);
> +    } else if (!strcmp(key, "rfc_alt_fb_idx")) {
> +        vp8_ts_parse_int_array(ref_frame_config->alt_fb_idx, value,
> value_len, ss_number_layers);
> +    } else if (!strcmp(key, "rfc_reference_last")) {
> +        vp8_ts_parse_int_array(ref_frame_config->reference_last, value,
> value_len, ss_number_layers);
> +    } else if (!strcmp(key, "rfc_reference_golden")) {
> +        vp8_ts_parse_int_array(ref_frame_config->reference_golden, value,
> value_len, ss_number_layers);
> +    } else if (!strcmp(key, "rfc_reference_alt_ref")) {
> +        vp8_ts_parse_int_array(ref_frame_config->reference_alt_ref,
> value, value_len, ss_number_layers);
> +    } else if (!strcmp(key, "rfc_reference_duration")) {
> +        vp8_ts_parse_int64_array(ref_frame_config->duration, value,
> value_len, ss_number_layers);
> +    }
> +
> +    return 0;
> +}
> +#endif
> +
> +
>  #if CONFIG_LIBVPX_VP9_ENCODER
>  static int set_pix_fmt(AVCodecContext *avctx, vpx_codec_caps_t codec_caps,
>                         struct vpx_codec_enc_cfg *enccfg,
> vpx_codec_flags_t *flags,
> @@ -1528,6 +1591,24 @@ static int vpx_encode(AVCodecContext *avctx,
> AVPacket *pkt,
>  #endif
>                  layer_id_valid = 1;
>              }
> +#if CONFIG_LIBVPX_VP9_ENCODER && defined
> (VPX_CTRL_VP9E_SET_MAX_INTER_BITRATE_PCT)
> +            en = av_dict_get(frame->metadata, "ref-frame-config", NULL,
> 0);
> +
> +            if (en) {
> +                AVDictionaryEntry* en2 = NULL;
> +                av_dict_parse_string(&ctx->vpx_ref_frame_config,
> en->value, "=", ":", 0);
> +
> +                while ((en2 = av_dict_get(ctx->vpx_ref_frame_config, "",
> en2, AV_DICT_IGNORE_SUFFIX))) {
> +                    if (vpx_ref_frame_config_parse(ctx, enccfg, en2->key,
> en2->value, avctx->codec_id) < 0)
> +                        av_log(avctx, AV_LOG_WARNING,
> +                               "Error parsing option '%s = %s'.\n",
> +                               en2->key, en2->value);
> +                }
> +
> +                codecctl_intp(avctx, VP9E_SET_SVC_REF_FRAME_CONFIG, (int
> *)&ctx->ref_frame_config);
> +            }
> +#endif
> +
>          }
>
>          if (sd) {
> --
> 2.29.2.729.g45daf8777d-goog
>
> I found one more warning in docs. Please take a look at the change.

Happy holidays to you,

Wonkap
Wonkap Jang Jan. 6, 2021, 4:52 p.m. UTC | #2
HI JAmes,

On Tue, Dec 29, 2020 at 11:54 AM Wonkap Jang <
wonkap-at-google.com@ffmpeg.org> wrote:

> Hi James,
>
> On Tue, Dec 29, 2020 at 11:51 AM Wonkap Jang <wonkap@google.com> wrote:
>
> > In order to fine-control referencing schemes in VP9 encoding, there
> > is a need to use VP9E_SET_SVC_REF_FRAME_CONFIG method. This commit
> > provides a way to use the API through frame metadata.
> > ---
> >  doc/encoders.texi      | 32 +++++++++++++++++
> >  libavcodec/libvpxenc.c | 81 ++++++++++++++++++++++++++++++++++++++++++
> >  2 files changed, 113 insertions(+)
> >
> > diff --git a/doc/encoders.texi b/doc/encoders.texi
> > index 0b1c69e982..11cf4d89d0 100644
> > --- a/doc/encoders.texi
> > +++ b/doc/encoders.texi
> > @@ -2129,6 +2129,38 @@ midpoint is passed in rather than calculated for a
> > specific clip or chunk.
> >  The valid range is [0, 10000]. 0 (default) uses standard VBR.
> >  @item enable-tpl @var{boolean}
> >  Enable temporal dependency model.
> > +@item ref-frame-config
> > +Using per-frame metadata, set members of the structure
> > @code{vpx_svc_ref_frame_config_t} in @code{vpx/vp8cx.h} to fine-control
> > referencing schemes and frame buffer management.
> > +@*Use a :-separated list of key=value pairs.
> > +For example,
> > +@example
> > +av_dict_set(&av_frame->metadata, "ref-frame-config", \
> >
> >
> +"rfc_update_buffer_slot=7:rfc_lst_fb_idx=0:rfc_gld_fb_idx=1:rfc_alt_fb_idx=2:rfc_reference_last=0:rfc_reference_golden=0:rfc_reference_alt_ref=0");
> > +@end example
> > +@table @option
> > +@item rfc_update_buffer_slot
> > +Indicates the buffer slot number to update
> > +@item rfc_update_last
> > +Indicates whether to update the LAST frame
> > +@item rfc_update_golden
> > +Indicates whether to update GOLDEN frame
> > +@item rfc_update_alt_ref
> > +Indicates whether to update ALT_REF frame
> > +@item rfc_lst_fb_idx
> > +LAST frame buffer index
> > +@item rfc_gld_fb_idx
> > +GOLDEN frame buffer index
> > +@item rfc_alt_fb_idx
> > +ALT_REF frame buffer index
> > +@item rfc_reference_last
> > +Indicates whetehr to reference LAST frame
> > +@item rfc_reference_golden
> > +Indicates whether to reference GOLDEN frame
> > +@item rfc_reference_alt_ref
> > +Indicates whether to reference ALT_REF frame
> > +@item rfc_reference_duration
> > +Indicates frame duration
> > +@end table
> >  @end table
> >
> >  @end table
> > diff --git a/libavcodec/libvpxenc.c b/libavcodec/libvpxenc.c
> > index a7c76eb835..4943a9e32c 100644
> > --- a/libavcodec/libvpxenc.c
> > +++ b/libavcodec/libvpxenc.c
> > @@ -125,6 +125,10 @@ typedef struct VPxEncoderContext {
> >       * encounter a frame with ROI side data.
> >       */
> >      int roi_warned;
> > +#if CONFIG_LIBVPX_VP9_ENCODER && defined
> > (VPX_CTRL_VP9E_SET_MAX_INTER_BITRATE_PCT)
> > +    vpx_svc_ref_frame_config_t ref_frame_config;
> > +    AVDictionary *vpx_ref_frame_config;
> > +#endif
> >  } VPxContext;
> >
> >  /** String mappings for enum vp8e_enc_control_id */
> > @@ -152,6 +156,7 @@ static const char *const ctlidstr[] = {
> >      [VP9E_SET_SVC_LAYER_ID]            = "VP9E_SET_SVC_LAYER_ID",
> >  #if VPX_ENCODER_ABI_VERSION >= 12
> >      [VP9E_SET_SVC_PARAMETERS]          = "VP9E_SET_SVC_PARAMETERS",
> > +    [VP9E_SET_SVC_REF_FRAME_CONFIG]    =
> "VP9E_SET_SVC_REF_FRAME_CONFIG",
> >  #endif
> >      [VP9E_SET_SVC]                     = "VP9E_SET_SVC",
> >  #if VPX_ENCODER_ABI_VERSION >= 11
> > @@ -394,6 +399,21 @@ static void vp8_ts_parse_int_array(int *dest, char
> > *value, size_t value_len, int
> >      }
> >  }
> >
> > +#if CONFIG_LIBVPX_VP9_ENCODER && defined
> > (VPX_CTRL_VP9E_SET_MAX_INTER_BITRATE_PCT)
> > +static void vp8_ts_parse_int64_array(int64_t *dest, char *value, size_t
> > value_len, int max_entries)
> > +{
> > +    int dest_idx = 0;
> > +    char *saveptr = NULL;
> > +    char *token = av_strtok(value, ",", &saveptr);
> > +
> > +    while (token && dest_idx < max_entries) {
> > +        dest[dest_idx++] = strtoul(token, NULL, 10);
> > +        token = av_strtok(NULL, ",", &saveptr);
> > +    }
> > +}
> > +
> > +#endif
> > +
> >  static void set_temporal_layer_pattern(int layering_mode,
> > vpx_codec_enc_cfg_t *cfg,
> >                                         int *layer_flags, int
> > *flag_periodicity)
> >  {
> > @@ -541,6 +561,49 @@ static int vpx_ts_param_parse(VPxContext *ctx,
> struct
> > vpx_codec_enc_cfg *enccfg,
> >      return 0;
> >  }
> >
> > +#if CONFIG_LIBVPX_VP9_ENCODER && defined
> > (VPX_CTRL_VP9E_SET_MAX_INTER_BITRATE_PCT)
> > +static int vpx_ref_frame_config_parse(VPxContext *ctx, const struct
> > vpx_codec_enc_cfg *enccfg,
> > +                              char *key, char *value, enum AVCodecID
> > codec_id)
> > +{
> > +    size_t value_len = strlen(value);
> > +    int ss_number_layers = enccfg->ss_number_layers;
> > +    vpx_svc_ref_frame_config_t *ref_frame_config =
> &ctx->ref_frame_config;
> > +
> > +    if (!value_len)
> > +        return -1;
> > +
> > +    if (codec_id != AV_CODEC_ID_VP9)
> > +        return -1;
> > +
> > +    if (!strcmp(key, "rfc_update_buffer_slot")) {
> > +        vp8_ts_parse_int_array(ref_frame_config->update_buffer_slot,
> > value, value_len, ss_number_layers);
> > +    } else if (!strcmp(key, "rfc_update_last")) {
> > +        vp8_ts_parse_int_array(ref_frame_config->update_last, value,
> > value_len, ss_number_layers);
> > +    } else if (!strcmp(key, "rfc_update_golden")) {
> > +        vp8_ts_parse_int_array(ref_frame_config->update_golden, value,
> > value_len, ss_number_layers);
> > +    } else if (!strcmp(key, "rfc_update_alt_ref")) {
> > +        vp8_ts_parse_int_array(ref_frame_config->update_alt_ref, value,
> > value_len, ss_number_layers);
> > +    } else if (!strcmp(key, "rfc_lst_fb_idx")) {
> > +        vp8_ts_parse_int_array(ref_frame_config->lst_fb_idx, value,
> > value_len, ss_number_layers);
> > +    } else if (!strcmp(key, "rfc_gld_fb_idx")) {
> > +        vp8_ts_parse_int_array(ref_frame_config->gld_fb_idx, value,
> > value_len, ss_number_layers);
> > +    } else if (!strcmp(key, "rfc_alt_fb_idx")) {
> > +        vp8_ts_parse_int_array(ref_frame_config->alt_fb_idx, value,
> > value_len, ss_number_layers);
> > +    } else if (!strcmp(key, "rfc_reference_last")) {
> > +        vp8_ts_parse_int_array(ref_frame_config->reference_last, value,
> > value_len, ss_number_layers);
> > +    } else if (!strcmp(key, "rfc_reference_golden")) {
> > +        vp8_ts_parse_int_array(ref_frame_config->reference_golden,
> value,
> > value_len, ss_number_layers);
> > +    } else if (!strcmp(key, "rfc_reference_alt_ref")) {
> > +        vp8_ts_parse_int_array(ref_frame_config->reference_alt_ref,
> > value, value_len, ss_number_layers);
> > +    } else if (!strcmp(key, "rfc_reference_duration")) {
> > +        vp8_ts_parse_int64_array(ref_frame_config->duration, value,
> > value_len, ss_number_layers);
> > +    }
> > +
> > +    return 0;
> > +}
> > +#endif
> > +
> > +
> >  #if CONFIG_LIBVPX_VP9_ENCODER
> >  static int set_pix_fmt(AVCodecContext *avctx, vpx_codec_caps_t
> codec_caps,
> >                         struct vpx_codec_enc_cfg *enccfg,
> > vpx_codec_flags_t *flags,
> > @@ -1528,6 +1591,24 @@ static int vpx_encode(AVCodecContext *avctx,
> > AVPacket *pkt,
> >  #endif
> >                  layer_id_valid = 1;
> >              }
> > +#if CONFIG_LIBVPX_VP9_ENCODER && defined
> > (VPX_CTRL_VP9E_SET_MAX_INTER_BITRATE_PCT)
> > +            en = av_dict_get(frame->metadata, "ref-frame-config", NULL,
> > 0);
> > +
> > +            if (en) {
> > +                AVDictionaryEntry* en2 = NULL;
> > +                av_dict_parse_string(&ctx->vpx_ref_frame_config,
> > en->value, "=", ":", 0);
> > +
> > +                while ((en2 = av_dict_get(ctx->vpx_ref_frame_config, "",
> > en2, AV_DICT_IGNORE_SUFFIX))) {
> > +                    if (vpx_ref_frame_config_parse(ctx, enccfg,
> en2->key,
> > en2->value, avctx->codec_id) < 0)
> > +                        av_log(avctx, AV_LOG_WARNING,
> > +                               "Error parsing option '%s = %s'.\n",
> > +                               en2->key, en2->value);
> > +                }
> > +
> > +                codecctl_intp(avctx, VP9E_SET_SVC_REF_FRAME_CONFIG, (int
> > *)&ctx->ref_frame_config);
> > +            }
> > +#endif
> > +
> >          }
> >
> >          if (sd) {
> > --
> > 2.29.2.729.g45daf8777d-goog
> >
> > I found one more warning in docs. Please take a look at the change.
>
> Happy holidays to you,
>
> Wonkap
> _______________________________________________
> ffmpeg-devel mailing list
> ffmpeg-devel@ffmpeg.org
> https://ffmpeg.org/mailman/listinfo/ffmpeg-devel
>
> To unsubscribe, visit link above, or email
> ffmpeg-devel-request@ffmpeg.org with subject "unsubscribe".


Could you take a look at this please?

Thank you, and let me know if there is any more to change here.

Wonkap
James Zern Jan. 7, 2021, 7:47 p.m. UTC | #3
Hi,

On Wed, Jan 6, 2021 at 8:59 AM Wonkap Jang <wonkapjang@gmail.com> wrote:
>
> HI JAmes,
>
> On Tue, Dec 29, 2020 at 11:54 AM Wonkap Jang <
> wonkap-at-google.com@ffmpeg.org> wrote:
>
> > Hi James,
> >
> > On Tue, Dec 29, 2020 at 11:51 AM Wonkap Jang <wonkap@google.com> wrote:
> >
> > > In order to fine-control referencing schemes in VP9 encoding, there
> > > is a need to use VP9E_SET_SVC_REF_FRAME_CONFIG method. This commit
> > > provides a way to use the API through frame metadata.
> > > ---
> > >  doc/encoders.texi      | 32 +++++++++++++++++
> > >  libavcodec/libvpxenc.c | 81 ++++++++++++++++++++++++++++++++++++++++++
> > >  2 files changed, 113 insertions(+)
> > >

A change like this should also bump the micro version in avcodec.h

> > > diff --git a/doc/encoders.texi b/doc/encoders.texi
> > > index 0b1c69e982..11cf4d89d0 100644
> > > --- a/doc/encoders.texi
> > > +++ b/doc/encoders.texi
> > > @@ -2129,6 +2129,38 @@ midpoint is passed in rather than calculated for a
> > > specific clip or chunk.
> > >  The valid range is [0, 10000]. 0 (default) uses standard VBR.
> > >  @item enable-tpl @var{boolean}
> > >  Enable temporal dependency model.
> > > +@item ref-frame-config
> > > +Using per-frame metadata, set members of the structure
> > > @code{vpx_svc_ref_frame_config_t} in @code{vpx/vp8cx.h} to fine-control
> > > referencing schemes and frame buffer management.
> > > +@*Use a :-separated list of key=value pairs.
> > > +For example,
> > > +@example
> > > +av_dict_set(&av_frame->metadata, "ref-frame-config", \
> > >
> > >
> > +"rfc_update_buffer_slot=7:rfc_lst_fb_idx=0:rfc_gld_fb_idx=1:rfc_alt_fb_idx=2:rfc_reference_last=0:rfc_reference_golden=0:rfc_reference_alt_ref=0");
> > > +@end example
> > > +@table @option
> > > +@item rfc_update_buffer_slot
> > > +Indicates the buffer slot number to update
> > > +@item rfc_update_last
> > > +Indicates whether to update the LAST frame
> > > +@item rfc_update_golden
> > > +Indicates whether to update GOLDEN frame
> > > +@item rfc_update_alt_ref
> > > +Indicates whether to update ALT_REF frame
> > > +@item rfc_lst_fb_idx
> > > +LAST frame buffer index
> > > +@item rfc_gld_fb_idx
> > > +GOLDEN frame buffer index
> > > +@item rfc_alt_fb_idx
> > > +ALT_REF frame buffer index
> > > +@item rfc_reference_last
> > > +Indicates whetehr to reference LAST frame

whether

> > > +@item rfc_reference_golden
> > > +Indicates whether to reference GOLDEN frame
> > > +@item rfc_reference_alt_ref
> > > +Indicates whether to reference ALT_REF frame
> > > +@item rfc_reference_duration
> > > +Indicates frame duration
> > > +@end table
> > >  @end table
> > >
> > >  @end table
> > > diff --git a/libavcodec/libvpxenc.c b/libavcodec/libvpxenc.c
> > > index a7c76eb835..4943a9e32c 100644
> > > --- a/libavcodec/libvpxenc.c
> > > +++ b/libavcodec/libvpxenc.c
> > > @@ -125,6 +125,10 @@ typedef struct VPxEncoderContext {
> > >       * encounter a frame with ROI side data.
> > >       */
> > >      int roi_warned;
> > > +#if CONFIG_LIBVPX_VP9_ENCODER && defined
> > > (VPX_CTRL_VP9E_SET_MAX_INTER_BITRATE_PCT)

It's uncommon to add a space before ( with defined.

> > > [...]
> > >
> > > +#if CONFIG_LIBVPX_VP9_ENCODER && defined
> > > (VPX_CTRL_VP9E_SET_MAX_INTER_BITRATE_PCT)
> > > +static int vpx_ref_frame_config_parse(VPxContext *ctx, const struct
> > > vpx_codec_enc_cfg *enccfg,
> > > +                              char *key, char *value, enum AVCodecID
> > > codec_id)

indent is off

> > > +{
> > > +    size_t value_len = strlen(value);
> > > +    int ss_number_layers = enccfg->ss_number_layers;
> > > +    vpx_svc_ref_frame_config_t *ref_frame_config =
> > &ctx->ref_frame_config;
> > > +
> > > +    if (!value_len)
> > > +        return -1;
> > > +
> > > +    if (codec_id != AV_CODEC_ID_VP9)
> > > +        return -1;
> > > +

You might want to just skip the call altogether and add 1 warning
output if it's VP8.

> > > [...]
> > > +    }
> > > +
> > > +    return 0;
> > > +}
> > > +#endif
> > > +
> > > +

this line can be removed.
diff mbox series

Patch

diff --git a/doc/encoders.texi b/doc/encoders.texi
index 0b1c69e982..11cf4d89d0 100644
--- a/doc/encoders.texi
+++ b/doc/encoders.texi
@@ -2129,6 +2129,38 @@  midpoint is passed in rather than calculated for a specific clip or chunk.
 The valid range is [0, 10000]. 0 (default) uses standard VBR.
 @item enable-tpl @var{boolean}
 Enable temporal dependency model.
+@item ref-frame-config
+Using per-frame metadata, set members of the structure @code{vpx_svc_ref_frame_config_t} in @code{vpx/vp8cx.h} to fine-control referencing schemes and frame buffer management.
+@*Use a :-separated list of key=value pairs.
+For example,
+@example
+av_dict_set(&av_frame->metadata, "ref-frame-config", \
+"rfc_update_buffer_slot=7:rfc_lst_fb_idx=0:rfc_gld_fb_idx=1:rfc_alt_fb_idx=2:rfc_reference_last=0:rfc_reference_golden=0:rfc_reference_alt_ref=0");
+@end example
+@table @option
+@item rfc_update_buffer_slot
+Indicates the buffer slot number to update
+@item rfc_update_last
+Indicates whether to update the LAST frame
+@item rfc_update_golden
+Indicates whether to update GOLDEN frame
+@item rfc_update_alt_ref
+Indicates whether to update ALT_REF frame
+@item rfc_lst_fb_idx
+LAST frame buffer index
+@item rfc_gld_fb_idx
+GOLDEN frame buffer index
+@item rfc_alt_fb_idx
+ALT_REF frame buffer index
+@item rfc_reference_last
+Indicates whetehr to reference LAST frame
+@item rfc_reference_golden
+Indicates whether to reference GOLDEN frame
+@item rfc_reference_alt_ref
+Indicates whether to reference ALT_REF frame
+@item rfc_reference_duration
+Indicates frame duration
+@end table
 @end table
 
 @end table
diff --git a/libavcodec/libvpxenc.c b/libavcodec/libvpxenc.c
index a7c76eb835..4943a9e32c 100644
--- a/libavcodec/libvpxenc.c
+++ b/libavcodec/libvpxenc.c
@@ -125,6 +125,10 @@  typedef struct VPxEncoderContext {
      * encounter a frame with ROI side data.
      */
     int roi_warned;
+#if CONFIG_LIBVPX_VP9_ENCODER && defined (VPX_CTRL_VP9E_SET_MAX_INTER_BITRATE_PCT)
+    vpx_svc_ref_frame_config_t ref_frame_config;
+    AVDictionary *vpx_ref_frame_config;
+#endif
 } VPxContext;
 
 /** String mappings for enum vp8e_enc_control_id */
@@ -152,6 +156,7 @@  static const char *const ctlidstr[] = {
     [VP9E_SET_SVC_LAYER_ID]            = "VP9E_SET_SVC_LAYER_ID",
 #if VPX_ENCODER_ABI_VERSION >= 12
     [VP9E_SET_SVC_PARAMETERS]          = "VP9E_SET_SVC_PARAMETERS",
+    [VP9E_SET_SVC_REF_FRAME_CONFIG]    = "VP9E_SET_SVC_REF_FRAME_CONFIG",
 #endif
     [VP9E_SET_SVC]                     = "VP9E_SET_SVC",
 #if VPX_ENCODER_ABI_VERSION >= 11
@@ -394,6 +399,21 @@  static void vp8_ts_parse_int_array(int *dest, char *value, size_t value_len, int
     }
 }
 
+#if CONFIG_LIBVPX_VP9_ENCODER && defined (VPX_CTRL_VP9E_SET_MAX_INTER_BITRATE_PCT)
+static void vp8_ts_parse_int64_array(int64_t *dest, char *value, size_t value_len, int max_entries)
+{
+    int dest_idx = 0;
+    char *saveptr = NULL;
+    char *token = av_strtok(value, ",", &saveptr);
+
+    while (token && dest_idx < max_entries) {
+        dest[dest_idx++] = strtoul(token, NULL, 10);
+        token = av_strtok(NULL, ",", &saveptr);
+    }
+}
+
+#endif
+
 static void set_temporal_layer_pattern(int layering_mode, vpx_codec_enc_cfg_t *cfg,
                                        int *layer_flags, int *flag_periodicity)
 {
@@ -541,6 +561,49 @@  static int vpx_ts_param_parse(VPxContext *ctx, struct vpx_codec_enc_cfg *enccfg,
     return 0;
 }
 
+#if CONFIG_LIBVPX_VP9_ENCODER && defined (VPX_CTRL_VP9E_SET_MAX_INTER_BITRATE_PCT)
+static int vpx_ref_frame_config_parse(VPxContext *ctx, const struct vpx_codec_enc_cfg *enccfg,
+                              char *key, char *value, enum AVCodecID codec_id)
+{
+    size_t value_len = strlen(value);
+    int ss_number_layers = enccfg->ss_number_layers;
+    vpx_svc_ref_frame_config_t *ref_frame_config = &ctx->ref_frame_config;
+
+    if (!value_len)
+        return -1;
+
+    if (codec_id != AV_CODEC_ID_VP9)
+        return -1;
+
+    if (!strcmp(key, "rfc_update_buffer_slot")) {
+        vp8_ts_parse_int_array(ref_frame_config->update_buffer_slot, value, value_len, ss_number_layers);
+    } else if (!strcmp(key, "rfc_update_last")) {
+        vp8_ts_parse_int_array(ref_frame_config->update_last, value, value_len, ss_number_layers);
+    } else if (!strcmp(key, "rfc_update_golden")) {
+        vp8_ts_parse_int_array(ref_frame_config->update_golden, value, value_len, ss_number_layers);
+    } else if (!strcmp(key, "rfc_update_alt_ref")) {
+        vp8_ts_parse_int_array(ref_frame_config->update_alt_ref, value, value_len, ss_number_layers);
+    } else if (!strcmp(key, "rfc_lst_fb_idx")) {
+        vp8_ts_parse_int_array(ref_frame_config->lst_fb_idx, value, value_len, ss_number_layers);
+    } else if (!strcmp(key, "rfc_gld_fb_idx")) {
+        vp8_ts_parse_int_array(ref_frame_config->gld_fb_idx, value, value_len, ss_number_layers);
+    } else if (!strcmp(key, "rfc_alt_fb_idx")) {
+        vp8_ts_parse_int_array(ref_frame_config->alt_fb_idx, value, value_len, ss_number_layers);
+    } else if (!strcmp(key, "rfc_reference_last")) {
+        vp8_ts_parse_int_array(ref_frame_config->reference_last, value, value_len, ss_number_layers);
+    } else if (!strcmp(key, "rfc_reference_golden")) {
+        vp8_ts_parse_int_array(ref_frame_config->reference_golden, value, value_len, ss_number_layers);
+    } else if (!strcmp(key, "rfc_reference_alt_ref")) {
+        vp8_ts_parse_int_array(ref_frame_config->reference_alt_ref, value, value_len, ss_number_layers);
+    } else if (!strcmp(key, "rfc_reference_duration")) {
+        vp8_ts_parse_int64_array(ref_frame_config->duration, value, value_len, ss_number_layers);
+    }
+
+    return 0;
+}
+#endif
+
+
 #if CONFIG_LIBVPX_VP9_ENCODER
 static int set_pix_fmt(AVCodecContext *avctx, vpx_codec_caps_t codec_caps,
                        struct vpx_codec_enc_cfg *enccfg, vpx_codec_flags_t *flags,
@@ -1528,6 +1591,24 @@  static int vpx_encode(AVCodecContext *avctx, AVPacket *pkt,
 #endif
                 layer_id_valid = 1;
             }
+#if CONFIG_LIBVPX_VP9_ENCODER && defined (VPX_CTRL_VP9E_SET_MAX_INTER_BITRATE_PCT)
+            en = av_dict_get(frame->metadata, "ref-frame-config", NULL, 0);
+
+            if (en) {
+                AVDictionaryEntry* en2 = NULL;
+                av_dict_parse_string(&ctx->vpx_ref_frame_config, en->value, "=", ":", 0);
+
+                while ((en2 = av_dict_get(ctx->vpx_ref_frame_config, "", en2, AV_DICT_IGNORE_SUFFIX))) {
+                    if (vpx_ref_frame_config_parse(ctx, enccfg, en2->key, en2->value, avctx->codec_id) < 0)
+                        av_log(avctx, AV_LOG_WARNING,
+                               "Error parsing option '%s = %s'.\n",
+                               en2->key, en2->value);
+                }
+
+                codecctl_intp(avctx, VP9E_SET_SVC_REF_FRAME_CONFIG, (int *)&ctx->ref_frame_config);
+            }
+#endif
+
         }
 
         if (sd) {