# SPDX-FileCopyrightText: 2006 Matthias Kretz # SPDX-FileCopyrightText: 2008 Alexander Neundorf # SPDX-FileCopyrightText: 2011 Michael Jansen # SPDX-FileCopyrightText: 2021 Stefan BrĂ¼ns # # SPDX-License-Identifier: BSD-3-Clause #[=======================================================================[.rst: FindFFmpeg ---------- Try to find FFmpeg components. The following components are available:: AVCODEC AVFILTER AVDEVICE AVFORMAT AVUTIL SWRESAMPLE SWSCALE POSTPROCESS If no components are specified in the find_module call, the following ones will be choosen as default:: AVFORMAT AVUTIL AVCODEC Imported Targets ^^^^^^^^^^^^^^^^ This module provides the following imported targets, if found: ``FFmpeg::FFmpeg`` For all the required FFmpeg components ``FFmpeg::`` For each that was found Result Variables ^^^^^^^^^^^^^^^^ This will define the following variables: ``FFMPEG_FOUND`` System has the all required components. ``FFMPEG_INCLUDE_DIRS`` Include directory necessary for using the required components headers. ``FFMPEG_LIBRARIES`` Link these to use the required FFmpeg components. ``FFMPEG_DEFINITIONS`` Compiler switches required for using the required FFmpeg components. Additionally for each of the components, the following variables will be defined: ``_FOUND`` True if (the requestion version of) is available ``_INCLUDE_DIRS`` Include directory necessary for using the headers ``_LIBRARIES`` Link these to use ``_DEFINITIONS`` Compiler switches required for using ``_VERSION`` The components version (NOTE: always empty on Windows) As the versions of the various FFmpeg components differ for a given release, and CMake supports only one common version for all components, use the following to specify required versions for multiple components: .. code-block:: cmake find_package(FFmpeg 57.48 COMPONENTS AVCODEC) find_package(FFmpeg 57.40 COMPONENTS AVFORMAT) find_package(FFmpeg 55.27 COMPONENTS AVUTIL) NOTE: version checking is skipped on Windows Since 6.20.0. #]=======================================================================] cmake_policy(VERSION 3.16) include(FindPackageHandleStandardArgs) if(NOT FFmpeg_FIND_COMPONENTS) # The default components were taken from a survey over other FindFFMPEG.cmake files set(FFmpeg_FIND_COMPONENTS AVCODEC AVFORMAT AVUTIL) endif() list(LENGTH FFmpeg_FIND_COMPONENTS _numComponents) if((${_numComponents} GREATER 1) AND DEFINED ${FFmpeg_FIND_VERSION}) message(WARNING "Using a required version in combination with multiple COMPONENTS is not supported") set(_FFmpeg_REQUIRED_VERSION 0) elseif(DEFINED FFmpeg_FIND_VERSION) set(_FFmpeg_REQUIRED_VERSION ${FFmpeg_FIND_VERSION}) else() set(_FFmpeg_REQUIRED_VERSION 0) endif() set(_FFmpeg_ALL_COMPONENTS AVCODEC AVFILTER AVDEVICE AVFORMAT AVUTIL POSTPROCESS SWRESAMPLE SWSCALE) ### Macro: set_component_found # # Marks the given component as found if both *_LIBRARIES AND *_INCLUDE_DIRS is present. macro(set_component_found _component ) if(${_component}_LIBRARIES AND ${_component}_INCLUDE_DIRS) set(${_component}_FOUND TRUE) set(FFmpeg_${_component}_FOUND TRUE) endif() endmacro() macro(create_target _component ) if(${_component}_FOUND AND NOT TARGET FFmpeg::${_component}) add_library(FFmpeg::${_component} UNKNOWN IMPORTED) set_target_properties(FFmpeg::${_component} PROPERTIES IMPORTED_LOCATION "${${_component}_LIBRARIES}" INTERFACE_COMPILE_OPTIONS "${${_component}_DEFINITIONS}" INTERFACE_INCLUDE_DIRECTORIES "${${_component}_INCLUDE_DIRS}" ) endif() endmacro() ### Macro: find_component # # Checks for the given component by invoking pkgconfig and then looking up the libraries and # include directories. macro(find_component _component _pkgconfig _library _header) if(NOT WIN32) # use pkg-config to get the directories and then use these values # in the FIND_PATH() and FIND_LIBRARY() calls find_package(PkgConfig) pkg_check_modules(PC_${_component} QUIET ${_pkgconfig}) endif() find_path(${_component}_INCLUDE_DIRS ${_header} HINTS ${PC_LIB${_component}_INCLUDEDIR} ${PC_LIB${_component}_INCLUDE_DIRS} PATH_SUFFIXES ffmpeg ) find_library(${_component}_LIBRARIES NAMES ${_library} HINTS ${PC_LIB${_component}_LIBDIR} ${PC_LIB${_component}_LIBRARY_DIRS} ) set(${_component}_DEFINITIONS ${PC_${_component}_CFLAGS_OTHER} CACHE STRING "The ${_component} CFLAGS.") set(${_component}_VERSION ${PC_${_component}_VERSION} CACHE STRING "The ${_component} version number.") set_component_found(${_component}) create_target(${_component}) mark_as_advanced( ${_component}_INCLUDE_DIRS ${_component}_LIBRARIES ${_component}_DEFINITIONS ${_component}_VERSION) endmacro() # Check for cached results. If there are skip the costly part. if(NOT FFMPEG_LIBRARIES) # Check for all possible component. find_component(AVCODEC libavcodec avcodec libavcodec/avcodec.h) find_component(AVFILTER libavfilter avfilter libavfilter/avfilter.h) find_component(AVFORMAT libavformat avformat libavformat/avformat.h) find_component(AVDEVICE libavdevice avdevice libavdevice/avdevice.h) find_component(AVUTIL libavutil avutil libavutil/avutil.h) find_component(SWRESAMPLE libswresample swresample libswresample/swresample.h) find_component(SWSCALE libswscale swscale libswscale/swscale.h) find_component(POSTPROCESS libpostproc postproc libpostproc/postprocess.h) # Check if the required components were found and add their stuff to the FFMPEG_* vars. foreach(_component ${_FFmpeg_ALL_COMPONENTS}) if(${_component}_FOUND) set(FFMPEG_LIBRARIES ${FFMPEG_LIBRARIES} ${${_component}_LIBRARIES}) set(FFMPEG_DEFINITIONS ${FFMPEG_DEFINITIONS} ${${_component}_DEFINITIONS}) list(APPEND FFMPEG_INCLUDE_DIRS ${${_component}_INCLUDE_DIRS}) endif() endforeach() # Build the include path with duplicates removed. if(FFMPEG_INCLUDE_DIRS) list(REMOVE_DUPLICATES FFMPEG_INCLUDE_DIRS) endif() # cache the vars. set(FFMPEG_INCLUDE_DIRS ${FFMPEG_INCLUDE_DIRS} CACHE STRING "The FFmpeg include directories." FORCE) set(FFMPEG_LIBRARIES ${FFMPEG_LIBRARIES} CACHE STRING "The FFmpeg libraries." FORCE) set(FFMPEG_DEFINITIONS ${FFMPEG_DEFINITIONS} CACHE STRING "The FFmpeg cflags." FORCE) mark_as_advanced(FFMPEG_INCLUDE_DIRS FFMPEG_LIBRARIES FFMPEG_DEFINITIONS) else() # Set the noncached _FOUND vars for the components. foreach(_component ${_FFmpeg_ALL_COMPONENTS}) set_component_found(${_component}) create_target(${_component}) endforeach() endif() # Compile the list of required vars unset(_FFmpeg_REQUIRED_VARS) set(_FFmpeg_FOUND_LIBRARIES "") foreach(_component ${FFmpeg_FIND_COMPONENTS}) if(${_component}_FOUND) if(NOT WIN32) if(${_component}_VERSION VERSION_LESS _FFmpeg_REQUIRED_VERSION) message(STATUS "${_component}: ${${_component}_VERSION} < ${_FFmpeg_REQUIRED_VERSION}") unset(${_component}_FOUND) endif() else() # We don't use PkgConfig on Windows an hence the _VERSION var is empty # TODO: We could add some magic to retrieve the version from the .pc files or version headers ourself, # like https://github.com/Kitware/VTK/blob/master/CMake/FindFFMPEG.cmake message(WARNING "${_component}: Version check is not supported on Windows, skipping version check") endif() list(APPEND _FFmpeg_FOUND_LIBRARIES ${${_component}_LIBRARIES}) endif() list(APPEND _FFmpeg_REQUIRED_VARS ${_component}_LIBRARIES ${_component}_INCLUDE_DIRS ${_component}_FOUND) endforeach() list(INSERT _FFmpeg_REQUIRED_VARS 0 _FFmpeg_FOUND_LIBRARIES) # Give a nice error message if some of the required vars are missing. find_package_handle_standard_args(FFmpeg REQUIRED_VARS ${_FFmpeg_REQUIRED_VARS} HANDLE_COMPONENTS) # Create the general target if(FFmpeg_FOUND AND NOT TARGET FFmpeg::FFmpeg) add_library(FFmpeg::FFmpeg INTERFACE IMPORTED) foreach(_component ${FFmpeg_FIND_COMPONENTS}) if(${_component}_FOUND AND TARGET FFmpeg::${_component}) target_link_libraries(FFmpeg::FFmpeg INTERFACE FFmpeg::${_component}) endif() endforeach() endif()