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 &

路径

)

Python
	cv.samples.addSamplesDataSearchPath(	路径	) ->	无

#include <opencv2/core/utility.hpp>

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

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

参数

路径	要使用的示例数据的路径

addSamplesDataSearchSubDirectory()

void cv::samples::addSamplesDataSearchSubDirectory

(

const cv::String &

subdir

)

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

#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>

此函数的调用图如下