OpenCV 并行处理与构建配置指南

OpenCV 支持多种并行后端如 pthreads、TBB 和 OpenMP，可通过 CMake 选项在构建时启用。GUI 模块依赖 GTK、Win32 或 Qt 等库，DNN 模块支持 CUDA、OpenVINO 等推理引擎。安装布局可通过 CMAKE_INSTALL_PREFIX 自定义，支持 Python 和 Java 绑定。专利算法需手动开启，部分第三方库如 Protobuf 可内置或外部链接。构建过程包含插件支持、警告处理和示例安装等配置项。

RustyLab发布于 2025/2/70 浏览

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

后端	选择	默认	平台	描述
线程	`WITH_PTHREADS_PF`	是	类 Unix 系统	基于 pthreads 库的默认后端可在 Linux、Android 和其他类 Unix 平台上使用。线程池是在 OpenCV 中实现的，可以通过环境变量进行控制。有关详细信息，请查看 modules/core/src/parallel_impl.cpp 文件中的源代码。`OPENCV_THREAD_POOL_*`
并发 (Windows)	不适用	是	Windows	在 Windows 上可用，除非启用了其他后端，否则将在支持的平台上打开。
GCD (Apple)	不适用	是	macOS	可在 Apple 平台上使用，除非启用其他后端，否则将自动打开。使用全局系统线程池。
TBB	`WITH_TBB`	否	跨平台	是一个用于并行编程的跨平台库。
OpenMP	`WITH_OPENMP`	否	跨平台	API 依赖于编译器支持。
HPX	`WITH_HPX`	否	跨平台	是一个实验性的后端，更适合多处理器环境。

注意：OpenCV 可以从 GitHub 下载和构建 TBB 库，此功能可以通过选项启用 BUILD_TBB。

线程插件

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

选择	默认	描述
PARALLEL_ENABLE_PLUGINS	是	启用插件支持，如果禁用此选项，OpenCV 将不会尝试加载任何内容

查看官方文档，了解独立插件构建说明。

GUI 后端（highgui 模块）

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

选择	默认	平台	描述
`WITH_GTK`	是	Linux 操作系统	GTK 是 Linux 和类 Unix 操作系统中的常用工具包。默认情况下，如果找到，将使用版本 3，可以使用该选项强制使用版本 2。`WITH_GTK_2_X`
`WITH_WIN32UI`	是	Windows	是 Windows 中的标准 GUI API。
不适用	是	macOS 操作系统

选择	默认	描述
`HIGHGUI_ENABLE_PLUGINS`	是	完全启用或禁用插件。
`HIGHGUI_PLUGIN_LIST`	空	以逗号或分号分隔的要编译为插件的后端名称列表。支持的名称包括 gtk、gtk2、gtk3 和 all。

选择	默认	描述
`WITH_PROTOBUF`	是	启用 Protobuf 库搜索。OpenCV 可以构建自己的库副本，也可以使用外部库。dnn 模块需要此依赖项，如果找不到模块，则禁用该模块。
`BUILD_PROTOBUF`	是	构建自己的 protobuf 副本。如果要使用外部库，则必须禁用。
`PROTOBUF_UPDATE_FILES`	否	重新生成所有 .proto 文件。必须安装与使用的 Protobuf 版本兼容的 Protoc 编译器。
`OPENCV_DNN_OPENCL`	是	启用内置 OpenCL 推理后端。
`WITH_INF_ENGINE`	否	自 OpenVINO 2022.1 起已弃用启用 Intel 推理引擎后端。允许以 IE 格式（.xml + .bin）执行网络。推理引擎必须作为 OpenVINO 的一部分安装，也可以作为从源代码构建的独立库安装。
`INF_ENGINE_RELEASE`	2020040000	自 OpenVINO 2022.1 起已弃用定义与 OpenVINO 工具套件版本绑定的推理引擎库版本。必须是 10 位字符串，例如 OpenVINO 2020.4 的 2020040000。
`WITH_NGRAPH`	否	自 OpenVINO 2022.1 起已弃用启用英特尔 NGraph 库支持。该库是推理引擎后端的一部分，它允许执行从 OpenCV 支持的多种格式的文件中读取的任意网络：Caffe、TensorFlow、PyTorch、Darknet 等。必须安装 NGraph 库，它包含在推理引擎中。
`WITH_OPENVINO`	否	启用英特尔 OpenVINO 工具套件支持。应用于 OpenVINO>=2022.1 而不是 `WITH_INF_ENGINE` 和 `WITH_NGRAPH`。
`OPENCV_DNN_CUDA`	否	启用 CUDA 后端。必须安装 CUDA、CUBLAS 和 cuDNN。
`WITH_HALIDE`	否	使用实验性的 Halide 后端，它可以在运行时为 dnn 层生成优化的代码。必须安装 Halide。
`WITH_VULKAN`	否	启用实验性 Vulkan 后端。不需要额外的依赖项，但可以使用外部 Vulkan 标头。`VULKAN_INCLUDE_DIRS`

