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>

此函式的呼叫圖如下