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)

函数文档 (Function Documentation)

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 )

内联

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

#include <opencv2/core/utility.hpp>

此函数的调用图