diff options
| author | Jøger Hansegård <joger.hansegard@qt.io> | 2024-03-27 17:32:00 +0100 |
|---|---|---|
| committer | Qt Cherry-pick Bot <cherrypick_bot@qt-project.org> | 2024-04-01 17:36:09 +0000 |
| commit | d8a8be10908e80523851bac77e4132996042855e (patch) | |
| tree | 8295dda1f07dd39088ecdf1a634e48421f3834c9 | |
| parent | ea98619e88499f29bb8c609147a4601f50de47bf (diff) | |
Document deployment of dynamically linked FFmpeg on Windows
With latest versions of Qt, FFmpeg is dynamically linked into the FFmpeg
multimedia backend. This patch documents how this change impacts
deployment of Qt applications that uses this backend.
Pick-to: 6.5
Change-Id: I3d374bebc1ee069ce6f170e669a230fc1dfaf391
Reviewed-by: Artem Dyomin <artem.dyomin@qt.io>
(cherry picked from commit e99bc63f3035440750c59038850de11061900df9)
Reviewed-by: Qt Cherry-pick Bot <cherrypick_bot@qt-project.org>
(cherry picked from commit e47eca514d26cbca8af78ae8204a5ca02f4709ae)
| -rw-r--r-- | src/multimedia/doc/src/qtmultimedia-index.qdoc | 13 |
1 files changed, 13 insertions, 0 deletions
diff --git a/src/multimedia/doc/src/qtmultimedia-index.qdoc b/src/multimedia/doc/src/qtmultimedia-index.qdoc index a89bfd6f6..be8943612 100644 --- a/src/multimedia/doc/src/qtmultimedia-index.qdoc +++ b/src/multimedia/doc/src/qtmultimedia-index.qdoc @@ -190,6 +190,19 @@ The version shipped with Qt binary packages is \b{FFmpeg 6.1.1} and is tested by the maintainers. + \note On the Windows platform, Qt's FFmpeg media backend uses + dynamic linking to the FFmpeg libraries. Windows applications must + therefore bundle FFmpeg binaries in their installer, and make them + visible to the application according to Windows dll loading rules. + We recommend to store the FFmpeg dlls in the same directory as the + application's executable file, because this guarantees that the + correct build of FFmpeg is being used if multiple versions are + available on the system. All necessary FFmpeg dlls are shipped with + the Qt Online Installer and are automatically deployed if the + windeployqt tool is used to create the deployment. Applications can + also deploy their own build of FFmpeg, as long as the FFmpeg major + version matches the version used by Qt. + \note See \l{Licenses and Attributions} regarding what components are removed in the package shipped by Qt. |