Utility functions for OpenCV samples 核心功能 » 实用程序、系统函数及宏


函数

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

详细描述

函数文档编制

addSamplesDataSearchPath()

void cv::samples::addSamplesDataSearchPath ( const cv::String & path )
Python:
None = cv.samples.addSamplesDataSearchPath( path )

#include < opencv2/core/utility.hpp >

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()

void cv::samples::addSamplesDataSearchSubDirectory ( const cv::String & subdir )
Python:
None = cv.samples.addSamplesDataSearchSubDirectory( subdir )

#include < opencv2/core/utility.hpp >

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::String cv::samples::findFile ( const cv::String & relative_path ,
bool required = true ,
bool silentMode = false
)
Python:
retval = cv.samples.findFile( relative_path[, required[, silentMode]] )

#include < opencv2/core/utility.hpp >

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
范例:
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/squares.cpp , samples/cpp/stitching.cpp , samples/cpp/stitching_detailed.cpp , samples/cpp/tutorial_code/features2D/Homography/decompose_homography.cpp , samples/cpp/tutorial_code/features2D/Homography/homography_from_camera_displacement.cpp , samples/cpp/tutorial_code/features2D/Homography/pose_from_homography.cpp , samples/cpp/tutorial_code/HighGUI/AddingImagesTrackbar.cpp , samples/cpp/tutorial_code/ImgProc/Morphology_1.cpp , samples/cpp/tutorial_code/ImgProc/Morphology_2.cpp , samples/cpp/tutorial_code/ImgProc/Pyramids/Pyramids.cpp , samples/cpp/tutorial_code/ImgProc/Smoothing/Smoothing.cpp , samples/cpp/tutorial_code/ImgTrans/copyMakeBorder_demo.cpp , samples/cpp/tutorial_code/ImgTrans/houghcircles.cpp , samples/cpp/tutorial_code/ImgTrans/houghlines.cpp , samples/cpp/tutorial_code/ImgTrans/Sobel_Demo.cpp , samples/cpp/tutorial_code/ml/introduction_to_pca/introduction_to_pca.cpp , samples/cpp/tutorial_code/photo/non_photorealistic_rendering/npr_demo.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 ,和 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] )