OpenCV4.9.0配置选项参考_windows 11 opencv 4.9.0

返回:OpenCV系列文章目录（持续更新中......）

上一篇 《OpenCV4.9.0开源计算机视觉库安装概述博客》

下一篇：《OpenCV 环境变量参考》

引言：

OpenCV是一款开源的计算机视觉库，具有跨平台、高速、易用等特点，并广泛应用于各种领域，如医学、安防、自动驾驶、AR/VR等。为了让OpenCV更好地满足用户的需求，在安装时需要选择一些配置选项，以便启用相应的功能和优化。本文将提供给读者一些OpenCV4.9.0的配置选项参考，可以根据自己的需求进行二次编译和配置，以达到更好的性能和体验。同时，本文还会介绍一些常用的OpenCV功能模块及其对应的配置选项，以方便读者更好地进行选项配置。

创作不易，要是对您有用请加个关注或点个赞，非常感谢了！前面500粉丝我会互关。

正文：

注意：

我们假设您已经阅读了 OpenCV 安装概述教程或具有 CMake 的经验。如果没有可以参考文章《OpenCV4.9.0开源计算机视觉库安装概述-CSDN博客》

可以通过几种不同的方式设置配置选项：

• 命令行：cmake -Doption=value ...
• 初始缓存文件：cmake -C my_options.txt ...
• 通过GUI进行交互

在本参考中，我们将使用常规命令行。

大多数选项都可以在 OpenCV 的根 cmake 脚本中找到文件：opencv/CMakeLists.txt 某些选项可以在特定模块中定义。

可以使用CMake工具打印所有可用选项：

最常用的选项：WITH_, ENABLE_, BUILD_, OPENCV_.

默认值因平台和其他选项值而异。

常规选项

使用额外的模块进行构建

OPENCV_EXTRA_MODULES_PATHoption 包含一个以分号分隔的目录列表，其中包含将添加到构建中的额外模块。模块目录必须具有兼容的布局和CMakeLists.txt，简要说明可以在参考编码风格指南去寻找。

参考以下构建方式：

# 使用 opencv_contrib 中的所有模块进行构建
cmake -DOPENCV_EXTRA_MODULES_PATH=../opencv_contrib/modules ../opencv
 
# 使用opencv_contrib模块之一构建
cmake -DOPENCV_EXTRA_MODULES_PATH=../opencv_contrib/modules/bgsegm ../opencv
 
# 使用两个自定义模块构建（在 bash 中必须转义分号）
cmake -DOPENCV_EXTRA_MODULES_PATH=../my_mod1\;../my_mod2 ../opencv

注意：仅支持 0 级和 1 级深度模块位置，以下命令是错误的：

调试生成

CMAKE_BUILD_TYPE选项可用于启用调试构建;生成的二进制文件将包含调试符号，并且大多数编译器优化将被关闭。若要在“发布版本”中启用调试符号，需要打开选项：BUILD_WITH_DEBUG_INFO

在某些平台（例如 Linux）上，必须在配置阶段设置构建类型：

在其他平台上，可以在同一个构建目录（例如 Visual Studio、XCode）中生成不同类型的构建：

如果您使用 GNU libstdc++（GCC 的默认值），您可以打开该选项，那么 C++ 库将在调试模式下使用，例如，在向量元素访问期间将绑定检查索引：ENABLE_GNU_STL_DEBUG

可以使用选项禁用多种优化：CV_DISABLE_OPTIMIZATION

• 一些第三方库（例如 IPP、Lapack、Eigen）
• 显式矢量化实现（通用内部函数、原始内部函数等）
• 调度优化
• 显式循环展开

有关详细工具使用或配置可以参阅相关文档：

https://cmake.org/cmake/help/latest/variable/CMAKE_BUILD_TYPE.html

https://gcc.gnu.org/onlinedocs/libstdc++/manual/using_macros.html

https://github.com/opencv/opencv/wiki/CPU-optimizations-build-options

静态构建

BUILD_SHARED_LIBS是OpenCV的一个配置选项，用于控制编译生成的OpenCV库是静态库还是共享库。当这个选项被启用时，编译器将生成共享库，而当这个选项被禁用时，编译器将生成静态库。默认情况下，BUILD_SHARED_LIBS是启用的，生成共享库。

可以设置为关闭状态变成静态库例：

另请参阅

https://en.wikipedia.org/wiki/Static_library

ENABLE_PIC设置CMAKE_POSITION_INDEPENDENT_CODE选项。它启用或禁用“与位置无关的代码”的生成。在构建动态库或要链接到动态库的静态库时，必须启用此选项。默认值为 。ON

另请参阅

