@@ -150,10 +150,8 @@ To ensure your videos decode smoothly on varied hardware:
150
150
Playback limitations
151
151
--------------------
152
152
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:
154
154
155
- - Changing playback speed is not supported. VideoStreamPlayer also won't follow
156
- :ref: `Engine.time_scale<class_Engine_property_time_scale> `.
157
155
- Streaming a video from a URL is not supported.
158
156
- Only mono and stereo audio output is supported. Videos with 4, 5.1 and 7.1
159
157
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
183
181
of disk space.
184
182
185
183
`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.
187
185
188
186
Here are example FFmpeg commands to convert an MP4 video to Ogg Theora. Since
189
187
FFmpeg supports a lot of input formats, you should be able to use the commands
@@ -202,10 +200,9 @@ below with almost any input video format (AVI, MOV, WebM, …).
202
200
203
201
.. warning ::
204
202
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.
203
+ Current official FFmpeg releases have some bugs in their Ogg/Theora
204
+ multiplexer. It's highly recommended to use one of the latest static daily
205
+ builds, or build from their master branch where they are already fixed.
209
206
210
207
Balancing quality and file size
211
208
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -231,10 +228,9 @@ variable bitrates.
231
228
232
229
The **GOP (Group of Pictures) size ** (``-g:v ``) is the max interval between
233
230
keyframes. 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.
231
+ on quality. The default size (``12 ``) is too low for most types of content,
232
+ it's therefore recommended using higher GOP values before reducing video
233
+ quality. Compression benefits will fade away as the GOP size increases though.
238
234
Values between ``64 `` and ``512 `` usually give the best compression.
239
235
240
236
.. note ::
0 commit comments