Parallel backends API

クラス
class	cv::parallel::openmp::ParallelForBackend
class	cv::parallel::tbb::ParallelForBackend
class	cv::parallel::ParallelForAPI

関数
CV_EXPORTS void	cv::parallel::setParallelForBackend (const std::shared_ptr< ParallelForAPI > &api, bool propagateNumThreads=true)
	OpenCVのバックエンドを置き換える parallel_for[【詳解】（英語］
CV_EXPORTS_W bool	cv::parallel::setParallelForBackend (const std::string &backendName, bool propagateNumThreads=true)
	OpenCV の parallel_for バックエンドの変更[【詳解】（英語］

詳解

API below is provided to resolve problem of CPU resource over-subscription by multiple thread pools from different multi-threading frameworks. This is common problem for cases when OpenCV compiled threading framework is different from the Users Applications framework.

Applications can replace OpenCV parallel_for() backend with own implementation (to reuse Application's thread pool).

Backend API usage examples

Intel TBB

• include header with simple implementation of TBB backend:
• execute backend replacement code:
• configuration of compiler/linker options is responsibility of Application's scripts

OpenMP

• include header with simple implementation of OpenMP backend:
• execute backend replacement code:
• Configuration of compiler/linker options is responsibility of Application's scripts

Plugins support

Runtime configuration options:

• change backend priority: OPENCV_PARALLEL_PRIORITY_<backend>=9999
• disable backend: OPENCV_PARALLEL_PRIORITY_<backend>=0
• specify list of backends with high priority (>100000): OPENCV_PARALLEL_PRIORITY_LIST=TBB,OPENMP. Unknown backends are registered as new plugins.

関数詳解

setParallelForBackend() [1/2]

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

OpenCVのバックエンドを置き換える parallel_for

アプリケーションは，OpenCVparallel_for()バックエンドを独自の実装で置き換えることができます．

覚え書き

この呼び出しは，スレッドセーフではありません．この関数の呼び出しはmain()から，他のOpenCV処理関数の前に（そして，他のスレッドが生成されないように）この関数を呼び出すことを考慮してください．

setParallelForBackend() [2/2]

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

OpenCV の parallel_for バックエンドの変更

覚え書き

この呼び出しは，スレッドセーフではありません．この関数の呼び出しはmain()から，他のOpenCV処理関数の前に（そして，他のスレッドが生成されないように）この関数を呼び出すことを考慮してください．