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 &

path

)

Python:
	cv.samples.addSamplesDataSearchPath(	path	) ->	None

#include <opencv2/core/utility.hpp>

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

これはデフォルトの動作を上書きする場合にのみ使用する。渡されたパスは LIFO 順で使用される。

引数

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

addSamplesDataSearchSubDirectory()

void cv::samples::addSamplesDataSearchSubDirectory

(

const cv::String &

subdir

)

Python:
	cv.samples.addSamplesDataSearchSubDirectory(	subdir	) ->	None

#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	"file not found" の扱いを指定する。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>

この関数の呼び出しグラフ: