godotengine/godot-docs
1
0
Fork 0
mirror of https://github.com/godotengine/godot-docs.git synced 2026-01-04 14:11:02 +03:00
Code Issues Packages Projects Releases Wiki Activity

Merge pull request #10972 from berarma/playing_videos_4.5

Browse Source 
Update Playing Videos page for Godot 4.5
This commit is contained in:
Matthew
2025-06-27 07:24:34 -04:00
committed by GitHub
parent 89eaa1f590 bca64c8d80
commit 6e72ab3276
1 changed files with 16 additions and 16 deletions
Download Patch File Download Diff File Expand all files Collapse all files

32
tutorials/animation/playing_videos.rst
View File

@@ -150,10 +150,8 @@ To ensure your videos decode smoothly on varied hardware:
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.
- 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.
@@ -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
at the ``configuration:`` line in the command output.
.. 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,
.. this note 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.
.. 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.
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
.. https://trac.ffmpeg.org/ticket/11454 are included in a stable FFmpeg release,
.. 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.
.. 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
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -231,10 +232,9 @@ variable bitrates.
The **GOP (Group of Pictures) size** (``-g:v``) is the max interval between
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.
.. note::