Utility functions for OpenCV samples

関数
CV_EXPORTS_W cv::String	cv::samples::findFile (const cv::String &relative_path, bool required=true, bool silentMode=false)
	Try to find requested data file [詳解]
CV_EXPORTS_W cv::String	cv::samples::findFileOrKeep (const cv::String &relative_path, bool silentMode=false)
CV_EXPORTS_W void	cv::samples::addSamplesDataSearchPath (const cv::String &path)
	Override search data path by adding new search location [詳解]
CV_EXPORTS_W void	cv::samples::addSamplesDataSearchSubDirectory (const cv::String &subdir)
	Append samples search data sub directory [詳解]

詳解

関数詳解

addSamplesDataSearchPath()

CV_EXPORTS_W void cv::samples::addSamplesDataSearchPath

(

const cv::String &

path

)

Override search data path by adding new search location

Use this only to override default behavior Passed paths are used in LIFO order.

引数

path	Path to used samples data

addSamplesDataSearchSubDirectory()

CV_EXPORTS_W void cv::samples::addSamplesDataSearchSubDirectory

(

const cv::String &

subdir

)

Append samples search data sub directory

General usage is to add OpenCV modules name (<opencv_contrib>/modules/<name>/samples/data -> <name>/samples/data + modules/<name>/samples/data). Passed subdirectories are used in LIFO order.

引数

subdir

samples data sub directory

findFile()

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

Try to find requested data file

Search directories:

1. Directories passed via addSamplesDataSearchPath()
2. OPENCV_SAMPLES_DATA_PATH_HINT environment variable
3. OPENCV_SAMPLES_DATA_PATH environment variable If parameter value is not empty and nothing is found then stop searching.
4. Detects build/install path based on: a. current working directory (CWD) b. and/or binary module location (opencv_core/opencv_world, doesn't work with static linkage)
5. Scan <source>/{,data,samples/data} directories if build directory is detected or the current directory is in source tree.
6. Scan <install>/share/OpenCV directory if install directory is detected.

参照

cv::utils::findDataFile

引数

relative_path	Relative path to data file
required	Specify "file not found" handling. If true, function prints information message and raises cv::Exception. If false, function returns empty result
silentMode	Disables messages

戻り値

Returns path (absolute or relative to the current directory) or empty string if file is not found