https://en.wikipedia.org/wiki/Position-independent_code

生成 pkg-config 信息

OPENCV_GENERATE_PKGCONFIGoption 启用文件生成以及标准 CMake 包。此文件对于不使用 CMake 进行生成的项目非常有用。

例：

注意：

 由于配置过程的复杂性，生成的文件可能包含不完整的第三方依赖项列表，并且可能在某些配置中不起作用，尤其是对于静态构建。此功能自 4.x 版本起不再正式支持，默认情况下处于禁用状态。

构建测试、示例和应用程序

有两种测试：准确性 （opencv_test_*） 和性能 （opencv_perf_*）。默认情况下，测试和应用程序处于启用状态。默认情况下不生成示例，应显式启用。

对应的 cmake 选项：

cmake \
 
-DBUILD_TESTS=ON \
 
-DBUILD_PERF_TESTS=ON \
 
-DBUILD_EXAMPLES=ON \
 
-DBUILD_opencv_apps=ON \
 
../opencv

构建有限的模块集

每个模块都是目录的一个子目录。可以禁用一个模块：modules

cmake -DBUILD_opencv_calib3d=OFF ../opencv

cmake -DBUILD_LIST=calib3d,videoio,ts ../opencv

-- OpenCV modules:
 
-- To be built: calib3d core features2d flann highgui imgcodecs imgproc ts videoio

下载的依赖项

配置脚本可以尝试从互联网上下载其他库和文件，如果做不到，相应的功能将被关闭。在某些情况下，可能会发生配置错误。默认情况下，所有文件首先下载到<source>/.cache目录，然后解压缩或复制到构建目录。可以通过设置环境变量或配置选项来更改下载缓存位置：

export OPENCV_DOWNLOAD_PATH=/tmp/opencv-cache
cmake ../opencv
# or
cmake -DOPENCV_DOWNLOAD_PATH=/tmp/opencv-cache ../opencv

如果通过代理访问，则应在运行 cmake 之前设置相应的环境变量：

export http_proxy=<proxy-host>:<port>
export https_proxy=<proxy-host>:<port>

下载过程的完整日志可以在构建目录 - 中找到CMakeDownloadLog.txt。此外，对于每次失败的下载，都会向构建目录中的辅助脚本添加一个命令，例如 .download_with_wget.sh用户可以按原样运行这些脚本，也可以根据需要进行修改。

CPU 优化级别

在x86_64机器上，默认情况下，该库将针对 SSE3 指令集级别进行编译。可以通过配置选项更改此级别：

cmake -DCPU_BASELINE=AVX2 ../opencv

其他平台有自己的指令集级别：ARM的NEON或VFPV3,PowerPC的VSX 

一些函数支持调度机制，允许为多个指令集编译它们，并在运行时选择一个指令集。在配置过程中可以更改启用的指令集列表：

cmake -DCPU_DISPATCH=AVX,AVX2 ../opencv

cmake -DCPU_DISPATCH= ../opencv

# disable universal intrinsics
cmake -DCV_ENABLE_INTRINSICS=OFF ../opencv
# disable all possible built-in optimizations
cmake -DCV_DISABLE_OPTIMIZATION=ON ../opencv

注意

有关 CPU 优化选项的更多详细信息，请参见 wiki：https://github.com/opencv/opencv/wiki/CPU-optimizations-build-options

轮廓分析、覆盖率、消毒、硬化、尺寸优化

以下选项可用于生成具有检测或改进安全性的特殊版本。默认情况下，所有选项都处于禁用状态。

另请参阅

GCC 检测

构建强化

程序间优化

链路时间优化

ThinLTO

启用 IPP 优化

以下选项可用于为每个函数启用 IPP 优化，但会增加 opencv 库的大小。默认情况下，所有选项都处于禁用状态。

功能特性和依赖关系

有许多可选的依赖项和功能可以打开或关闭。 CMake 有特殊选项，可以打印所有可用的配置参数：

cmake -LH ../opencv

有三种选项用于控制库的依赖项，它们具有不同的前缀：

• 选项BUILD_的选项表示启用或禁用依赖项开头的选项WITH_
• 选项BUILD_的选项表示启用或禁用构建和使用与 OpenCV 捆绑在一起的第三方库开头的
• HAVE_开头的选项表示已启用依赖关系，如果无法使用自动检测，则可用于手动启用依赖关系。

启用选项时：WITH_

• 如果启用了选项，将构建并启用第三方库 =>设置为ON
• 如果BUILD选项被禁用，在检测到第三方库并成功加载后，对应的功能会被启用，HAVE选项会被设置为ON。

异构计算

CUDA 支持

