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>

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

仅使用此项覆盖默认行为已传递的路径按后进先出顺序使用。

参数

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)。已传递的子目录按后进先出顺序使用。

参数

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	到数据文件的相对路径
必需	指定“文件未找到”处理方式。如果为真，则该函数会打印信息消息并引发 cv::Exception。如果为假，则该函数会返回空结果
silentMode	禁用消息

返回

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

findFileOrKeep()

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

内嵌

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

#include <opencv2/core/utility.hpp>

以下是此函数的调用图