diff --git a/tutorials/animation/playing_videos.rst b/tutorials/animation/playing_videos.rst index c98f4b789b6..d1db9dbebea 100644 --- a/tutorials/animation/playing_videos.rst +++ b/tutorials/animation/playing_videos.rst @@ -150,10 +150,8 @@ To ensure your videos decode smoothly on varied hardware: Playback limitations -------------------- -There are several limitations with the current implementation of video playback in Godot: +There are some limitations with the current implementation of video playback in Godot: -- Changing playback speed is not supported. VideoStreamPlayer also won't follow - :ref:`Engine.time_scale`. - Streaming a video from a URL is not supported. - Only mono and stereo audio output is supported. Videos with 4, 5.1 and 7.1 audio channels are supported but down-mixed to stereo. @@ -183,7 +181,7 @@ maximize the quality of the output Ogg Theora video, but this can require a lot of disk space. `FFmpeg `__ (CLI) is a popular open source tool -for this purpose. FFmpeg has a steep learning curve, but it's powerful tool. +for this purpose. FFmpeg has a steep learning curve, but it's a powerful tool. Here are example FFmpeg commands to convert an MP4 video to Ogg Theora. Since FFmpeg supports a lot of input formats, you should be able to use the commands @@ -195,17 +193,20 @@ below with almost any input video format (AVI, MOV, WebM, …). You can check this by running ``ffmpeg`` without any arguments, then looking at the ``configuration:`` line in the command output. +.. warning:: + + Current official FFmpeg releases have some bugs in their Ogg/Theora + multiplexer. It's highly recommended to use one of the latest static daily + builds, or build from their master branch to get the latest fixes. + .. UPDATE: When the FFmpeg bugfixes for https://trac.ffmpeg.org/ticket/11451 and .. https://trac.ffmpeg.org/ticket/11454 are included in a stable FFmpeg release, -.. this note can be removed. That will likely be FFmpeg 7.2 or 8.0, and will +.. this warning can be removed. That will likely be FFmpeg 7.2 or 8.0, and will .. likely happen during the Godot 4.5 or 4.6 release cycle. - -.. warning:: - - All FFmpeg releases before Feb 20th, 2025 could produce bad video streams - due to a couple of bugs. It's highly recommended to use one of the latest - static daily builds, or build FFmpeg from their master branch where they're - already fixed. +.. Commits fixing the issues: +.. - https://github.org/FFmpeg/FFmpeg@22aa71d4da37a4ad2b0d28deeace64b57aa2ef50 +.. - https://github.org/FFmpeg/FFmpeg@84d85e7ad4ace228265af0c8c5caccc0730042fd +.. - https://github.org/FFmpeg/FFmpeg@6e26f57f672b05e7b8b052007a83aef99dc81ccb Balancing quality and file size ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ @@ -231,10 +232,9 @@ variable bitrates. The **GOP (Group of Pictures) size** (``-g:v``) is the max interval between keyframes. Increasing this value can improve compression with almost no impact -on quality. The valid range goes from ``0`` to ``2,147,483,648``, although -compression benefits will fade away and even be reversed as the GOP size -increases. The default size (``12``) is too low for most types of content, it's -therefore recommended to test higher GOP sizes before reducing video quality. +on quality. The default size (``12``) is too low for most types of content, +it's therefore recommended using higher GOP values before reducing video +quality. Compression benefits will fade away as the GOP size increases though. Values between ``64`` and ``512`` usually give the best compression. .. note::