Skip to content

Commit 3ee9e71

Browse files
committed
Add more information.
1 parent 5520784 commit 3ee9e71

File tree

1 file changed

+18
-16
lines changed

1 file changed

+18
-16
lines changed

tutorials/animation/playing_videos.rst

Lines changed: 18 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -155,7 +155,7 @@ There are several limitations with the current implementation of video playback
155155
- Changing playback speed is not supported. VideoStreamPlayer also won't follow
156156
:ref:`Engine.time_scale<class_Engine_property_time_scale>`.
157157
- Streaming a video from a URL is not supported.
158-
- Audio output is always mono or stereo. Files with 4, 5.1 and 7.1 audio
158+
- Audio output is always mono or stereo. Videos with 4, 5.1 and 7.1 audio
159159
channels are supported but down-mixed to stereo.
160160

161161
.. _doc_playing_videos_recommended_theora_encoding_settings:
@@ -198,9 +198,11 @@ below with almost any input video format (AVI, MOV, WebM, …).
198198

199199
.. warning::
200200

201-
FFmpeg will erroneously drop identical frames when performing a copy of a
202-
Theora stream producing an incorrect video file. Avoid it by always
203-
transcoding video. See `FFmpeg issue #11451
201+
FFmpeg 5.1.6 will erroneously drop identical frames when performing a copy
202+
of a Theora stream, altering the video content. It can be avoided by always
203+
transcoding video. Newer versions have the same issue also when encoding.
204+
For now, you'll get better results encoding video with FFmpeg 5.1.6, and not
205+
doing video stream copies. See `FFmpeg issue #11451
204206
<https://trac.ffmpeg.org/ticket/11451>`__.
205207

206208
Balancing quality and file size
@@ -225,25 +227,25 @@ dropouts in case of high system load. See
225227
for a table listing Ogg Vorbis audio quality presets and their respective
226228
variable bitrates.
227229

228-
The **GOP (Group of Pictures) size** (``-g:v``) can provide better compression
229-
by increasing the max interval between keyframes. The default value (``12``) is
230-
pretty low. Higher values can provide better compression with almost no impact
231-
on quality and only slightly slower seeks. Increasing it produces better
232-
results than reducing video quality and it's thus recommended. As the value
233-
increases, compression benefits decrease until there's no practical improvement
234-
anymore.
230+
The **GOP (Group of Pictures) size** (``-g:v``) is the max interval between
231+
keyframes. Increasing this value will improve compression with almost no impact
232+
on quality, but seeks will be slower depending on decoding speed. The valid
233+
range goes from ``0`` to ``2,147,483,648``, although compression benefits will
234+
fade away as the value increases, making large sizes useless. The default GOP
235+
size is pretty low, thus it's recommended to increase it to improve compression
236+
before reducing video quality.
235237

236238
.. note::
237239

238-
GOP size values going past powers of two counting from ``64`` will increase
239-
seek times slightly more. Thus, recommended values to try if you want best
240-
compression/seek times ratios are ``64``, ``128``, ``256``…
240+
GOP size values going past powers of two, counting from ``64``, will
241+
increase seek times slightly more. Thus, recommended values to try if you
242+
want best compression/seek times ratios are ``64``, ``128``, ``256``…
241243

242244
.. warning::
243245

244246
When encoding with FFmpeg, using a GOP size greater than ``64`` can slow
245-
down seeking even more and might not always improve compression. See `FFmpeg
246-
issue #11454 <https://trac.ffmpeg.org/ticket/11454>`__.
247+
down seeking a bit more than it should. See `FFmpeg issue #11454
248+
<https://trac.ffmpeg.org/ticket/11454>`__.
247249

248250
FFmpeg: Convert while preserving original video resolution
249251
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

0 commit comments

Comments
 (0)