选择	默认	描述
`INSTALL_C_EXAMPLES`	否	从 samples/cpp 目录安装 C++ 示例源。
`INSTALL_PYTHON_EXAMPLES`	否	从 samples/python 目录安装 Python 示例源。
`INSTALL_ANDROID_EXAMPLES`	否	从 samples/android 目录安装 Android 示例源。
`INSTALL_BIN_EXAMPLES`	否	安装预构建的示例应用程序（必须启用）。`BUILD_EXAMPLES`
`INSTALL_TESTS`	否	安装测试（必须启用）。`BUILD_TESTS`
`OPENCV_INSTALL_APPS_LIST`	全部	要安装的预构建应用程序的逗号或分号分隔列表（来自 apps 目录）

选择	组件
`OPENCV_BIN_INSTALL_PATH`	应用程序，动态库（WIN）
`OPENCV_TEST_INSTALL_PATH`	测试应用程序
`OPENCV_SAMPLES_BIN_INSTALL_PATH`	示例应用程序
`OPENCV_LIB_INSTALL_PATH`	动态库、导入库（WIN）
`OPENCV_LIB_ARCHIVE_INSTALL_PATH`	静态库
`OPENCV_3P_LIB_INSTALL_PATH`	第三方库
`OPENCV_CONFIG_INSTALL_PATH`	CMake 配置包
`OPENCV_INCLUDE_INSTALL_PATH`	头文件
`OPENCV_OTHER_INSTALL_PATH`	额外的数据文件
`OPENCV_SAMPLES_SRC_INSTALL_PATH`	示例源
`OPENCV_LICENSES_INSTALL_PATH`	包含的第三方组件的许可证
`OPENCV_TEST_DATA_INSTALL_PATH`	测试数据
`OPENCV_DOC_INSTALL_PATH`	文档
`OPENCV_JAR_INSTALL_PATH`	带有 Java 绑定的 JAR 文件
`OPENCV_JNI_INSTALL_PATH`	Java 绑定的 JNI 部分
`OPENCV_JNI_BIN_INSTALL_PATH`	来自 Java 绑定的 JNI 部分的动态库