WITH_CUDA（默认值：OFF)

许多算法都是使用 CUDA 加速实现的，这些函数位于单独的模块中。作为先决条件，必须从 NVIDIA 官方网站安装 CUDA 工具包。对于早于 3.9 的 cmake 版本，OpenCV 使用自己的cmake/FindCUDA.cmake脚本，对于较新的版本 - 与 CMake 打包的脚本。可以使用其他选项来控制构建过程，例如CUDA_GENERATION 或CUDA_ARCH_BIN。这些参数尚未记录，详情请咨询脚本。

注意

自 OpenCV 4.0 版本以来，所有 CUDA 加速算法实现都已移至 opencv_contrib 存储库。要同时构建 opencv 和opencv_contrib，请选中 Build with extra modules。

一些教程可以在相应的部分找到： GPU 加速计算机视觉（cuda 模块）

另请参阅

CUDA 加速的计算机视觉

https://en.wikipedia.org/wiki/CUDA

TODO： 其他选项：WITH_CUFFT, WITH_CUBLAS, WITH_NVCUVID？

OpenCL 支持

WITH_OPENCL（默认值：ON)

多种 OpenCL 加速算法可通过所谓的“透明 API （T-API）”获得。此集成在用户级别使用与常规 CPU 实现相同的功能。如果输入和输出图像参数作为不透明的 cv：：UMat 对象传递，则会切换到 OpenCL 执行分支。更多信息可以在简介和 OpenCL 支持中找到

在生成时，此功能没有任何先决条件。在运行时，需要一个有效的 OpenCL 运行clinfo时来检查它的运行和/或opencv_version --opencl命令。可以使用环境变量修改 OpenCL 集成的某些参数，例如OPENCV_OPENCL_DEVICE..但是，目前还没有关于此功能的完整文档，因此请查看文件中的源代码modules/core/src/ocl.cpp以获取详细信息。

另请参阅

https://en.wikipedia.org/wiki/OpenCL

TODO：其他选项：WITH_OPENCL_SVM, WITH_OPENCLAMDFFT, WITH_OPENCLAMDBLAS, WITH_OPENCL_D3D11_NV, WITH_VA_INTEL

图像读写（imgcodecs 模块）

内置格式

OpenCV 可以在没有任何第三方库帮助的情况下读取以下格式：

• BMP格式
• 图像编解码模块 (WITH_IMGCODEC_HDR)
• 光栅 (WITH_IMGCODEC_SUNRASTER)
• PPM、PGM、PBM、PFM （WITH_IMGCODEC_PXM，WITH_IMGCODEC_PFM)

支持 PNG、JPEG、TIFF、WEBP

读取这些格式的图像所需的所有库都包含在 OpenCV 中，如果在配置阶段找不到，将自动构建。相应的选项BUILD_*将强制构建和使用自己的库，它们在某些平台上默认启用，例如 Windows

注意

OpenJPEG 的优先级高于已弃用的 JasPer。如要使用 JasPer，必须禁用 OpenJPEG

GDAL 集成

WITH_GDAL（默认值：OFF)

GDAL 是一个更高级别的库，支持读取多种文件格式，包括 PNG、JPEG 和 TIFF。打开文件时，它将具有更高的优先级，并且可以覆盖其他后端。该库将使用 cmake 包机制进行搜索，确保安装正确或手动设置GDAL_DIR环境或 cmake 变量。

GDCM 集成

WITH_GDCM（默认值：OFF)

通过 GDCM 库启用 DICOM 医学图像格式支持。该库将使用 cmake 包机制进行搜索，确保安装正确或手动设置GDCM_DIR环境或 cmake 变量。

视频读写（videoio模块）

TODO：videoio的工作原理，注册表，优先级

视频4Linux

WITH_V4L（Linux;默认值：ON )

使用 Video4Linux API 从相机捕获图像。必须安装 Linux 内核头文件。

FFmpeg 

WITH_FFMPEG（默认值：ON)

与 FFmpeg 库集成，用于解码和编码视频文件和网络流。该库可以读取和写入许多流行的视频格式。它由几个组件组成，必须安装以下组件作为构建的先决条件：

• avcodec
• avformat
• avutil
• swscale
• avresample (optional)

例外情况是 Windows 平台，其中包含 FFmpeg 的预构建插件库将在配置阶段下载，并复制到包含所有生成库的文件夹中。bin

注意

可以使用 Libav 库代替 FFmpeg，但这种组合不受建议。

GStreamer

WITH_GSTREAMER（默认值：ON)

