Browse Source

Update playing videos

Bernat Arlandis 1 tháng trước cách đây
mục cha
commit
bca64c8d80
1 tập tin đã thay đổi với 16 bổ sung16 xóa
  1. 16 16
      tutorials/animation/playing_videos.rst

+ 16 - 16
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.
@@ -183,7 +181,7 @@ maximize the quality of the output Ogg Theora video, but this can require a lot
 of disk space.
 of disk space.
 
 
 `FFmpeg <https://ffmpeg.org/>`__ (CLI) is a popular open source tool
 `FFmpeg <https://ffmpeg.org/>`__ (CLI) is a popular open source tool
-for this purpose. FFmpeg has a steep learning curve, but it's powerful tool.
+for this purpose. FFmpeg has a steep learning curve, but it's a powerful tool.
 
 
 Here are example FFmpeg commands to convert an MP4 video to Ogg Theora. Since
 Here are example FFmpeg commands to convert an MP4 video to Ogg Theora. Since
 FFmpeg supports a lot of input formats, you should be able to use the commands
 FFmpeg supports a lot of input formats, you should be able to use the commands
@@ -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::