并行后端 API

详细描述

提供以下 API 以解决来自不同多线程框架的多个线程池过度订阅 CPU 资源的问题。 对于 OpenCV 编译的线程框架与用户应用程序框架不同的情况，这是一个常见问题。

应用程序可以用自己的实现替换 OpenCV 的 parallel_for() 后端（以重用应用程序的线程池）。

后端 API 用法示例

Intel TBB

• 包含带有 TBB 后端简单实现的头文件

  #include "opencv2/core/parallel/backend/parallel_for.tbb.hpp"

• 执行后端替换代码

      cv::parallel::setParallelForBackend(std::make_shared<cv::parallel::tbb::ParallelForBackend>());

• 编译器/链接器选项的配置是应用程序脚本的责任

OpenMP

• 包含带有 OpenMP 后端简单实现的头文件

  #include "opencv2/core/parallel/backend/parallel_for.openmp.hpp"

• 执行后端替换代码

      //omp_set_dynamic(1);
      cv::parallel::setParallelForBackend(std::make_shared<cv::parallel::openmp::ParallelForBackend>());

• 编译器/链接器选项的配置是应用程序脚本的责任

插件支持

运行时配置选项

• 更改后端优先级：OPENCV_PARALLEL_PRIORITY_<backend>=9999
• 禁用后端：OPENCV_PARALLEL_PRIORITY_<backend>=0
• 指定具有高优先级（>100000）的后端列表：OPENCV_PARALLEL_PRIORITY_LIST=TBB,OPENMP。 未知的后端将被注册为新插件。

类
类	cv::parallel::ParallelForAPI
类	cv::parallel::openmp::ParallelForBackend
类	cv::parallel::tbb::ParallelForBackend

函数
void	cv::parallel::setParallelForBackend (const std::shared_ptr< ParallelForAPI > &api, bool propagateNumThreads=true)
	替换 OpenCV parallel_for 后端。
bool	cv::parallel::setParallelForBackend (const std::string &backendName, bool propagateNumThreads=true)
	更改 OpenCV parallel_for 后端。

函数文档

setParallelForBackend() [1/2]

void cv::parallel::setParallelForBackend	(	const std::shared_ptr< ParallelForAPI > &	api,
		bool	propagateNumThreads = true )

Python
	cv.parallel.setParallelForBackend(	backendName[, propagateNumThreads]	) ->	retval

#include <opencv2/core/parallel/parallel_backend.hpp>

替换 OpenCV parallel_for 后端。

应用程序可以用自己的实现替换 OpenCV 的 parallel_for() 后端。

注意

此调用不是线程安全的。 考虑在任何其他 OpenCV 处理函数之前（且不创建任何其他线程）从 main() 中调用此函数。

setParallelForBackend() [2/2]

bool cv::parallel::setParallelForBackend	(	const std::string &	backendName,
		bool	propagateNumThreads = true )

Python
	cv.parallel.setParallelForBackend(	backendName[, propagateNumThreads]	) ->	retval

#include <opencv2/core/parallel/parallel_backend.hpp>

更改 OpenCV parallel_for 后端。

注意

此调用不是线程安全的。 考虑在任何其他 OpenCV 处理函数之前（且不创建任何其他线程）从 main() 中调用此函数。