Support webp in imgcodecs module
[platform/upstream/opencv.git] / 3rdparty / ffmpeg / readme.txt
1 * On Linux and other Unix flavors OpenCV uses default or user-built ffmpeg/libav libraries.
2   If user builds ffmpeg/libav from source and wants OpenCV to stay BSD library, not GPL/LGPL,
3   he/she should use --enabled-shared configure flag and make sure that no GPL components are
4   enabled (some notable examples are x264 (H264 encoder) and libac3 (Dolby AC3 audio codec)).
5   See https://www.ffmpeg.org/legal.html for details.
6
7   If you want to play very safe and do not want to use FFMPEG at all, regardless of whether it's installed on
8   your system or not, configure and build OpenCV using CMake with WITH_FFMPEG=OFF flag. OpenCV will then use
9   AVFoundation (OSX), GStreamer (Linux) or other available backends supported by opencv_videoio module.
10
11   There is also our self-contained motion jpeg codec, which you can use without any worries.
12   It handles CV_FOURCC('M', 'J', 'P', 'G') streams within an AVI container (".avi").
13
14 * On Windows OpenCV uses pre-built ffmpeg binaries, built with proper flags (without GPL components) and
15   wrapped with simple, stable OpenCV-compatible API.
16   The binaries are opencv_videoio_ffmpeg.dll (version for 32-bit Windows) and
17   opencv_videoio_ffmpeg_64.dll (version for 64-bit Windows).
18
19   The pre-built opencv_videoio_ffmpeg*.dll is:
20   * LGPL library, not BSD libraries.
21   * Loaded at runtime by opencv_videoio module.
22     If it succeeds, ffmpeg can be used to decode/encode videos;
23     otherwise, other API is used.
24
25   FFMPEG build includes support for H264 encoder based on the OpenH264 library.
26   OpenH264 Video Codec provided by Cisco Systems, Inc.
27   See https://github.com/cisco/openh264/releases for details and OpenH264 license.
28   OpenH264 library should be installed separatelly. Downloaded binary file can be placed into global system path
29   (System32 or SysWOW64) or near application binaries (check documentation of "LoadLibrary" Win32 function from MSDN).
30   Or you can specify location of binary file via OPENH264_LIBRARY environment variable.
31
32   If LGPL/GPL software can not be supplied with your OpenCV-based product, simply exclude
33   opencv_videoio_ffmpeg*.dll from your distribution; OpenCV will stay fully functional except for the ability to
34   decode/encode videos using FFMPEG (though, it may still be able to do that using other API,
35   such as Video for Windows, Windows Media Foundation or our self-contained motion jpeg codec).
36
37   See license.txt for the FFMPEG copyright notice and the licensing terms.