@@ -150,10 +150,8 @@ To ensure your videos decode smoothly on varied hardware:
150150Playback limitations
151151--------------------
152152
153- There are several limitations with the current implementation of video playback in Godot:
153+ There are some limitations with the current implementation of video playback in Godot:
154154
155- - Changing playback speed is not supported. VideoStreamPlayer also won't follow
156- :ref: `Engine.time_scale<class_Engine_property_time_scale> `.
157155- Streaming a video from a URL is not supported.
158156- Only mono and stereo audio output is supported. Videos with 4, 5.1 and 7.1
159157 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
183181of disk space.
184182
185183`FFmpeg <https://ffmpeg.org/ >`__ (CLI) is a popular open source tool
186- for this purpose. FFmpeg has a steep learning curve, but it's powerful tool.
184+ for this purpose. FFmpeg has a steep learning curve, but it's a powerful tool.
187185
188186Here are example FFmpeg commands to convert an MP4 video to Ogg Theora. Since
189187FFmpeg 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, …).
195193 You can check this by running ``ffmpeg `` without any arguments, then looking
196194 at the ``configuration: `` line in the command output.
197195
196+ .. warning ::
197+
198+ Current official FFmpeg releases have some bugs in their Ogg/Theora
199+ multiplexer. It's highly recommended to use one of the latest static daily
200+ builds, or build from their master branch to get the latest fixes.
201+
198202.. UPDATE: When the FFmpeg bugfixes for https://trac.ffmpeg.org/ticket/11451 and
199203.. https://trac.ffmpeg.org/ticket/11454 are included in a stable FFmpeg release,
200- .. this note can be removed. That will likely be FFmpeg 7.2 or 8.0, and will
204+ .. this warning can be removed. That will likely be FFmpeg 7.2 or 8.0, and will
201205.. likely happen during the Godot 4.5 or 4.6 release cycle.
202-
203- .. warning ::
204-
205- All FFmpeg releases before Feb 20th, 2025 could produce bad video streams
206- due to a couple of bugs. It's highly recommended to use one of the latest
207- static daily builds, or build FFmpeg from their master branch where they're
208- already fixed.
206+ .. Commits fixing the issues:
207+ .. - https://github.org/FFmpeg/FFmpeg@22aa71d4da37a4ad2b0d28deeace64b57aa2ef50
208+ .. - https://github.org/FFmpeg/FFmpeg@84d85e7ad4ace228265af0c8c5caccc0730042fd
209+ .. - https://github.org/FFmpeg/FFmpeg@6e26f57f672b05e7b8b052007a83aef99dc81ccb
209210
210211 Balancing quality and file size
211212~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -231,10 +232,9 @@ variable bitrates.
231232
232233The **GOP (Group of Pictures) size ** (``-g:v ``) is the max interval between
233234keyframes. Increasing this value can improve compression with almost no impact
234- on quality. The valid range goes from ``0 `` to ``2,147,483,648 ``, although
235- compression benefits will fade away and even be reversed as the GOP size
236- increases. The default size (``12 ``) is too low for most types of content, it's
237- therefore recommended to test higher GOP sizes before reducing video quality.
235+ on quality. The default size (``12 ``) is too low for most types of content,
236+ it's therefore recommended using higher GOP values before reducing video
237+ quality. Compression benefits will fade away as the GOP size increases though.
238238Values between ``64 `` and ``512 `` usually give the best compression.
239239
240240.. note ::
0 commit comments