2
0
Эх сурвалжийг харах

Merge pull request #10972 from berarma/playing_videos_4.5

Update Playing Videos page for Godot 4.5
Matthew 1 сар өмнө
parent
commit
6e72ab3276

+ 15 - 15
tutorials/animation/playing_videos.rst

@@ -150,10 +150,8 @@ To ensure your videos decode smoothly on varied hardware:
 Playback limitations
 Playback limitations
 --------------------
 --------------------
 
 
-There are several limitations with the current implementation of video playback in Godot:
+There are some limitations with the current implementation of video playback in Godot:
 
 
-- Changing playback speed is not supported. VideoStreamPlayer also won't follow
-  :ref:`Engine.time_scale<class_Engine_property_time_scale>`.
 - Streaming a video from a URL is not supported.
 - Streaming a video from a URL is not supported.
 - Only mono and stereo audio output is supported. Videos with 4, 5.1 and 7.1
 - Only mono and stereo audio output is supported. Videos with 4, 5.1 and 7.1
   audio channels are supported but down-mixed to stereo.
   audio channels are supported but down-mixed to stereo.
@@ -195,17 +193,20 @@ below with almost any input video format (AVI, MOV, WebM, …).
    You can check this by running ``ffmpeg`` without any arguments, then looking
    You can check this by running ``ffmpeg`` without any arguments, then looking
    at the ``configuration:`` line in the command output.
    at the ``configuration:`` line in the command output.
 
 
+.. warning::
+
+   Current official FFmpeg releases have some bugs in their Ogg/Theora
+   multiplexer. It's highly recommended to use one of the latest static daily
+   builds, or build from their master branch to get the latest fixes.
+
 .. UPDATE: When the FFmpeg bugfixes for https://trac.ffmpeg.org/ticket/11451 and
 .. UPDATE: When the FFmpeg bugfixes for https://trac.ffmpeg.org/ticket/11451 and
 .. https://trac.ffmpeg.org/ticket/11454 are included in a stable FFmpeg release,
 .. https://trac.ffmpeg.org/ticket/11454 are included in a stable FFmpeg release,
-.. this note can be removed. That will likely be FFmpeg 7.2 or 8.0, and will
+.. this warning can be removed. That will likely be FFmpeg 7.2 or 8.0, and will
 .. likely happen during the Godot 4.5 or 4.6 release cycle.
 .. likely happen during the Godot 4.5 or 4.6 release cycle.
-
-.. warning::
-
-   All FFmpeg releases before Feb 20th, 2025 could produce bad video streams
-   due to a couple of bugs. It's highly recommended to use one of the latest
-   static daily builds, or build FFmpeg from their master branch where they're
-   already fixed.
+.. Commits fixing the issues:
+.. - https://github.org/FFmpeg/FFmpeg@22aa71d4da37a4ad2b0d28deeace64b57aa2ef50
+.. - https://github.org/FFmpeg/FFmpeg@84d85e7ad4ace228265af0c8c5caccc0730042fd
+.. - https://github.org/FFmpeg/FFmpeg@6e26f57f672b05e7b8b052007a83aef99dc81ccb
 
 
 Balancing quality and file size
 Balancing quality and file size
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -231,10 +232,9 @@ variable bitrates.
 
 
 The **GOP (Group of Pictures) size** (``-g:v``) is the max interval between
 The **GOP (Group of Pictures) size** (``-g:v``) is the max interval between
 keyframes. Increasing this value can improve compression with almost no impact
 keyframes. Increasing this value can improve compression with almost no impact
-on quality. The valid range goes from ``0`` to ``2,147,483,648``, although
-compression benefits will fade away and even be reversed as the GOP size
-increases. The default size (``12``) is too low for most types of content, it's
-therefore recommended to test higher GOP sizes before reducing video quality.
+on quality. The default size (``12``) is too low for most types of content,
+it's therefore recommended using higher GOP values before reducing video
+quality. Compression benefits will fade away as the GOP size increases though.
 Values between ``64`` and ``512`` usually give the best compression.
 Values between ``64`` and ``512`` usually give the best compression.
 
 
 .. note::
 .. note::