[FFmpeg-devel] [PATCH V1 1/2] doc/bsfs: h264_metadata: Update docs about display orientation SEI

[Andreas Rheinhardt]

On Sat, Jan 18, 2020 at 3:11 AM Jun Zhao <mypopydev at gmail.com> wrote:

> From: Jun Zhao <barryjzhao at tencent.com>
>
> Add docs about display orientation SEI.
>
> Signed-off-by: Jun Zhao <barryjzhao at tencent.com>
> ---
>  doc/bitstream_filters.texi |   21 +++++++++++++++++++++
>  1 files changed, 21 insertions(+), 0 deletions(-)
>
> diff --git a/doc/bitstream_filters.texi b/doc/bitstream_filters.texi
> index 8fe5b3a..ff5d027 100644
> --- a/doc/bitstream_filters.texi
> +++ b/doc/bitstream_filters.texi
> @@ -276,6 +276,27 @@ insert the string ``hello'' associated with the given
> UUID.
>  @item delete_filler
>  Deletes both filler NAL units and filler SEI messages.
>
> + at item display_orientation
> +Pass, insert, remove or extract display orientation SEI.  Default is pass.
> +
> + at table @samp
> + at item pass
> + at item insert
> + at item remove
> + at item extract
> + at end table
> +
> + at item rotate
> +Set rotation in display orientation SEI (anticlockwise angle in degrees)
> (from -360 to 360)
> +
> + at item flip
> +Set flip in display orientation SEI
> +
> + at table @samp
> + at item horizontal
> + at item vertical
> + at end table
> +
>  @item level
>  Set the level in the SPS.  Refer to H.264 section A.3 and tables A-1
>  to A-5.
> --
> 1.7.1


If I am not mistaken, then the handling of display orientation SEI is buggy
(see [1]). It should be fixed before documenting it.

- Andreas

[1]:
https://lists.ffmpeg.org/pipermail/ffmpeg-devel-irc/2019-June/005804.html