@@ -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
206208Balancing quality and file size
@@ -225,25 +227,25 @@ dropouts in case of high system load. See
225227for a table listing Ogg Vorbis audio quality presets and their respective
226228variable 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
248250FFmpeg: Convert while preserving original video resolution
249251~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
0 commit comments