启用与 GStreamer 库的集成，用于解码和编码视频文件，从摄像机和网络流中捕获帧。可以安装许多插件来扩展支持的格式列表。OpenCV 允许运行作为字符串传递给 cv：：VideoCapture 和 cv：：VideoWriter 对象的任意 GStreamer 管道。

各种 GStreamer 插件在不同平台上提供硬件加速视频处理。

Microsoft Media Foundation（微软多媒体接口）

WITH_MSMF（Windows;默认值：ON)

启用使用 Windows 内置 Media Foundation 框架的 MSMF 后端。可用于从相机中捕获帧，对视频文件进行解码和编码。此后端具有硬件加速处理支持（选项，默认为 ON）。WITH_MSMF_DXVA

注意

较旧版本的 Windows（10 之前版本）可能具有不兼容的 Media Foundation 版本，且已知在从 OpenCV 使用时会出现问题。

直接显示

WITH_DSHOW（Windows;默认值：ON)

此后端使用较旧的DirectShow框架。它只能用于从相机捕获帧。它现在已被弃用，取而代之的是 MSMF 后端，尽管两者可以在同一版本中启用。

苹果框架支持

WITH_AVFOUNDATION（Apple;默认值：ON)

AVFoundation 框架是 Apple 平台的一部分，可用于从相机中捕获帧、编码和解码视频文件。

其他后端

有多个不太流行的框架可用于读取和编写视频。每个都需要安装相应的库或 SDK。

VideoIO插件

从 4.1.0 版本开始，一些 videoio 后端可以构建为插件，从而打破了对第三方库的严格依赖，并使它们在运行时成为可选的。以下选项可用于控制此机制：

查看 OpenCV 安装概述，了解独立插件构建说明。

并行处理

一些 OpenCV 算法可以使用多线程来加速处理。OpenCV 可以使用线程后端之一构建。

注意

OpenCV 可以从 GitHub 下载并构建 TBB 库，此功能可以通过该选项BUILD_TBB启用。

线程插件

从版本 OpenCV4.5.2 开始， 支持动态加载的线程后端。目前只支持单独的编译过程：首先你必须使用一些默认的并行后端（例如pthreads）构建OpenCV，然后构建每个插件并将生成的二进制文件复制到lib或bin文件夹。

查看 OpenCV 安装概述，了解独立插件构建说明。

GUI 后端（highgui 模块）

OpenCV 依赖于各种 GUI 库进行窗口绘制。

注意

使用 Qt 支持编译的 OpenCV 启用了高级 highgui 接口，有关详细信息，请参阅 Qt 新函数。

OpenGL的

WITH_OPENGL（默认值：OFF)

OpenGL 集成可用于绘制具有以下后端的硬件加速窗口：GTK、WIN32 和 Qt。并启用与 OpenGL 的基本互操作性，有关详细信息，请参阅 OpenGL 互操作性和 OpenGL 支持。

HighGUI 插件

从 OpenCV 4.5.3 开始，GTK 后端可以构建为动态加载的插件。以下选项可用于控制此机制：

查看 OpenCV 安装概述，了解独立插件构建说明。

深度学习神经网络推理后端和选项（dnn 模块）

OpenCV 有自己的 DNN 推理模块，该模块具有自己的内置引擎，但也可以使用其他库进行优化处理。可以在单个构建中启用多个后端。在运行时自动或手动进行选择。

安装布局

安装根

若要安装生成的二进制文件，应配置根位置。默认值取决于分布，在 Ubuntu 中通常设置为 。它可以在配置过程中更改：/usr/local

此路径可以相对于当前工作目录，在以下示例中，它将设置为：<absolute-path-to-build>/install

生成库后，可以使用以下命令将所有文件复制到配置的安装位置：

要以普通用户身份将二进制文件安装到系统位置（例如），必须使用提升的权限运行上一个命令：/usr/local

注意

在某些平台 （Linux） 上，可以在安装过程中删除符号信息。二进制文件将缩小 10-15%，但调试将受到限制：

组件和位置

选项手杖用于控制是否安装库的一部分：

以下选项允许修改组件相对于安装前缀的安装位置。这些选项的默认值取决于平台和其他选项，有关详细信息，请查看 cmake/OpenCVInstallLayout.cmake 文件。

以下选项可用于更改常见方案的安装布局：

其他功能

下面需要单独的教程来介绍绑定构建

自动构建

一些功能是专门为自动化构建环境添加的，例如持续集成和打包系统。

Contrib 模块

如前所述，模块中使用了以下构建选项，可以通过设置选项将这些额外的模块添加到最终构建中。opencv_contribDOPENCV_EXTRA_MODULES_PATH

注意：本文大量引用官方的资料需要原版资料请移步官网查看相关资料