OpenCV 示例的实用函数

详细描述

函数
void	cv::samples::addSamplesDataSearchPath (const cv::String &path)
	通过添加新的搜索位置来覆盖搜索数据路径。
void	cv::samples::addSamplesDataSearchSubDirectory (const cv::String &subdir)
	追加样本搜索数据子目录。
cv::String	cv::samples::findFile (const cv::String &relative_path, bool required=true, bool silentMode=false)
	尝试查找请求的数据文件。
cv::String	cv::samples::findFileOrKeep (const cv::String &relative_path, bool silentMode=false)

函数文档

addSamplesDataSearchPath()

void cv::samples::addSamplesDataSearchPath

(

const cv::String &

path

)

Python
	cv.samples.addSamplesDataSearchPath(	path	) ->	None

#include <opencv2/core/utility.hpp>

通过添加新的搜索位置来覆盖搜索数据路径。

仅用于覆盖默认行为。传递的路径按后进先出 (LIFO) 顺序使用。

参数

path

用于样本数据的路径

addSamplesDataSearchSubDirectory()

void cv::samples::addSamplesDataSearchSubDirectory

(

const cv::String &

subdir

)

Python
	cv.samples.addSamplesDataSearchSubDirectory(	subdir	) ->	None

#include <opencv2/core/utility.hpp>

追加样本搜索数据子目录。

一般用法是添加 OpenCV 模块名称 (<opencv_contrib>/modules/<name>/samples/data -> <name>/samples/data + modules/<name>/samples/data)。传递的子目录按后进先出 (LIFO) 顺序使用。

参数

subdir

样本数据子目录

findFile()

cv::String cv::samples::findFile	(	const cv::String &	relative_path,
		bool	required = true,
		bool	silentMode = false )

Python
	cv.samples.findFile(	relative_path[, required[, silentMode]]	) ->	retval

#include <opencv2/core/utility.hpp>

尝试查找请求的数据文件。

搜索目录

1. 通过 addSamplesDataSearchPath() 传递的目录
2. OPENCV_SAMPLES_DATA_PATH_HINT 环境变量
3. OPENCV_SAMPLES_DATA_PATH 环境变量 如果参数值不为空且未找到任何内容，则停止搜索。
4. 根据以下内容检测构建/安装路径：a. 当前工作目录 (CWD) b. 和/或二进制模块位置 (opencv_core/opencv_world，静态链接无效)
5. 如果检测到构建目录或当前目录位于源代码树中，则扫描<source>/{,data,samples/data} 目录。
6. 如果检测到安装目录，则扫描<install>/share/OpenCV 目录。

另请参阅

cv::utils::findDataFile

参数

relative_path	数据文件的相对路径
required	指定“文件未找到”的处理方式。如果为 true，则函数打印信息消息并引发 cv::Exception。如果为 false，则函数返回空结果。
silentMode	禁用消息

返回值

返回路径（相对于当前目录的绝对路径或相对路径），如果未找到文件则返回空字符串。

findFileOrKeep()

cv::String cv::samples::findFileOrKeep ( const cv::String & relative_path, bool silentMode = false )

inline

Python
	cv.samples.findFileOrKeep(	relative_path[, silentMode]	) ->	retval

#include <opencv2/core/utility.hpp>

此函数的调用图如下所示