选择	默认	描述
`OPENCV_ENABLE_NONFREE`	否	已知库中包含的某些算法受专利保护，默认情况下处于禁用状态。
`OPENCV_FORCE_3RDPARTY_BUILD`	否	一次启用所有选项。`BUILD_*`
`OPENCV_IPP_ENABLE_ALL`	否	一次启用所有选项。`OPENCV_IPP_*`
`ENABLE_CCACHE`	ON（在类 Unix 平台上）	启用 ccache 自动检测。该工具包装编译器调用并缓存结果，可以显著缩短重新编译时间。
`ENABLE_PRECOMPILED_HEADERS`	ON（用于 MSVC）	启用预编译头支持。缩短了构建时间。
`BUILD_DOCS`	否	启用文档构建（doxygen、doxygen_cpp、doxygen_python、doxygen_javadoc目标）。必须安装 Doxygen 才能构建 C++ 文档。必须安装 Python 和 Sphinx 才能构建 Python 文档。必须安装 Javadoc 和 Ant 才能构建 Java 文档（Java SDK 的一部分）。
`ENABLE_PYLINT`	ON（启用文档或示例时）	使用 check_pylint 目标启用 python 脚本检查。必须安装 Pylint。
`ENABLE_FLAKE8`	ON（启用文档或示例时）	使用 check_flake8 目标启用 python 脚本检查。必须安装 Flake8。
`BUILD_JAVA`	是	启用 Java 包装器构建。必须安装 Java SDK 和 Ant。
`BUILD_FAT_JAVA_LIB`	ON（适用于静态 Android 版本）	构建单个 opencv_java 动态库，其中包含与 Java 绑定捆绑在一起的所有库功能。
`BUILD_opencv_python2`	是	构建 python2 绑定（已弃用）。必须安装带有开发文件和 numpy 的 Python。
`BUILD_opencv_python3`	是	生成 python3 绑定。必须安装带有开发文件和 numpy 的 Python。
`CAROTENE_NEON_ARCH`	（自动）	将 NEON 架构切换为 Carotene。如果它没有设置任何内容，它将被自动检测。如果设置为 8，则使用 ARMv8（及更高版本）。否则，将使用 ARMv7。

OpenCV 并行处理与构建配置指南

线程插件

GUI 后端（highgui 模块）

更多推荐文章

相关免费在线工具

OpenGL

HighGUI 插件

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

安装布局

安装根目录

组件和位置

其他功能

自动构建

Contrib 模块

选择	默认	描述
`INSTALL_CREATE_DISTRIB`	否	调整多个内容以生成 Windows 和 Android 发行版。
`INSTALL_TO_MANGLED_PATHS`	否	将一个级别添加到多个安装位置，以允许并行安装。例如，启用此选项后，标头将安装到 /usr/include/opencv-4.4.0 而不是 /usr/include/opencv4。

选择	默认	描述
`ENABLE_NOISY_WARNINGS`	否	启用多个被视为干扰的编译器警告，即重要性低于其他警告。这些警告通常被忽略，但在某些情况下可能值得检查。
`OPENCV_WARNINGS_ARE_ERRORS`	否	将编译器警告视为错误。生成将停止。
`ENABLE_CONFIG_VERIFICATION`	否	对于每个已启用的依赖项（选项），请验证是否已找到并启用它（变量）。默认情况下，如果未找到依赖项，功能将静默关闭，但启用此选项后，cmake 配置将失败。方便于需要稳定库配置的打包系统，不依赖于环境波动。`WITH_` 和 `HAVE_`
`OPENCV_CMAKE_HOOKS_DIR`	空	OpenCV 允许通过在每个阶段和子阶段添加自定义钩子脚本来自定义配置过程。在此变量设置的目录中具有预定义名称的 cmake 脚本将包含在各个配置阶段之前和之后。文件名示例：CMAKE_INIT.cmake、PRE_CMAKE_BOOTSTRAP.cmake、POST_CMAKE_BOOTSTRAP.cmake 等。其他名称未记录在案，可以通过搜索 ocv_cmake_hook 宏调用在项目 cmake 文件中找到。
`OPENCV_DUMP_HOOKS_FLOW`	否	在每个 cmake 钩子脚本调用上启用调试消息打印。

OpenCV 并行处理与构建配置指南

线程插件

GUI 后端（highgui 模块）

微信扫一扫，关注极客日志

更多推荐文章

相关免费在线工具

OpenGL

HighGUI 插件

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

安装布局

安装根目录

组件和位置

其他功能

自动构建

Contrib 模块