diff mbox series

[FFmpeg-devel,v3,3/3] doc/encoders: add VP9 temporal scalability encoding option

Message ID 20200108230006.169044-3-wonkap@google.com
State New
Headers show
Series [FFmpeg-devel,v3,1/3] avcodec/libvpxenc: add VP9 temporal scalability encoding option | expand

Checks

Context Check Description
andriy/ffmpeg-patchwork success Make fate finished

Commit Message

Wonkap Jang Jan. 8, 2020, 11 p.m. UTC 
Documentation change for adding support for encoding
with temporal scalability in VP9.
---
 doc/encoders.texi | 18 +++++++++++++++---
 1 file changed, 15 insertions(+), 3 deletions(-)

Comments

James Zern Jan. 10, 2020, 4:01 a.m. UTC | #1 
On Wed, Jan 8, 2020 at 3:00 PM Wonkap Jang
<wonkap-at-google.com@ffmpeg.org> wrote:
>
> Documentation change for adding support for encoding
> with temporal scalability in VP9.
> ---
>  doc/encoders.texi | 18 +++++++++++++++---
>  1 file changed, 15 insertions(+), 3 deletions(-)
>

This could be a part of the first patch in the series so that if it
needs to be reverted the documentation stays up to date.
Wonkap Jang Jan. 10, 2020, 5:40 p.m. UTC | #2 
On Thu, Jan 9, 2020 at 8:09 PM James Zern <jzern-at-google.com@ffmpeg.org>
wrote:

> On Wed, Jan 8, 2020 at 3:00 PM Wonkap Jang
> <wonkap-at-google.com@ffmpeg.org> wrote:
> >
> > Documentation change for adding support for encoding
> > with temporal scalability in VP9.
> > ---
> >  doc/encoders.texi | 18 +++++++++++++++---
> >  1 file changed, 15 insertions(+), 3 deletions(-)
> >
>
> This could be a part of the first patch in the series so that if it
> needs to be reverted the documentation stays up to date.
> _______________________________________________
> 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".


OK. I'll include it in the first patch and send as version 4 of the series
of patches.

Thank you,

Wonkap
diff mbox series

Patch

diff --git a/doc/encoders.texi b/doc/encoders.texi
index 61e674cf96..88429aed4c 100644
--- a/doc/encoders.texi
+++ b/doc/encoders.texi
@@ -1885,8 +1885,6 @@  Enable error resiliency features.
 Increase sharpness at the expense of lower PSNR.
 The valid range is [0, 7].
 
-@item VP8-specific options
-@table @option
 @item ts-parameters
 Sets the temporal scalability configuration using a :-separated list of
 key=value pairs. For example, to specify temporal scalability parameters
@@ -1894,7 +1892,7 @@  with @code{ffmpeg}:
 @example
 ffmpeg -i INPUT -c:v libvpx -ts-parameters ts_number_layers=3:\
 ts_target_bitrate=250,500,1000:ts_rate_decimator=4,2,1:\
-ts_periodicity=4:ts_layer_id=0,2,1,2 OUTPUT
+ts_periodicity=4:ts_layer_id=0,2,1,2:ts_layering_mode=3 OUTPUT
 @end example
 Below is a brief explanation of each of the parameters, please
 refer to @code{struct vpx_codec_enc_cfg} in @code{vpx/vpx_encoder.h} for more
@@ -1911,6 +1909,20 @@  Frame rate decimation factor for each temporal layer.
 Length of the sequence defining frame temporal layer membership.
 @item ts_layer_id
 Template defining the membership of frames to temporal layers.
+@item ts_layering_mode
+(optional) Selecting the temporal structure from a set of pre-defined temporal layering modes.
+Currently supports the following options.
+@table @option
+@item 0
+No temporal layering flags are provided internally,
+relies on flags being passed in using metadata in AVFrame.
+@item 2
+Two temporal layers. 0-1...
+@item 3
+Three temporal layers. 0-2-1-2...; with single reference frame.
+@item 4
+Same as option "3", except there is a dependency between
+the two temporal layer 2 frames within the temporal period.
 @end table
 @end table