Utility functions for OpenCV samples

Functions
void	cv::samples::addSamplesDataSearchPath (const cv::String &path)
	Override search data path by adding new search location. More...
void	cv::samples::addSamplesDataSearchSubDirectory (const cv::String &subdir)
	Append samples search data sub directory. More...
cv::String	cv::samples::findFile (const cv::String &relative_path, bool required=true, bool silentMode=false)
	Try to find requested data file. More...
cv::String	cv::samples::findFileOrKeep (const cv::String &relative_path, bool silentMode=false)

Detailed Description

Function Documentation

addSamplesDataSearchPath()

void cv::samples::addSamplesDataSearchPath

(

const cv::String &

path

)

Python:
	None	=	cv.samples.addSamplesDataSearchPath(	path	)

Override search data path by adding new search location.

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

Parameters

path	Path to used samples data

addSamplesDataSearchSubDirectory()

void cv::samples::addSamplesDataSearchSubDirectory

(

const cv::String &

subdir

)

Python:
	None	=	cv.samples.addSamplesDataSearchSubDirectory(	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.

Parameters

subdir

samples data sub directory

findFile()

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

Python:
	retval	=	cv.samples.findFile(	relative_path[, required[, silentMode]]	)

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.

See also

cv::utils::findDataFile

Parameters

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

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

Examples:

samples/cpp/connected_components.cpp, samples/cpp/create_mask.cpp, samples/cpp/demhist.cpp, samples/cpp/distrans.cpp, samples/cpp/edge.cpp, samples/cpp/facedetect.cpp, samples/cpp/falsecolor.cpp, samples/cpp/ffilldemo.cpp, samples/cpp/fitellipse.cpp, samples/cpp/grabcut.cpp, samples/cpp/image_alignment.cpp, samples/cpp/lsd_lines.cpp, samples/cpp/squares.cpp, samples/cpp/stitching.cpp, samples/cpp/stitching_detailed.cpp, samples/cpp/warpPerspective_demo.cpp, samples/cpp/watershed.cpp, samples/dnn/classification.cpp, samples/dnn/colorization.cpp, samples/dnn/object_detection.cpp, samples/dnn/openpose.cpp, samples/dnn/segmentation.cpp, and samples/tapi/squares.cpp.

findFileOrKeep()

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

inline

Python:
	retval	=	cv.samples.findFileOrKeep(	relative_path[, silentMode]	)

Examples:

samples/cpp/facedetect.cpp, samples/cpp/laplace.cpp, samples/cpp/peopledetect.cpp, samples/cpp/polar_transforms.cpp, samples/cpp/segment_objects.cpp, and samples/tapi/hog.cpp.