1 # ----------------------------------------------------------------------------
2 # Root CMake file for OpenCV
4 # From the off-tree build directory, invoke:
5 # $ cmake <PATH_TO_OPENCV_ROOT>
7 # ----------------------------------------------------------------------------
11 include(cmake/OpenCVMinDepVersions.cmake)
13 if(CMAKE_GENERATOR MATCHES Xcode AND XCODE_VERSION VERSION_GREATER 4.3)
14 cmake_minimum_required(VERSION 2.8.8 FATAL_ERROR)
15 elseif(CMAKE_SYSTEM_NAME MATCHES WindowsPhone OR CMAKE_SYSTEM_NAME MATCHES WindowsStore)
16 cmake_minimum_required(VERSION 3.1 FATAL_ERROR)
17 #Required to resolve linker error issues due to incompatibility with CMake v3.0+ policies.
18 #CMake fails to find _fseeko() which leads to subsequent linker error.
19 #See details here: http://www.cmake.org/Wiki/CMake/Policies
20 cmake_policy(VERSION 2.8)
22 cmake_minimum_required(VERSION "${MIN_VER_CMAKE}" FATAL_ERROR)
25 # Following block can broke build in case of cross-compilng
26 # but CMAKE_CROSSCOMPILING variable will be set only on project(OpenCV) command
27 # so we will try to detect crosscompiling by presense of CMAKE_TOOLCHAIN_FILE
28 if(NOT CMAKE_TOOLCHAIN_FILE)
29 # it _must_ go before project(OpenCV) in order to work
31 set(CMAKE_INSTALL_PREFIX "${CMAKE_BINARY_DIR}/install" CACHE PATH "Installation Directory")
33 set(CMAKE_INSTALL_PREFIX "/usr/local" CACHE PATH "Installation Directory")
35 else(NOT CMAKE_TOOLCHAIN_FILE)
36 #Android: set output folder to ${CMAKE_BINARY_DIR}
37 set( LIBRARY_OUTPUT_PATH_ROOT ${CMAKE_BINARY_DIR} CACHE PATH "root for library output, set this to change where android libs are compiled to" )
39 set(CMAKE_INSTALL_PREFIX "${CMAKE_BINARY_DIR}/install" CACHE PATH "Installation Directory")
40 endif(NOT CMAKE_TOOLCHAIN_FILE)
42 if(CMAKE_SYSTEM_NAME MATCHES WindowsPhone OR CMAKE_SYSTEM_NAME MATCHES WindowsStore)
44 endif(CMAKE_SYSTEM_NAME MATCHES WindowsPhone OR CMAKE_SYSTEM_NAME MATCHES WindowsStore)
47 add_definitions(-DWINRT -DNO_GETENV)
49 # Making definitions available to other configurations and
50 # to filter dependency restrictions at compile time.
51 if(CMAKE_SYSTEM_NAME MATCHES WindowsPhone)
53 add_definitions(-DWINRT_PHONE)
54 elseif(CMAKE_SYSTEM_NAME MATCHES WindowsStore)
56 add_definitions(-DWINRT_STORE)
59 if(CMAKE_SYSTEM_VERSION MATCHES 10)
61 add_definitions(-DWINRT_10)
62 elseif(CMAKE_SYSTEM_VERSION MATCHES 8.1)
64 add_definitions(-DWINRT_8_1)
65 elseif(CMAKE_SYSTEM_VERSION MATCHES 8.0)
67 add_definitions(-DWINRT_8_0)
72 cmake_policy(SET CMP0020 OLD)
76 cmake_policy(SET CMP0022 OLD)
80 # silence cmake 3.0+ warnings about reading LOCATION attribute
81 cmake_policy(SET CMP0026 OLD)
85 # silence cmake 3.0+ warnings about MACOSX_RPATH
86 cmake_policy(SET CMP0042 OLD)
89 # must go before the project command
90 set(CMAKE_CONFIGURATION_TYPES "Debug;Release" CACHE STRING "Configs" FORCE)
91 if(DEFINED CMAKE_BUILD_TYPE)
92 set_property( CACHE CMAKE_BUILD_TYPE PROPERTY STRINGS ${CMAKE_CONFIGURATION_TYPES} )
100 set(CMAKE_USE_RELATIVE_PATHS ON CACHE INTERNAL "" FORCE)
103 include(cmake/OpenCVUtils.cmake)
105 ocv_cmake_eval(DEBUG_PRE ONCE)
107 ocv_clear_vars(OpenCVModules_TARGETS)
109 # ----------------------------------------------------------------------------
110 # Break in case of popular CMake configuration mistakes
111 # ----------------------------------------------------------------------------
112 if(NOT CMAKE_SIZEOF_VOID_P GREATER 0)
113 message(FATAL_ERROR "CMake fails to deterimine the bitness of target platform.
114 Please check your CMake and compiler installation. If you are crosscompiling then ensure that your CMake toolchain file correctly sets the compiler details.")
117 # ----------------------------------------------------------------------------
118 # Detect compiler and target platform architecture
119 # ----------------------------------------------------------------------------
120 include(cmake/OpenCVDetectCXXCompiler.cmake)
122 # Add these standard paths to the search paths for FIND_LIBRARY
123 # to find libraries from these locations first
124 if(UNIX AND NOT ANDROID)
125 if(X86_64 OR CMAKE_SIZEOF_VOID_P EQUAL 8)
127 list(APPEND CMAKE_LIBRARY_PATH /lib64)
129 list(APPEND CMAKE_LIBRARY_PATH /lib)
131 if(EXISTS /usr/lib64)
132 list(APPEND CMAKE_LIBRARY_PATH /usr/lib64)
134 list(APPEND CMAKE_LIBRARY_PATH /usr/lib)
136 elseif(X86 OR CMAKE_SIZEOF_VOID_P EQUAL 4)
138 list(APPEND CMAKE_LIBRARY_PATH /lib32)
140 list(APPEND CMAKE_LIBRARY_PATH /lib)
142 if(EXISTS /usr/lib32)
143 list(APPEND CMAKE_LIBRARY_PATH /usr/lib32)
145 list(APPEND CMAKE_LIBRARY_PATH /usr/lib)
150 # Add these standard paths to the search paths for FIND_PATH
151 # to find include files from these locations first
154 list(APPEND CMAKE_INCLUDE_PATH /mingw)
157 list(APPEND CMAKE_INCLUDE_PATH /mingw32)
160 list(APPEND CMAKE_INCLUDE_PATH /mingw64)
164 # ----------------------------------------------------------------------------
165 # OpenCV cmake options
166 # ----------------------------------------------------------------------------
168 # Optional 3rd party components
169 # ===================================================
170 OCV_OPTION(WITH_1394 "Include IEEE1394 support" ON IF (NOT ANDROID AND NOT IOS AND NOT WINRT) )
171 OCV_OPTION(WITH_AVFOUNDATION "Use AVFoundation for Video I/O" ON IF IOS)
172 OCV_OPTION(WITH_CARBON "Use Carbon for UI instead of Cocoa" OFF IF APPLE )
173 OCV_OPTION(WITH_VTK "Include VTK library support (and build opencv_viz module eiher)" ON IF (NOT ANDROID AND NOT IOS AND NOT WINRT AND NOT CMAKE_CROSSCOMPILING) )
174 OCV_OPTION(WITH_CUDA "Include NVidia Cuda Runtime support" ON IF (NOT IOS AND NOT WINRT) )
175 OCV_OPTION(WITH_CUFFT "Include NVidia Cuda Fast Fourier Transform (FFT) library support" ON IF (NOT IOS AND NOT WINRT) )
176 OCV_OPTION(WITH_CUBLAS "Include NVidia Cuda Basic Linear Algebra Subprograms (BLAS) library support" OFF IF (NOT IOS AND NOT WINRT) )
177 OCV_OPTION(WITH_NVCUVID "Include NVidia Video Decoding library support" OFF IF (NOT IOS AND NOT APPLE) )
178 OCV_OPTION(WITH_EIGEN "Include Eigen2/Eigen3 support" ON IF (NOT WINRT) )
179 OCV_OPTION(WITH_VFW "Include Video for Windows support" ON IF WIN32 )
180 OCV_OPTION(WITH_FFMPEG "Include FFMPEG support" ON IF (NOT ANDROID AND NOT IOS AND NOT WINRT) )
181 OCV_OPTION(WITH_GSTREAMER "Include Gstreamer support" ON IF (NOT ANDROID) )
182 OCV_OPTION(WITH_GSTREAMER_0_10 "Enable Gstreamer 0.10 support (instead of 1.x)" OFF )
183 OCV_OPTION(WITH_GTK "Include GTK support" ON IF (UNIX AND NOT APPLE AND NOT ANDROID) )
184 OCV_OPTION(WITH_GTK_2_X "Use GTK version 2" OFF IF (UNIX AND NOT APPLE AND NOT ANDROID) )
185 OCV_OPTION(WITH_IPP "Include Intel IPP support" NOT MINGW IF (X86_64 OR X86) AND NOT WINRT )
186 OCV_OPTION(WITH_JASPER "Include JPEG2K support" ON IF (NOT IOS) )
187 OCV_OPTION(WITH_JPEG "Include JPEG support" ON)
188 OCV_OPTION(WITH_WEBP "Include WebP support" ON IF (NOT IOS AND NOT WINRT) )
189 OCV_OPTION(WITH_OPENEXR "Include ILM support via OpenEXR" ON IF (NOT IOS AND NOT WINRT) )
190 OCV_OPTION(WITH_OPENGL "Include OpenGL support" OFF IF (NOT ANDROID AND NOT WINRT) )
191 OCV_OPTION(WITH_OPENNI "Include OpenNI support" OFF IF (NOT ANDROID AND NOT IOS AND NOT WINRT) )
192 OCV_OPTION(WITH_OPENNI2 "Include OpenNI2 support" OFF IF (NOT ANDROID AND NOT IOS AND NOT WINRT) )
193 OCV_OPTION(WITH_PNG "Include PNG support" ON)
194 OCV_OPTION(WITH_PVAPI "Include Prosilica GigE support" OFF IF (NOT ANDROID AND NOT IOS AND NOT WINRT) )
195 OCV_OPTION(WITH_GIGEAPI "Include Smartek GigE support" OFF IF (NOT ANDROID AND NOT IOS AND NOT WINRT) )
196 OCV_OPTION(WITH_QT "Build with Qt Backend support" OFF IF (NOT ANDROID AND NOT IOS AND NOT WINRT) )
197 OCV_OPTION(WITH_WIN32UI "Build with Win32 UI Backend support" ON IF WIN32 AND NOT WINRT)
198 OCV_OPTION(WITH_QUICKTIME "Use QuickTime for Video I/O insted of QTKit" OFF IF APPLE )
199 OCV_OPTION(WITH_TBB "Include Intel TBB support" OFF IF (NOT IOS AND NOT WINRT) )
200 OCV_OPTION(WITH_OPENMP "Include OpenMP support" OFF)
201 OCV_OPTION(WITH_CSTRIPES "Include C= support" OFF IF (WIN32 AND NOT WINRT) )
202 OCV_OPTION(WITH_PTHREADS_PF "Use pthreads-based parallel_for" ON IF (NOT WIN32 OR MINGW) )
203 OCV_OPTION(WITH_TIFF "Include TIFF support" ON IF (NOT IOS) )
204 OCV_OPTION(WITH_UNICAP "Include Unicap support (GPL)" OFF IF (UNIX AND NOT APPLE AND NOT ANDROID) )
205 OCV_OPTION(WITH_V4L "Include Video 4 Linux support" ON IF (UNIX AND NOT ANDROID) )
206 OCV_OPTION(WITH_LIBV4L "Use libv4l for Video 4 Linux support" OFF IF (UNIX AND NOT ANDROID) )
207 OCV_OPTION(WITH_DSHOW "Build VideoIO with DirectShow support" ON IF (WIN32 AND NOT ARM AND NOT WINRT) )
208 OCV_OPTION(WITH_MSMF "Build VideoIO with Media Foundation support" OFF IF WIN32 )
209 OCV_OPTION(WITH_XIMEA "Include XIMEA cameras support" OFF IF (NOT ANDROID AND NOT WINRT) )
210 OCV_OPTION(WITH_XINE "Include Xine support (GPL)" OFF IF (UNIX AND NOT APPLE AND NOT ANDROID) )
211 OCV_OPTION(WITH_CLP "Include Clp support (EPL)" OFF)
212 OCV_OPTION(WITH_OPENCL "Include OpenCL Runtime support" NOT ANDROID IF (NOT IOS AND NOT WINRT) )
213 OCV_OPTION(WITH_OPENCL_SVM "Include OpenCL Shared Virtual Memory support" OFF ) # experimental
214 OCV_OPTION(WITH_OPENCLAMDFFT "Include AMD OpenCL FFT library support" ON IF (NOT ANDROID AND NOT IOS AND NOT WINRT) )
215 OCV_OPTION(WITH_OPENCLAMDBLAS "Include AMD OpenCL BLAS library support" ON IF (NOT ANDROID AND NOT IOS AND NOT WINRT) )
216 OCV_OPTION(WITH_DIRECTX "Include DirectX support" ON IF (WIN32 AND NOT WINRT) )
217 OCV_OPTION(WITH_INTELPERC "Include Intel Perceptual Computing support" OFF IF (WIN32 AND NOT WINRT) )
218 OCV_OPTION(WITH_IPP_A "Include Intel IPP_A support" OFF IF (MSVC OR X86 OR X86_64) )
219 OCV_OPTION(WITH_MATLAB "Include Matlab support" ON IF (NOT ANDROID AND NOT IOS AND NOT WINRT))
220 OCV_OPTION(WITH_VA "Include VA support" OFF IF (UNIX AND NOT ANDROID) )
221 OCV_OPTION(WITH_VA_INTEL "Include Intel VA-API/OpenCL support" OFF IF (UNIX AND NOT ANDROID) )
222 OCV_OPTION(WITH_GDAL "Include GDAL Support" OFF IF (NOT ANDROID AND NOT IOS AND NOT WINRT) )
223 OCV_OPTION(WITH_GPHOTO2 "Include gPhoto2 library support" ON IF (UNIX AND NOT ANDROID) )
225 # OpenCV build components
226 # ===================================================
227 OCV_OPTION(BUILD_SHARED_LIBS "Build shared libraries (.dll/.so) instead of static ones (.lib/.a)" NOT (ANDROID OR APPLE_FRAMEWORK) )
228 OCV_OPTION(BUILD_opencv_apps "Build utility applications (used for example to train classifiers)" (NOT ANDROID AND NOT WINRT) IF (NOT APPLE_FRAMEWORK) )
229 OCV_OPTION(BUILD_ANDROID_EXAMPLES "Build examples for Android platform" ON IF ANDROID )
230 OCV_OPTION(BUILD_DOCS "Create build rules for OpenCV Documentation" ON IF (NOT WINRT OR APPLE_FRAMEWORK))
231 OCV_OPTION(BUILD_EXAMPLES "Build all examples" OFF )
232 OCV_OPTION(BUILD_PACKAGE "Enables 'make package_source' command" ON IF NOT WINRT)
233 OCV_OPTION(BUILD_PERF_TESTS "Build performance tests" ON IF (NOT APPLE_FRAMEWORK) )
234 OCV_OPTION(BUILD_TESTS "Build accuracy & regression tests" ON IF (NOT APPLE_FRAMEWORK) )
235 OCV_OPTION(BUILD_WITH_DEBUG_INFO "Include debug info into debug libs (not MSCV only)" ON )
236 OCV_OPTION(BUILD_WITH_STATIC_CRT "Enables use of staticaly linked CRT for staticaly linked OpenCV" ON IF MSVC )
237 OCV_OPTION(BUILD_WITH_DYNAMIC_IPP "Enables dynamic linking of IPP (only for standalone IPP)" OFF )
238 OCV_OPTION(BUILD_FAT_JAVA_LIB "Create fat java wrapper containing the whole OpenCV library" ON IF NOT BUILD_SHARED_LIBS AND CMAKE_COMPILER_IS_GNUCXX )
239 OCV_OPTION(BUILD_ANDROID_SERVICE "Build OpenCV Manager for Google Play" OFF IF ANDROID )
240 OCV_OPTION(BUILD_CUDA_STUBS "Build CUDA modules stubs when no CUDA SDK" OFF IF (NOT APPLE_FRAMEWORK) )
243 OCV_OPTION(BUILD_ZLIB "Build zlib from source" WIN32 OR APPLE )
244 OCV_OPTION(BUILD_TIFF "Build libtiff from source" WIN32 OR ANDROID OR APPLE )
245 OCV_OPTION(BUILD_JASPER "Build libjasper from source" WIN32 OR ANDROID OR APPLE )
246 OCV_OPTION(BUILD_JPEG "Build libjpeg from source" WIN32 OR ANDROID OR APPLE )
247 OCV_OPTION(BUILD_PNG "Build libpng from source" WIN32 OR ANDROID OR APPLE )
248 OCV_OPTION(BUILD_OPENEXR "Build openexr from source" (WIN32 OR ANDROID OR APPLE) AND NOT WINRT)
249 OCV_OPTION(BUILD_TBB "Download and build TBB from source" ANDROID )
251 # OpenCV installation options
252 # ===================================================
253 OCV_OPTION(INSTALL_CREATE_DISTRIB "Change install rules to build the distribution package" OFF )
254 OCV_OPTION(INSTALL_C_EXAMPLES "Install C examples" OFF )
255 OCV_OPTION(INSTALL_PYTHON_EXAMPLES "Install Python examples" OFF )
256 OCV_OPTION(INSTALL_ANDROID_EXAMPLES "Install Android examples" OFF IF ANDROID )
257 OCV_OPTION(INSTALL_TO_MANGLED_PATHS "Enables mangled install paths, that help with side by side installs." OFF IF (UNIX AND NOT ANDROID AND NOT APPLE_FRAMEWORK AND BUILD_SHARED_LIBS) )
258 OCV_OPTION(INSTALL_TESTS "Install accuracy and performance test binaries and test data" OFF)
260 # OpenCV build options
261 # ===================================================
262 OCV_OPTION(ENABLE_PRECOMPILED_HEADERS "Use precompiled headers" ON IF (NOT IOS AND NOT CMAKE_CROSSCOMPILING) )
263 OCV_OPTION(ENABLE_SOLUTION_FOLDERS "Solution folder in Visual Studio or in other IDEs" (MSVC_IDE OR CMAKE_GENERATOR MATCHES Xcode) )
264 OCV_OPTION(ENABLE_PROFILING "Enable profiling in the GCC compiler (Add flags: -g -pg)" OFF IF CMAKE_COMPILER_IS_GNUCXX )
265 OCV_OPTION(ENABLE_COVERAGE "Enable coverage collection with GCov" OFF IF CMAKE_COMPILER_IS_GNUCXX )
266 OCV_OPTION(ENABLE_OMIT_FRAME_POINTER "Enable -fomit-frame-pointer for GCC" ON IF CMAKE_COMPILER_IS_GNUCXX AND NOT (APPLE AND CMAKE_COMPILER_IS_CLANGCXX) )
267 OCV_OPTION(ENABLE_POWERPC "Enable PowerPC for GCC" ON IF (CMAKE_COMPILER_IS_GNUCXX AND CMAKE_SYSTEM_PROCESSOR MATCHES powerpc.*) )
268 OCV_OPTION(ENABLE_FAST_MATH "Enable -ffast-math (not recommended for GCC 4.6.x)" OFF IF (CMAKE_COMPILER_IS_GNUCXX AND (X86 OR X86_64)) )
269 OCV_OPTION(ENABLE_SSE "Enable SSE instructions" ON IF ((MSVC OR CMAKE_COMPILER_IS_GNUCXX) AND (X86 OR X86_64)) )
270 OCV_OPTION(ENABLE_SSE2 "Enable SSE2 instructions" ON IF ((MSVC OR CMAKE_COMPILER_IS_GNUCXX) AND (X86 OR X86_64)) )
271 OCV_OPTION(ENABLE_SSE3 "Enable SSE3 instructions" ON IF ((MSVC OR CMAKE_COMPILER_IS_GNUCXX OR CV_ICC) AND (X86 OR X86_64)) )
272 OCV_OPTION(ENABLE_SSSE3 "Enable SSSE3 instructions" OFF IF ((MSVC OR CMAKE_COMPILER_IS_GNUCXX) AND (X86 OR X86_64)) )
273 OCV_OPTION(ENABLE_SSE41 "Enable SSE4.1 instructions" OFF IF ((MSVC OR CMAKE_COMPILER_IS_GNUCXX OR CV_ICC) AND (X86 OR X86_64)) )
274 OCV_OPTION(ENABLE_SSE42 "Enable SSE4.2 instructions" OFF IF ((MSVC OR CMAKE_COMPILER_IS_GNUCXX) AND (X86 OR X86_64)) )
275 OCV_OPTION(ENABLE_POPCNT "Enable POPCNT instructions" OFF IF ((MSVC OR CMAKE_COMPILER_IS_GNUCXX) AND (X86 OR X86_64)) )
276 OCV_OPTION(ENABLE_AVX "Enable AVX instructions" OFF IF ((MSVC OR CMAKE_COMPILER_IS_GNUCXX) AND (X86 OR X86_64)) )
277 OCV_OPTION(ENABLE_AVX2 "Enable AVX2 instructions" OFF IF ((MSVC OR CMAKE_COMPILER_IS_GNUCXX) AND (X86 OR X86_64)) )
278 OCV_OPTION(ENABLE_FMA3 "Enable FMA3 instructions" OFF IF ((MSVC OR CMAKE_COMPILER_IS_GNUCXX) AND (X86 OR X86_64)) )
279 OCV_OPTION(ENABLE_NEON "Enable NEON instructions" "${NEON}" IF CMAKE_COMPILER_IS_GNUCXX AND (ARM OR AARCH64 OR IOS) )
280 OCV_OPTION(ENABLE_VFPV3 "Enable VFPv3-D32 instructions" OFF IF CMAKE_COMPILER_IS_GNUCXX AND (ARM OR AARCH64 OR IOS) )
281 OCV_OPTION(ENABLE_NOISY_WARNINGS "Show all warnings even if they are too noisy" OFF )
282 OCV_OPTION(OPENCV_WARNINGS_ARE_ERRORS "Treat warnings as errors" OFF )
283 OCV_OPTION(ANDROID_EXAMPLES_WITH_LIBS "Build binaries of Android examples with native libraries" OFF IF ANDROID )
284 OCV_OPTION(ENABLE_IMPL_COLLECTION "Collect implementation data on function call" OFF )
285 OCV_OPTION(GENERATE_ABI_DESCRIPTOR "Generate XML file for abi_compliance_checker tool" OFF IF UNIX)
287 OCV_OPTION(DOWNLOAD_EXTERNAL_TEST_DATA "Download external test data (Python executable and OPENCV_TEST_DATA_PATH environment variable may be required)" OFF )
290 if(ENABLE_IMPL_COLLECTION)
291 add_definitions(-DCV_COLLECT_IMPL_DATA)
295 # ----------------------------------------------------------------------------
296 # Get actual OpenCV version number from sources
297 # ----------------------------------------------------------------------------
298 include(cmake/OpenCVVersion.cmake)
301 # ----------------------------------------------------------------------------
302 # Build & install layouts
303 # ----------------------------------------------------------------------------
305 # Save libs and executables in the same place
306 set(EXECUTABLE_OUTPUT_PATH "${CMAKE_BINARY_DIR}/bin" CACHE PATH "Output directory for applications" )
309 if (ANDROID_ABI MATCHES "NEON")
312 if (ANDROID_ABI MATCHES "VFPV3")
318 set(OPENCV_DOC_INSTALL_PATH doc)
320 set(OPENCV_DOC_INSTALL_PATH share/OpenCV/doc)
323 if(WIN32 AND CMAKE_HOST_SYSTEM_NAME MATCHES Windows)
324 if(DEFINED OpenCV_RUNTIME AND DEFINED OpenCV_ARCH)
325 set(OpenCV_INSTALL_BINARIES_PREFIX "${OpenCV_ARCH}/${OpenCV_RUNTIME}/")
327 message(STATUS "Can't detect runtime and/or arch")
328 set(OpenCV_INSTALL_BINARIES_PREFIX "")
331 set(OpenCV_INSTALL_BINARIES_PREFIX "sdk/native/")
333 set(OpenCV_INSTALL_BINARIES_PREFIX "")
337 set(OPENCV_SAMPLES_BIN_INSTALL_PATH "${OpenCV_INSTALL_BINARIES_PREFIX}samples/${ANDROID_NDK_ABI_NAME}")
339 set(OPENCV_SAMPLES_BIN_INSTALL_PATH "${OpenCV_INSTALL_BINARIES_PREFIX}samples")
343 set(OPENCV_BIN_INSTALL_PATH "${OpenCV_INSTALL_BINARIES_PREFIX}bin/${ANDROID_NDK_ABI_NAME}")
345 set(OPENCV_BIN_INSTALL_PATH "${OpenCV_INSTALL_BINARIES_PREFIX}bin")
348 if(NOT OPENCV_TEST_INSTALL_PATH)
349 set(OPENCV_TEST_INSTALL_PATH "${OPENCV_BIN_INSTALL_PATH}")
352 if (OPENCV_TEST_DATA_PATH)
353 get_filename_component(OPENCV_TEST_DATA_PATH ${OPENCV_TEST_DATA_PATH} ABSOLUTE)
356 if(OPENCV_TEST_DATA_PATH AND NOT OPENCV_TEST_DATA_INSTALL_PATH)
358 set(OPENCV_TEST_DATA_INSTALL_PATH "sdk/etc/testdata")
360 set(OPENCV_TEST_DATA_INSTALL_PATH "testdata")
362 set(OPENCV_TEST_DATA_INSTALL_PATH "share/OpenCV/testdata")
367 set(LIBRARY_OUTPUT_PATH "${OpenCV_BINARY_DIR}/lib/${ANDROID_NDK_ABI_NAME}")
368 set(3P_LIBRARY_OUTPUT_PATH "${OpenCV_BINARY_DIR}/3rdparty/lib/${ANDROID_NDK_ABI_NAME}")
369 set(OPENCV_LIB_INSTALL_PATH sdk/native/libs/${ANDROID_NDK_ABI_NAME})
370 set(OPENCV_3P_LIB_INSTALL_PATH sdk/native/3rdparty/libs/${ANDROID_NDK_ABI_NAME})
371 set(OPENCV_CONFIG_INSTALL_PATH sdk/native/jni)
372 set(OPENCV_INCLUDE_INSTALL_PATH sdk/native/jni/include)
373 set(OPENCV_SAMPLES_SRC_INSTALL_PATH samples/native)
374 set(OPENCV_OTHER_INSTALL_PATH sdk/etc)
376 set(LIBRARY_OUTPUT_PATH "${OpenCV_BINARY_DIR}/lib")
377 set(3P_LIBRARY_OUTPUT_PATH "${OpenCV_BINARY_DIR}/3rdparty/lib${LIB_SUFFIX}")
379 if(WIN32 AND CMAKE_HOST_SYSTEM_NAME MATCHES Windows)
381 set(OPENCV_LIB_INSTALL_PATH "${OpenCV_INSTALL_BINARIES_PREFIX}staticlib${LIB_SUFFIX}")
383 set(OPENCV_LIB_INSTALL_PATH "${OpenCV_INSTALL_BINARIES_PREFIX}lib${LIB_SUFFIX}")
385 set(OPENCV_3P_LIB_INSTALL_PATH "${OpenCV_INSTALL_BINARIES_PREFIX}staticlib${LIB_SUFFIX}")
386 set(OPENCV_SAMPLES_SRC_INSTALL_PATH samples/native)
387 set(OPENCV_JAR_INSTALL_PATH java)
388 set(OPENCV_OTHER_INSTALL_PATH etc)
390 set(OPENCV_LIB_INSTALL_PATH lib${LIB_SUFFIX})
391 set(OPENCV_3P_LIB_INSTALL_PATH share/OpenCV/3rdparty/${OPENCV_LIB_INSTALL_PATH})
392 set(OPENCV_SAMPLES_SRC_INSTALL_PATH share/OpenCV/samples)
393 set(OPENCV_JAR_INSTALL_PATH share/OpenCV/java)
394 set(OPENCV_OTHER_INSTALL_PATH share/OpenCV)
396 set(OPENCV_INCLUDE_INSTALL_PATH "include")
398 math(EXPR SIZEOF_VOID_P_BITS "8 * ${CMAKE_SIZEOF_VOID_P}")
399 if(LIB_SUFFIX AND NOT SIZEOF_VOID_P_BITS EQUAL LIB_SUFFIX)
400 set(OPENCV_CONFIG_INSTALL_PATH lib${LIB_SUFFIX}/cmake/opencv)
402 set(OPENCV_CONFIG_INSTALL_PATH share/OpenCV)
406 set(CMAKE_INSTALL_RPATH "${CMAKE_INSTALL_PREFIX}/${OPENCV_LIB_INSTALL_PATH}")
407 set(CMAKE_INSTALL_RPATH_USE_LINK_PATH TRUE)
409 if(INSTALL_TO_MANGLED_PATHS)
410 set(OPENCV_INCLUDE_INSTALL_PATH ${OPENCV_INCLUDE_INSTALL_PATH}/opencv-${OPENCV_VERSION})
411 string(REPLACE "OpenCV" "OpenCV-${OPENCV_VERSION}" OPENCV_3P_LIB_INSTALL_PATH "${OPENCV_3P_LIB_INSTALL_PATH}")
412 string(REPLACE "OpenCV" "OpenCV-${OPENCV_VERSION}" OPENCV_SAMPLES_SRC_INSTALL_PATH "${OPENCV_SAMPLES_SRC_INSTALL_PATH}")
413 string(REPLACE "OpenCV" "OpenCV-${OPENCV_VERSION}" OPENCV_CONFIG_INSTALL_PATH "${OPENCV_CONFIG_INSTALL_PATH}")
414 string(REPLACE "OpenCV" "OpenCV-${OPENCV_VERSION}" OPENCV_DOC_INSTALL_PATH "${OPENCV_DOC_INSTALL_PATH}")
415 string(REPLACE "OpenCV" "OpenCV-${OPENCV_VERSION}" OPENCV_JAR_INSTALL_PATH "${OPENCV_JAR_INSTALL_PATH}")
416 string(REPLACE "OpenCV" "OpenCV-${OPENCV_VERSION}" OPENCV_TEST_DATA_INSTALL_PATH "${OPENCV_TEST_DATA_INSTALL_PATH}")
417 string(REPLACE "OpenCV" "OpenCV-${OPENCV_VERSION}" OPENCV_OTHER_INSTALL_PATH "${OPENCV_OTHER_INSTALL_PATH}")
423 set(OPENCV_DLLVERSION "${OPENCV_VERSION_MAJOR}${OPENCV_VERSION_MINOR}${OPENCV_VERSION_PATCH}")
424 set(OPENCV_DEBUG_POSTFIX d)
427 set(OPENCV_DLLVERSION "")
428 set(OPENCV_DEBUG_POSTFIX "")
431 if(DEFINED CMAKE_DEBUG_POSTFIX)
432 set(OPENCV_DEBUG_POSTFIX "${CMAKE_DEBUG_POSTFIX}")
435 if((INSTALL_CREATE_DISTRIB AND BUILD_SHARED_LIBS AND NOT DEFINED BUILD_opencv_world) OR APPLE_FRAMEWORK)
436 set(BUILD_opencv_world ON CACHE INTERNAL "")
439 # ----------------------------------------------------------------------------
440 # Path for build/platform -specific headers
441 # ----------------------------------------------------------------------------
442 set(OPENCV_CONFIG_FILE_INCLUDE_DIR "${CMAKE_BINARY_DIR}/" CACHE PATH "Where to create the platform-dependant cvconfig.h")
443 ocv_include_directories(${OPENCV_CONFIG_FILE_INCLUDE_DIR})
445 # ----------------------------------------------------------------------------
446 # Path for additional modules
447 # ----------------------------------------------------------------------------
448 set(OPENCV_EXTRA_MODULES_PATH "" CACHE PATH "Where to look for additional OpenCV modules")
450 # ----------------------------------------------------------------------------
451 # Autodetect if we are in a GIT repository
452 # ----------------------------------------------------------------------------
453 find_host_package(Git QUIET)
456 execute_process(COMMAND "${GIT_EXECUTABLE}" describe --tags --always --dirty --match "[0-9].[0-9].[0-9]*"
457 WORKING_DIRECTORY "${OpenCV_SOURCE_DIR}"
458 OUTPUT_VARIABLE OPENCV_VCSVERSION
459 RESULT_VARIABLE GIT_RESULT
461 OUTPUT_STRIP_TRAILING_WHITESPACE
463 if(NOT GIT_RESULT EQUAL 0)
464 set(OPENCV_VCSVERSION "unknown")
468 set(OPENCV_VCSVERSION "unknown")
472 # ----------------------------------------------------------------------------
473 # OpenCV compiler and linker options
474 # ----------------------------------------------------------------------------
475 # In case of Makefiles if the user does not setup CMAKE_BUILD_TYPE, assume it's Release:
476 if(CMAKE_GENERATOR MATCHES "Makefiles|Ninja" AND "${CMAKE_BUILD_TYPE}" STREQUAL "")
477 set(CMAKE_BUILD_TYPE Release)
480 include(cmake/OpenCVCompilerOptions.cmake)
483 # ----------------------------------------------------------------------------
484 # Use statically or dynamically linked CRT?
486 # ----------------------------------------------------------------------------
488 include(cmake/OpenCVCRTLinkage.cmake)
491 if(WIN32 AND NOT MINGW)
492 add_definitions(-D_VARIADIC_MAX=10)
493 endif(WIN32 AND NOT MINGW)
496 # ----------------------------------------------------------------------------
497 # CHECK FOR SYSTEM LIBRARIES, OPTIONS, ETC..
498 # ----------------------------------------------------------------------------
500 find_package(PkgConfig QUIET)
501 include(CheckFunctionExists)
502 include(CheckIncludeFile)
505 CHECK_INCLUDE_FILE(pthread.h HAVE_LIBPTHREAD)
507 set(OPENCV_LINKER_LIBS ${OPENCV_LINKER_LIBS} dl m log)
508 elseif(${CMAKE_SYSTEM_NAME} MATCHES "FreeBSD|NetBSD|DragonFly|OpenBSD")
509 set(OPENCV_LINKER_LIBS ${OPENCV_LINKER_LIBS} m pthread)
511 # no need to link to system libs with emscripten
513 set(OPENCV_LINKER_LIBS ${OPENCV_LINKER_LIBS} dl m pthread rt)
516 set(HAVE_LIBPTHREAD YES)
520 include(cmake/OpenCVPCHSupport.cmake)
521 include(cmake/OpenCVModule.cmake)
523 # ----------------------------------------------------------------------------
524 # Detect endianness of build platform
525 # ----------------------------------------------------------------------------
528 # test_big_endian needs try_compile, which doesn't work for iOS
529 # http://public.kitware.com/Bug/view.php?id=12288
530 set(WORDS_BIGENDIAN 0)
532 include(TestBigEndian)
533 test_big_endian(WORDS_BIGENDIAN)
536 # ----------------------------------------------------------------------------
537 # Detect 3rd-party libraries
538 # ----------------------------------------------------------------------------
540 include(cmake/OpenCVFindLibsGrfmt.cmake)
541 include(cmake/OpenCVFindLibsGUI.cmake)
542 include(cmake/OpenCVFindLibsVideo.cmake)
543 include(cmake/OpenCVFindLibsPerf.cmake)
545 # ----------------------------------------------------------------------------
546 # Detect other 3rd-party libraries/tools
547 # ----------------------------------------------------------------------------
549 # --- Doxygen and PlantUML for documentation ---
550 unset(DOXYGEN_FOUND CACHE)
552 find_package(Doxygen)
554 message(STATUS "Using PlantUML path from command line: ${PLANTUML_JAR}")
555 elseif(DEFINED ENV{PLANTUML_JAR})
556 set(PLANTUML_JAR $ENV{PLANTUML_JAR})
557 message(STATUS "Using PLantUML path from environment: ${PLANTUML_JAR}")
559 message(STATUS "To enable PlantUML support, set PLANTUML_JAR environment variable or pass -DPLANTUML_JAR=<filepath> option to cmake")
561 if (PLANTUML_JAR AND DOXYGEN_VERSION VERSION_LESS 1.8.8)
562 message(STATUS "You need Doxygen version 1.8.8 or later to use PlantUML")
567 # --- Python Support ---
568 include(cmake/OpenCVDetectPython.cmake)
570 # --- Java Support ---
571 include(cmake/OpenCVDetectApacheAnt.cmake)
573 include(cmake/OpenCVDetectAndroidSDK.cmake)
575 if(NOT ANDROID_TOOLS_Pkg_Revision GREATER 13)
576 message(WARNING "OpenCV requires Android SDK tools revision 14 or newer. Otherwise tests and samples will no be compiled.")
582 if(ANDROID AND ANDROID_EXECUTABLE AND ANT_EXECUTABLE AND (ANT_VERSION VERSION_GREATER 1.7) AND (ANDROID_TOOLS_Pkg_Revision GREATER 13))
583 SET(CAN_BUILD_ANDROID_PROJECTS TRUE)
585 SET(CAN_BUILD_ANDROID_PROJECTS FALSE)
590 include(cmake/OpenCVDetectOpenCL.cmake)
595 include(cmake/OpenCVDetectDirectX.cmake)
598 # --- Matlab/Octave ---
600 include(cmake/OpenCVFindMatlab.cmake)
603 include(cmake/OpenCVDetectVTK.cmake)
605 # -- Custom HAL replacement --
607 # assuming OPENCV_HAL_HEADERS and OPENCV_HAL_LIBS are lists of files:
608 # option example: -DOPENCV_HAL_HEADERS="<some-path>/header1.h;<some-path>/header2.h"
609 if (OPENCV_HAL_HEADERS AND OPENCV_HAL_LIBS)
610 foreach (h ${OPENCV_HAL_HEADERS})
611 get_filename_component(h "${h}" ABSOLUTE)
612 set(_includes "${_includes}\n#include \"${h}\"")
614 foreach (l ${OPENCV_HAL_LIBS})
615 get_filename_component(l "${l}" ABSOLUTE)
616 set(OPENCV_LINKER_LIBS ${OPENCV_LINKER_LIBS} ${l})
618 # ocv_install_target(${l} EXPORT OpenCVModules ARCHIVE DESTINATION ${OPENCV_3P_LIB_INSTALL_PATH} COMPONENT dev)
621 set(_includes "// using default HAL")
622 unset(OPENCV_HAL_HEADERS CACHE)
623 unset(OPENCV_HAL_LIBS CACHE)
625 set(OPENCV_HAL_HEADERS "${OPENCV_HAL_HEADERS}" CACHE STRING "Headers with custom HAL implementation")
626 set(OPENCV_HAL_LIBS "${OPENCV_HAL_LIBS}" CACHE STRING "Libraries with custom HAL implementation")
627 configure_file("${OpenCV_SOURCE_DIR}/cmake/templates/custom_hal.hpp.in" "${CMAKE_BINARY_DIR}/custom_hal.hpp" @ONLY)
630 # ----------------------------------------------------------------------------
631 # Add CUDA libraries (needed for apps/tools, samples)
632 # ----------------------------------------------------------------------------
634 set(OPENCV_LINKER_LIBS ${OPENCV_LINKER_LIBS} ${CUDA_LIBRARIES} ${CUDA_npp_LIBRARY})
636 set(OPENCV_LINKER_LIBS ${OPENCV_LINKER_LIBS} ${CUDA_cublas_LIBRARY})
639 set(OPENCV_LINKER_LIBS ${OPENCV_LINKER_LIBS} ${CUDA_cufft_LIBRARY})
641 foreach(p ${CUDA_LIBS_PATH})
642 set(OPENCV_LINKER_LIBS ${OPENCV_LINKER_LIBS} -L${p})
645 # ----------------------------------------------------------------------------
647 # ----------------------------------------------------------------------------
648 if(ENABLE_SOLUTION_FOLDERS)
649 set_property(GLOBAL PROPERTY USE_FOLDERS ON)
650 set_property(GLOBAL PROPERTY PREDEFINED_TARGETS_FOLDER "CMakeTargets")
653 # Extra OpenCV targets: uninstall, package_source, perf, etc.
654 include(cmake/OpenCVExtraTargets.cmake)
657 # ----------------------------------------------------------------------------
658 # Process subdirectories
659 # ----------------------------------------------------------------------------
661 # opencv.hpp and legacy headers
662 add_subdirectory(include)
665 add_subdirectory(modules)
667 # Generate targets for documentation
668 add_subdirectory(doc)
670 # various data that is used by cv libraries and/or demo applications.
671 add_subdirectory(data)
674 if(BUILD_opencv_apps)
675 add_subdirectory(apps)
679 if(BUILD_EXAMPLES OR BUILD_ANDROID_EXAMPLES OR INSTALL_PYTHON_EXAMPLES)
680 add_subdirectory(samples)
684 add_subdirectory(platforms/android/service)
687 # ----------------------------------------------------------------------------
688 # Finalization: generate configuration-based files
689 # ----------------------------------------------------------------------------
691 # Generate platform-dependent and configuration-dependent headers
692 include(cmake/OpenCVGenHeaders.cmake)
694 # Generate opencv.pc for pkg-config command
695 include(cmake/OpenCVGenPkgconfig.cmake)
697 # Generate OpenCV.mk for ndk-build (Android build tool)
698 include(cmake/OpenCVGenAndroidMK.cmake)
700 # Generate OpenCVConfig.cmake and OpenCVConfig-version.cmake for cmake projects
701 include(cmake/OpenCVGenConfig.cmake)
703 # Generate Info.plist for the IOS framework
705 include(cmake/OpenCVGenInfoPlist.cmake)
708 # Generate ABI descriptor
709 include(cmake/OpenCVGenABI.cmake)
711 # Generate environment setup file
712 if(INSTALL_TESTS AND OPENCV_TEST_DATA_PATH)
714 get_filename_component(TEST_PATH ${OPENCV_TEST_INSTALL_PATH} DIRECTORY)
715 configure_file("${CMAKE_CURRENT_SOURCE_DIR}/cmake/templates/opencv_run_all_tests_android.sh.in"
716 "${CMAKE_BINARY_DIR}/unix-install/opencv_run_all_tests.sh" @ONLY)
717 install(PROGRAMS "${CMAKE_BINARY_DIR}/unix-install/opencv_run_all_tests.sh"
718 DESTINATION ${CMAKE_INSTALL_PREFIX} COMPONENT tests)
720 configure_file("${CMAKE_CURRENT_SOURCE_DIR}/cmake/templates/opencv_run_all_tests_windows.cmd.in"
721 "${CMAKE_BINARY_DIR}/win-install/opencv_run_all_tests.cmd" @ONLY)
722 install(PROGRAMS "${CMAKE_BINARY_DIR}/win-install/opencv_run_all_tests.cmd"
723 DESTINATION ${OPENCV_TEST_INSTALL_PATH} COMPONENT tests)
725 configure_file("${CMAKE_CURRENT_SOURCE_DIR}/cmake/templates/opencv_run_all_tests_unix.sh.in"
726 "${CMAKE_BINARY_DIR}/unix-install/opencv_run_all_tests.sh" @ONLY)
727 install(PROGRAMS "${CMAKE_BINARY_DIR}/unix-install/opencv_run_all_tests.sh"
728 DESTINATION ${OPENCV_TEST_INSTALL_PATH} COMPONENT tests)
732 if(NOT OPENCV_README_FILE)
734 set(OPENCV_README_FILE ${CMAKE_CURRENT_SOURCE_DIR}/platforms/android/README.android)
738 if(NOT OPENCV_LICENSE_FILE)
739 set(OPENCV_LICENSE_FILE ${CMAKE_CURRENT_SOURCE_DIR}/LICENSE)
742 # for UNIX it does not make sense as LICENSE and readme will be part of the package automatically
743 if(ANDROID OR NOT UNIX)
744 install(FILES ${OPENCV_LICENSE_FILE}
745 PERMISSIONS OWNER_READ GROUP_READ WORLD_READ
746 DESTINATION ${CMAKE_INSTALL_PREFIX} COMPONENT libs)
747 if(OPENCV_README_FILE)
748 install(FILES ${OPENCV_README_FILE}
749 PERMISSIONS OWNER_READ GROUP_READ WORLD_READ
750 DESTINATION ${CMAKE_INSTALL_PREFIX} COMPONENT libs)
754 # ----------------------------------------------------------------------------
756 # ----------------------------------------------------------------------------
758 status("General configuration for OpenCV ${OPENCV_VERSION} =====================================")
759 if(OPENCV_VCSVERSION)
760 status(" Version control:" ${OPENCV_VCSVERSION})
762 if(OPENCV_EXTRA_MODULES_PATH AND NOT BUILD_INFO_SKIP_EXTRA_MODULES)
763 set(__dump_extra_header OFF)
764 foreach(p ${OPENCV_EXTRA_MODULES_PATH})
766 if(NOT __dump_extra_header)
767 set(__dump_extra_header ON)
769 status(" Extra modules:")
773 set(EXTRA_MODULES_VCSVERSION "unknown")
775 execute_process(COMMAND "${GIT_EXECUTABLE}" describe --tags --always --dirty --match "[0-9].[0-9].[0-9]*"
776 WORKING_DIRECTORY "${p}"
777 OUTPUT_VARIABLE EXTRA_MODULES_VCSVERSION
778 RESULT_VARIABLE GIT_RESULT
780 OUTPUT_STRIP_TRAILING_WHITESPACE
782 if(NOT GIT_RESULT EQUAL 0)
783 set(EXTRA_MODULES_VCSVERSION "unknown")
786 status(" Location (extra):" ${p})
787 status(" Version control (extra):" ${EXTRA_MODULES_VCSVERSION})
790 unset(__dump_extra_header)
793 # ========================== build platform ==========================
796 if(NOT CMAKE_VERSION VERSION_LESS 2.8.11 AND NOT BUILD_INFO_SKIP_TIMESTAMP)
797 string(TIMESTAMP TIMESTAMP "" UTC)
799 status(" Timestamp:" ${TIMESTAMP})
802 status(" Host:" ${CMAKE_HOST_SYSTEM_NAME} ${CMAKE_HOST_SYSTEM_VERSION} ${CMAKE_HOST_SYSTEM_PROCESSOR})
803 if(CMAKE_CROSSCOMPILING)
804 status(" Target:" ${CMAKE_SYSTEM_NAME} ${CMAKE_SYSTEM_VERSION} ${CMAKE_SYSTEM_PROCESSOR})
806 status(" CMake:" ${CMAKE_VERSION})
807 status(" CMake generator:" ${CMAKE_GENERATOR})
808 status(" CMake build tool:" ${CMAKE_BUILD_TOOL})
810 status(" MSVC:" ${MSVC_VERSION})
812 if(CMAKE_GENERATOR MATCHES Xcode)
813 status(" Xcode:" ${XCODE_VERSION})
815 if(NOT CMAKE_GENERATOR MATCHES "Xcode|Visual Studio")
816 status(" Configuration:" ${CMAKE_BUILD_TYPE})
819 # ========================== C/C++ options ==========================
820 if(CMAKE_CXX_COMPILER_VERSION)
821 set(OPENCV_COMPILER_STR "${CMAKE_CXX_COMPILER} ${CMAKE_CXX_COMPILER_ARG1} (ver ${CMAKE_CXX_COMPILER_VERSION})")
822 elseif(CMAKE_COMPILER_IS_CLANGCXX)
823 set(OPENCV_COMPILER_STR "${CMAKE_CXX_COMPILER} ${CMAKE_CXX_COMPILER_ARG1} (ver ${CMAKE_CLANG_REGEX_VERSION})")
824 elseif(CMAKE_COMPILER_IS_GNUCXX)
825 set(OPENCV_COMPILER_STR "${CMAKE_CXX_COMPILER} ${CMAKE_CXX_COMPILER_ARG1} (ver ${CMAKE_GCC_REGEX_VERSION})")
827 set(OPENCV_COMPILER_STR "${CMAKE_CXX_COMPILER} ${CMAKE_CXX_COMPILER_ARG1}")
829 string(STRIP "${OPENCV_COMPILER_STR}" OPENCV_COMPILER_STR)
833 status(" Built as dynamic libs?:" BUILD_SHARED_LIBS THEN YES ELSE NO)
834 status(" C++ Compiler:" ${OPENCV_COMPILER_STR})
835 status(" C++ flags (Release):" ${CMAKE_CXX_FLAGS} ${CMAKE_CXX_FLAGS_RELEASE})
836 status(" C++ flags (Debug):" ${CMAKE_CXX_FLAGS} ${CMAKE_CXX_FLAGS_DEBUG})
837 status(" C Compiler:" ${CMAKE_C_COMPILER} ${CMAKE_C_COMPILER_ARG1})
838 status(" C flags (Release):" ${CMAKE_C_FLAGS} ${CMAKE_C_FLAGS_RELEASE})
839 status(" C flags (Debug):" ${CMAKE_C_FLAGS} ${CMAKE_C_FLAGS_DEBUG})
841 status(" Linker flags (Release):" ${CMAKE_EXE_LINKER_FLAGS} ${CMAKE_EXE_LINKER_FLAGS_RELEASE})
842 status(" Linker flags (Debug):" ${CMAKE_EXE_LINKER_FLAGS} ${CMAKE_EXE_LINKER_FLAGS_DEBUG})
844 status(" Linker flags (Release):" ${CMAKE_SHARED_LINKER_FLAGS} ${CMAKE_SHARED_LINKER_FLAGS_RELEASE})
845 status(" Linker flags (Debug):" ${CMAKE_SHARED_LINKER_FLAGS} ${CMAKE_SHARED_LINKER_FLAGS_DEBUG})
847 status(" Precompiled headers:" PCHSupport_FOUND AND ENABLE_PRECOMPILED_HEADERS THEN YES ELSE NO)
849 # ========================== Dependencies ============================
850 ocv_get_all_libs(deps_modules deps_extra deps_3rdparty)
851 status(" Extra dependencies:" ${deps_extra})
852 status(" 3rdparty dependencies:" ${deps_3rdparty})
854 # ========================== OpenCV modules ==========================
856 status(" OpenCV modules:")
857 string(REPLACE "opencv_" "" OPENCV_MODULES_BUILD_ST "${OPENCV_MODULES_BUILD}")
858 string(REPLACE "opencv_" "" OPENCV_MODULES_DISABLED_USER_ST "${OPENCV_MODULES_DISABLED_USER}")
859 string(REPLACE "opencv_" "" OPENCV_MODULES_DISABLED_FORCE_ST "${OPENCV_MODULES_DISABLED_FORCE}")
860 set(OPENCV_MODULES_DISABLED_AUTO_ST "")
861 foreach(m ${OPENCV_MODULES_DISABLED_AUTO})
863 foreach(d ${OPENCV_MODULE_${m}_DEPS})
864 if(d MATCHES "^opencv_" AND NOT HAVE_${d})
865 list(APPEND __mdeps ${d})
869 list(APPEND OPENCV_MODULES_DISABLED_AUTO_ST "${m}(deps: ${__mdeps})")
871 list(APPEND OPENCV_MODULES_DISABLED_AUTO_ST "${m}")
874 string(REPLACE "opencv_" "" OPENCV_MODULES_DISABLED_AUTO_ST "${OPENCV_MODULES_DISABLED_AUTO_ST}")
876 status(" To be built:" OPENCV_MODULES_BUILD THEN ${OPENCV_MODULES_BUILD_ST} ELSE "-")
877 status(" Disabled:" OPENCV_MODULES_DISABLED_USER THEN ${OPENCV_MODULES_DISABLED_USER_ST} ELSE "-")
878 status(" Disabled by dependency:" OPENCV_MODULES_DISABLED_AUTO THEN ${OPENCV_MODULES_DISABLED_AUTO_ST} ELSE "-")
879 status(" Unavailable:" OPENCV_MODULES_DISABLED_FORCE THEN ${OPENCV_MODULES_DISABLED_FORCE_ST} ELSE "-")
881 # ========================== Android details ==========================
885 status(" Android ABI:" ${ANDROID_ABI})
886 status(" STL type:" ${ANDROID_STL})
887 status(" Native API level:" android-${ANDROID_NATIVE_API_LEVEL})
888 android_get_compatible_target(android_sdk_target_status ${ANDROID_NATIVE_API_LEVEL} ${ANDROID_SDK_TARGET} 11)
889 status(" SDK target:" "${android_sdk_target_status}")
890 if(BUILD_WITH_ANDROID_NDK)
891 status(" Android NDK:" "${ANDROID_NDK} (toolchain: ${ANDROID_TOOLCHAIN_NAME})")
892 elseif(BUILD_WITH_STANDALONE_TOOLCHAIN)
893 status(" Android toolchain:" "${ANDROID_STANDALONE_TOOLCHAIN}")
895 status(" android tool:" ANDROID_EXECUTABLE THEN "${ANDROID_EXECUTABLE} (${ANDROID_TOOLS_Pkg_Desc})" ELSE NO)
896 status(" Google Play manager:" BUILD_ANDROID_SERVICE THEN YES ELSE NO)
897 status(" Android examples:" BUILD_ANDROID_EXAMPLES AND CAN_BUILD_ANDROID_PROJECTS THEN YES ELSE NO)
900 # ================== Windows RT features ==================
903 status(" Windows RT support:" WINRT THEN YES ELSE NO)
905 status(" Building for Microsoft platform: " ${CMAKE_SYSTEM_NAME})
906 status(" Building for architectures: " ${CMAKE_VS_EFFECTIVE_PLATFORMS})
907 status(" Building for version: " ${CMAKE_SYSTEM_VERSION})
908 if (DEFINED ENABLE_WINRT_MODE_NATIVE)
909 status(" Building for C++ without CX extensions")
914 # ========================== GUI ==========================
919 status(" QT 5.x:" HAVE_QT THEN "YES (ver ${Qt5Core_VERSION_STRING})" ELSE NO)
920 status(" QT OpenGL support:" HAVE_QT_OPENGL THEN "YES (${Qt5OpenGL_LIBRARIES} ${Qt5OpenGL_VERSION_STRING})" ELSE NO)
922 status(" QT 4.x:" HAVE_QT THEN "YES (ver ${QT_VERSION_MAJOR}.${QT_VERSION_MINOR}.${QT_VERSION_PATCH} ${QT_EDITION})" ELSE NO)
923 status(" QT OpenGL support:" HAVE_QT_OPENGL THEN "YES (${QT_QTOPENGL_LIBRARY})" ELSE NO)
928 if(DEFINED WITH_WIN32UI)
929 status(" Win32 UI:" HAVE_WIN32UI THEN YES ELSE NO)
933 status(" Carbon:" YES)
935 status(" Cocoa:" YES)
939 status(" GTK+ 3.x:" HAVE_GTK THEN "YES (ver ${ALIASOF_gtk+-3.0_VERSION})" ELSE NO)
941 status(" GTK+ 2.x:" HAVE_GTK THEN "YES (ver ${ALIASOF_gtk+-2.0_VERSION})" ELSE NO)
945 status(" GThread :" HAVE_GTHREAD THEN "YES (ver ${ALIASOF_gthread-2.0_VERSION})" ELSE NO)
946 status(" GtkGlExt:" HAVE_GTKGLEXT THEN "YES (ver ${ALIASOF_gtkglext-1.0_VERSION})" ELSE NO)
951 status(" OpenGL support:" HAVE_OPENGL THEN "YES (${OPENGL_LIBRARIES})" ELSE NO)
952 status(" VTK support:" HAVE_VTK THEN "YES (ver ${VTK_VERSION})" ELSE NO)
954 # ========================== MEDIA IO ==========================
956 status(" Media I/O: ")
957 status(" ZLib:" BUILD_ZLIB THEN "build (ver ${ZLIB_VERSION_STRING})" ELSE "${ZLIB_LIBRARIES} (ver ${ZLIB_VERSION_STRING})")
960 status(" JPEG:" JPEG_FOUND THEN "${JPEG_LIBRARY} (ver ${JPEG_LIB_VERSION})" ELSE "build (ver ${JPEG_LIB_VERSION})")
962 status(" JPEG:" "NO")
966 status(" WEBP:" WEBP_FOUND THEN "${WEBP_LIBRARY} (ver ${WEBP_VERSION})" ELSE "build (ver ${WEBP_VERSION})")
968 status(" WEBP:" "NO")
972 status(" PNG:" PNG_FOUND THEN "${PNG_LIBRARY} (ver ${PNG_VERSION})" ELSE "build (ver ${PNG_VERSION})")
977 if(TIFF_VERSION_STRING AND TIFF_FOUND)
978 status(" TIFF:" "${TIFF_LIBRARY} (ver ${TIFF_VERSION} - ${TIFF_VERSION_STRING})")
980 status(" TIFF:" TIFF_FOUND THEN "${TIFF_LIBRARY} (ver ${TIFF_VERSION})" ELSE "build (ver ${TIFF_VERSION} - ${TIFF_VERSION_STRING})")
983 status(" TIFF:" "NO")
986 status(" JPEG 2000:" JASPER_FOUND THEN "${JASPER_LIBRARY} (ver ${JASPER_VERSION_STRING})" ELSE "build (ver ${JASPER_VERSION_STRING})")
988 status(" JPEG 2000:" "NO")
991 status(" OpenEXR:" OPENEXR_FOUND THEN "${OPENEXR_LIBRARIES} (ver ${OPENEXR_VERSION})" ELSE "build (ver ${OPENEXR_VERSION})")
993 status(" OpenEXR:" "NO")
997 status(" GDAL:" GDAL_FOUND THEN "${GDAL_LIBRARY}" ELSE "NO")
999 status(" GDAL:" "NO")
1002 # ========================== VIDEO IO ==========================
1004 status(" Video I/O:")
1006 if (DEFINED WITH_VFW)
1007 status(" Video for Windows:" HAVE_VFW THEN YES ELSE NO)
1008 endif(DEFINED WITH_VFW)
1010 if(DEFINED WITH_1394)
1011 status(" DC1394 1.x:" HAVE_DC1394 THEN "YES (ver ${ALIASOF_libdc1394_VERSION})" ELSE NO)
1012 status(" DC1394 2.x:" HAVE_DC1394_2 THEN "YES (ver ${ALIASOF_libdc1394-2_VERSION})" ELSE NO)
1013 endif(DEFINED WITH_1394)
1015 if(DEFINED WITH_AVFOUNDATION)
1016 status(" AVFoundation:" WITH_AVFOUNDATION THEN YES ELSE NO)
1017 endif(DEFINED WITH_AVFOUNDATION)
1019 if(DEFINED WITH_FFMPEG)
1021 status(" FFMPEG:" WITH_FFMPEG THEN "YES (prebuilt binaries)" ELSE NO)
1023 status(" FFMPEG:" HAVE_FFMPEG THEN YES ELSE NO)
1025 status(" codec:" HAVE_FFMPEG_CODEC THEN "YES (ver ${ALIASOF_libavcodec_VERSION})" ELSE NO)
1026 status(" format:" HAVE_FFMPEG_FORMAT THEN "YES (ver ${ALIASOF_libavformat_VERSION})" ELSE NO)
1027 status(" util:" HAVE_FFMPEG_UTIL THEN "YES (ver ${ALIASOF_libavutil_VERSION})" ELSE NO)
1028 status(" swscale:" HAVE_FFMPEG_SWSCALE THEN "YES (ver ${ALIASOF_libswscale_VERSION})" ELSE NO)
1029 status(" resample:" HAVE_FFMPEG_RESAMPLE THEN "YES (ver ${ALIASOF_libavresample_VERSION})" ELSE NO)
1030 status(" gentoo-style:" HAVE_GENTOO_FFMPEG THEN YES ELSE NO)
1031 endif(DEFINED WITH_FFMPEG)
1033 if(DEFINED WITH_GSTREAMER)
1034 status(" GStreamer:" HAVE_GSTREAMER THEN "" ELSE NO)
1036 status(" base:" "YES (ver ${GSTREAMER_BASE_VERSION})")
1037 status(" video:" "YES (ver ${GSTREAMER_VIDEO_VERSION})")
1038 status(" app:" "YES (ver ${GSTREAMER_APP_VERSION})")
1039 status(" riff:" "YES (ver ${GSTREAMER_RIFF_VERSION})")
1040 status(" pbutils:" "YES (ver ${GSTREAMER_PBUTILS_VERSION})")
1041 endif(HAVE_GSTREAMER)
1042 endif(DEFINED WITH_GSTREAMER)
1044 if(DEFINED WITH_OPENNI)
1045 status(" OpenNI:" HAVE_OPENNI THEN "YES (ver ${OPENNI_VERSION_STRING}, build ${OPENNI_VERSION_BUILD})"
1047 status(" OpenNI PrimeSensor Modules:" HAVE_OPENNI_PRIME_SENSOR_MODULE
1048 THEN "YES (${OPENNI_PRIME_SENSOR_MODULE})" ELSE NO)
1049 endif(DEFINED WITH_OPENNI)
1051 if(DEFINED WITH_OPENNI2)
1052 status(" OpenNI2:" HAVE_OPENNI2 THEN "YES (ver ${OPENNI2_VERSION_STRING}, build ${OPENNI2_VERSION_BUILD})"
1054 endif(DEFINED WITH_OPENNI2)
1056 if(DEFINED WITH_PVAPI)
1057 status(" PvAPI:" HAVE_PVAPI THEN YES ELSE NO)
1058 endif(DEFINED WITH_PVAPI)
1060 if(DEFINED WITH_GIGEAPI)
1061 status(" GigEVisionSDK:" HAVE_GIGE_API THEN YES ELSE NO)
1062 endif(DEFINED WITH_GIGEAPI)
1064 if(DEFINED WITH_QUICKTIME)
1065 status(" QuickTime:" HAVE_QUICKTIME THEN YES ELSE NO)
1066 status(" QTKit:" HAVE_QTKIT THEN YES ELSE NO)
1067 endif(DEFINED WITH_QUICKTIME)
1069 if(DEFINED WITH_UNICAP)
1070 status(" UniCap:" HAVE_UNICAP THEN "YES (ver ${ALIASOF_libunicap_VERSION})" ELSE NO)
1071 status(" UniCap ucil:" HAVE_UNICAP_UCIL THEN "YES (ver ${ALIASOF_libucil_VERSION})" ELSE NO)
1072 endif(DEFINED WITH_UNICAP)
1074 if(DEFINED WITH_V4L)
1076 set(HAVE_CAMV4L_STR "YES")
1078 set(HAVE_CAMV4L_STR "NO")
1081 set(HAVE_CAMV4L2_STR "YES")
1082 elseif(HAVE_VIDEOIO)
1083 set(HAVE_CAMV4L2_STR "YES(videoio)")
1085 set(HAVE_CAMV4L2_STR "NO")
1087 status(" V4L/V4L2:" HAVE_LIBV4L
1088 THEN "Using libv4l1 (ver ${ALIASOF_libv4l1_VERSION}) / libv4l2 (ver ${ALIASOF_libv4l2_VERSION})"
1089 ELSE "${HAVE_CAMV4L_STR}/${HAVE_CAMV4L2_STR}")
1090 endif(DEFINED WITH_V4L)
1092 if(DEFINED WITH_DSHOW)
1093 status(" DirectShow:" HAVE_DSHOW THEN YES ELSE NO)
1094 endif(DEFINED WITH_DSHOW)
1096 if(DEFINED WITH_MSMF)
1097 status(" Media Foundation:" HAVE_MSMF THEN YES ELSE NO)
1098 endif(DEFINED WITH_MSMF)
1100 if(DEFINED WITH_XIMEA)
1101 status(" XIMEA:" HAVE_XIMEA THEN YES ELSE NO)
1102 endif(DEFINED WITH_XIMEA)
1104 if(DEFINED WITH_XINE)
1105 status(" Xine:" HAVE_XINE THEN "YES (ver ${ALIASOF_libxine_VERSION})" ELSE NO)
1106 endif(DEFINED WITH_XINE)
1108 if(DEFINED WITH_INTELPERC)
1109 status(" Intel PerC:" HAVE_INTELPERC THEN "YES" ELSE NO)
1110 endif(DEFINED WITH_INTELPERC)
1112 if(DEFINED WITH_GPHOTO2)
1113 status(" gPhoto2:" HAVE_GPHOTO2 THEN "YES" ELSE NO)
1114 endif(DEFINED WITH_GPHOTO2)
1117 # Order is similar to CV_PARALLEL_FRAMEWORK in core/src/parallel.cpp
1118 ocv_clear_vars(CV_PARALLEL_FRAMEWORK)
1120 set(CV_PARALLEL_FRAMEWORK "TBB (ver ${TBB_VERSION_MAJOR}.${TBB_VERSION_MINOR} interface ${TBB_INTERFACE_VERSION})")
1121 elseif(HAVE_CSTRIPES)
1122 set(CV_PARALLEL_FRAMEWORK "C=")
1124 set(CV_PARALLEL_FRAMEWORK "OpenMP")
1126 set(CV_PARALLEL_FRAMEWORK "GCD")
1127 elseif(WINRT OR HAVE_CONCURRENCY)
1128 set(CV_PARALLEL_FRAMEWORK "Concurrency")
1129 elseif(HAVE_PTHREADS_PF)
1130 set(CV_PARALLEL_FRAMEWORK "pthreads")
1132 set(CV_PARALLEL_FRAMEWORK "none")
1135 status(" Parallel framework:" TRUE THEN "${CV_PARALLEL_FRAMEWORK}" ELSE NO)
1138 # ========================== Other third-party libraries ==========================
1140 status(" Other third-party libraries:")
1142 if(WITH_IPP AND HAVE_IPP)
1143 status(" Use IPP:" "${IPP_VERSION_STR} [${IPP_VERSION_MAJOR}.${IPP_VERSION_MINOR}.${IPP_VERSION_BUILD}]")
1144 status(" at:" "${IPP_ROOT_DIR}")
1145 if(NOT HAVE_IPP_ICV_ONLY)
1146 status(" linked:" BUILD_WITH_DYNAMIC_IPP THEN "dynamic" ELSE "static")
1149 status(" Use IPP:" WITH_IPP AND NOT HAVE_IPP THEN "IPP not found or implicitly disabled" ELSE NO)
1152 if(DEFINED WITH_IPP_A)
1153 status(" Use IPP Async:" HAVE_IPP_A THEN "YES" ELSE NO)
1154 endif(DEFINED WITH_IPP_A)
1157 status(" Use VA:" HAVE_VA THEN "YES" ELSE NO)
1158 endif(DEFINED WITH_VA)
1160 if(DEFINED WITH_VA_INTEL)
1161 status(" Use Intel VA-API/OpenCL:" HAVE_VA_INTEL THEN "YES (MSDK: ${VA_INTEL_MSDK_ROOT} OpenCL: ${VA_INTEL_IOCL_ROOT})" ELSE NO)
1162 endif(DEFINED WITH_VA_INTEL)
1164 status(" Use Eigen:" HAVE_EIGEN THEN "YES (ver ${EIGEN_WORLD_VERSION}.${EIGEN_MAJOR_VERSION}.${EIGEN_MINOR_VERSION})" ELSE NO)
1165 status(" Use Cuda:" HAVE_CUDA THEN "YES (ver ${CUDA_VERSION_STRING})" ELSE NO)
1166 status(" Use OpenCL:" HAVE_OPENCL THEN YES ELSE NO)
1167 status(" Use custom HAL:" OPENCV_HAL_HEADERS AND OPENCV_HAL_LIBS THEN "YES (${OPENCV_HAL_HEADERS}; ${OPENCV_HAL_LIBS})" ELSE "NO")
1171 status(" NVIDIA CUDA")
1173 status(" Use CUFFT:" HAVE_CUFFT THEN YES ELSE NO)
1174 status(" Use CUBLAS:" HAVE_CUBLAS THEN YES ELSE NO)
1175 status(" USE NVCUVID:" HAVE_NVCUVID THEN YES ELSE NO)
1176 status(" NVIDIA GPU arch:" ${OPENCV_CUDA_ARCH_BIN})
1177 status(" NVIDIA PTX archs:" ${OPENCV_CUDA_ARCH_PTX})
1178 status(" Use fast math:" CUDA_FAST_MATH THEN YES ELSE NO)
1183 if(HAVE_OPENCL_STATIC)
1184 set(__opencl_type "<Link with OpenCL library>")
1186 set(__opencl_type "<Dynamic loading of OpenCL library>")
1188 status(" OpenCL:" ${__opencl_type})
1189 if(OPENCL_INCLUDE_DIRS)
1190 status(" Include path:" ${OPENCL_INCLUDE_DIRS})
1192 if(OPENCL_LIBRARIES)
1194 foreach(l ${OPENCL_LIBRARIES})
1196 get_target_property(p ${l} LOCATION)
1197 if(p MATCHES NOTFOUND)
1198 list(APPEND __libs "${l}")
1200 list(APPEND __libs "${p}")
1203 list(APPEND __libs "${l}")
1206 status(" Link libraries:" ${__libs})
1208 status(" Use AMDFFT:" HAVE_CLAMDFFT THEN YES ELSE NO)
1209 status(" Use AMDBLAS:" HAVE_CLAMDBLAS THEN YES ELSE NO)
1212 # ========================== python ==========================
1214 status(" Python 2:")
1215 status(" Interpreter:" PYTHON2INTERP_FOUND THEN "${PYTHON2_EXECUTABLE} (ver ${PYTHON2_VERSION_STRING})" ELSE NO)
1216 if(BUILD_opencv_python2)
1217 if(PYTHON2LIBS_VERSION_STRING)
1218 status(" Libraries:" HAVE_opencv_python2 THEN "${PYTHON2_LIBRARIES} (ver ${PYTHON2LIBS_VERSION_STRING})" ELSE NO)
1220 status(" Libraries:" HAVE_opencv_python2 THEN "${PYTHON2_LIBRARIES}" ELSE NO)
1222 status(" numpy:" PYTHON2_NUMPY_INCLUDE_DIRS THEN "${PYTHON2_NUMPY_INCLUDE_DIRS} (ver ${PYTHON2_NUMPY_VERSION})" ELSE "NO (Python wrappers can not be generated)")
1223 status(" packages path:" PYTHON2_EXECUTABLE THEN "${PYTHON2_PACKAGES_PATH}" ELSE "-")
1227 status(" Python 3:")
1228 status(" Interpreter:" PYTHON3INTERP_FOUND THEN "${PYTHON3_EXECUTABLE} (ver ${PYTHON3_VERSION_STRING})" ELSE NO)
1229 if(BUILD_opencv_python3)
1230 if(PYTHON3LIBS_VERSION_STRING)
1231 status(" Libraries:" HAVE_opencv_python3 THEN "${PYTHON3_LIBRARIES} (ver ${PYTHON3LIBS_VERSION_STRING})" ELSE NO)
1233 status(" Libraries:" HAVE_opencv_python3 THEN "${PYTHON3_LIBRARIES}" ELSE NO)
1235 status(" numpy:" PYTHON3_NUMPY_INCLUDE_DIRS THEN "${PYTHON3_NUMPY_INCLUDE_DIRS} (ver ${PYTHON3_NUMPY_VERSION})" ELSE "NO (Python3 wrappers can not be generated)")
1236 status(" packages path:" PYTHON3_EXECUTABLE THEN "${PYTHON3_PACKAGES_PATH}" ELSE "-")
1240 status(" Python (for build):" PYTHON_DEFAULT_AVAILABLE THEN "${PYTHON_DEFAULT_EXECUTABLE}" ELSE NO)
1242 # ========================== java ==========================
1245 status(" ant:" ANT_EXECUTABLE THEN "${ANT_EXECUTABLE} (ver ${ANT_VERSION})" ELSE NO)
1247 status(" JNI:" JNI_INCLUDE_DIRS THEN "${JNI_INCLUDE_DIRS}" ELSE NO)
1249 status(" Java wrappers:" HAVE_opencv_java THEN YES ELSE NO)
1250 status(" Java tests:" BUILD_TESTS AND opencv_test_java_BINARY_DIR THEN YES ELSE NO)
1252 # ========================= matlab =========================
1256 status(" mex:" MATLAB_MEX_SCRIPT THEN "${MATLAB_MEX_SCRIPT}" ELSE NO)
1257 status(" Compiler/generator:" MEX_WORKS THEN "Working" ELSE "Not working (bindings will not be generated)")
1259 status(" Matlab:" WITH_MATLAB AND NOT MATLAB_FOUND THEN "Matlab not found or implicitly disabled" ELSE NO)
1262 # ========================== documentation ==========================
1265 status(" Documentation:")
1266 status(" Doxygen:" DOXYGEN_FOUND THEN "${DOXYGEN_EXECUTABLE} (ver ${DOXYGEN_VERSION})" ELSE NO)
1267 status(" PlantUML:" PLANTUML_JAR THEN "${PLANTUML_JAR}" ELSE NO)
1270 # ========================== samples and tests ==========================
1272 status(" Tests and samples:")
1273 status(" Tests:" BUILD_TESTS AND HAVE_opencv_ts THEN YES ELSE NO)
1274 status(" Performance tests:" BUILD_PERF_TESTS AND HAVE_opencv_ts THEN YES ELSE NO)
1275 status(" C/C++ Examples:" BUILD_EXAMPLES THEN YES ELSE NO)
1277 # ========================== auxiliary ==========================
1279 status(" Install path:" "${CMAKE_INSTALL_PREFIX}")
1281 status(" cvconfig.h is in:" "${OPENCV_CONFIG_FILE_INCLUDE_DIR}")
1282 status("-----------------------------------------------------------------")
1285 ocv_finalize_status()
1287 # ----------------------------------------------------------------------------
1288 # Warn in the case of in-source build
1289 # ----------------------------------------------------------------------------
1290 if("${CMAKE_CURRENT_SOURCE_DIR}" STREQUAL "${CMAKE_CURRENT_BINARY_DIR}")
1291 message(WARNING "The source directory is the same as binary directory. \"make clean\" may damage the source tree")
1294 # ----------------------------------------------------------------------------
1296 # ----------------------------------------------------------------------------
1298 include(cmake/OpenCVPackaging.cmake)
1300 # This should be the last command
1301 ocv_cmake_dump_vars("" TOFILE "CMakeVars.txt")
1302 ocv_cmake_eval(DEBUG_POST ONCE)