@@ -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.
@@ -182,8 +180,9 @@ you should use a lossless or uncompressed format as an intermediate format to
182
180
maximize the quality of the output Ogg Theora video, but this can require a lot
183
181
of disk space.
184
182
185
- `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.
183
+ `Shutter Encoder <https://www.shutterencoder.com/ >`__ (GUI) and `FFmpeg
184
+ <https://ffmpeg.org/> `__ (CLI) are popular open source tools for this purpose.
185
+ FFmpeg has a steep learning curve, but it's a powerful tool.
187
186
188
187
Here are example FFmpeg commands to convert an MP4 video to Ogg Theora. Since
189
188
FFmpeg supports a lot of input formats, you should be able to use the commands
@@ -202,10 +201,9 @@ below with almost any input video format (AVI, MOV, WebM, …).
202
201
203
202
.. warning ::
204
203
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.
204
+ Current official FFmpeg releases have some bugs in their Ogg/Theora
205
+ multiplexer. It's highly recommended to use one of the latest static daily
206
+ builds, or build from their master branch where they are already fixed.
209
207
210
208
Balancing quality and file size
211
209
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -231,10 +229,9 @@ variable bitrates.
231
229
232
230
The **GOP (Group of Pictures) size ** (``-g:v ``) is the max interval between
233
231
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.
232
+ on quality. The default size (``12 ``) is too low for most types of content,
233
+ it's therefore recommended using higher GOP values before reducing video
234
+ quality. Compression benefits will fade away as the GOP size increases though.
238
235
Values between ``64 `` and ``512 `` usually give the best compression.
239
236
240
237
.. note ::
0 commit comments