Utility functions for OpenCV samples

関数
CV_EXPORTS_W cv::String	cv::samples::findFile (const cv::String &relative_path, bool required=true, bool silentMode=false)
	要求されたデータファイルの検索を試みます．[【詳解】（英語］
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)
	新しい検索場所を追加して検索データ・パスを上書きする[【詳解】（英語］
CV_EXPORTS_W void	cv::samples::addSamplesDataSearchSubDirectory (const cv::String &subdir)
	サンプル検索データのサブディレクトリを追加[【詳解】（英語］

詳解

関数詳解

addSamplesDataSearchPath()

CV_EXPORTS_W void cv::samples::addSamplesDataSearchPath

(

const cv::String &

path

)

新しい検索場所を追加して検索データ・パスを上書きする

デフォルトの動作をオーバーライドする場合にのみ使用します 通過したパスは LIFO 順に使用されます。

引数

path	使用するサンプルデータへのパス

addSamplesDataSearchSubDirectory()

CV_EXPORTS_W void cv::samples::addSamplesDataSearchSubDirectory

(

const cv::String &

subdir

)

サンプル検索データのサブディレクトリを追加

一般的な使い方としては，OpenCV モジュール名 (<opencv_contrib>/modules/<name>/samples/data-><name>/samples/data+modules/<name>/samples/data). 渡されたサブディレクトリはLIFO順に使用されます。

引数

subdir

samples データサブディレクトリ

findFile()

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

要求されたデータファイルの検索を試みます．

ディレクトリを検索します。

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	ファイルが見つからない "という処理を指定します．真であれば，情報メッセージを表示し，レイズします．cv::Exception. 偽の場合は，空の結果を返します．
silentMode	メッセージを表示しません。

戻り値

ファイルが見つからない場合，パス（カレントディレクトリへの絶対または相対）または空の文字列を返します．