cv::cuda::NvidiaOpticalFlow_2_0 クラス

NVIDIA Optical Flow ハードウェアと Optical Flow SDK 2.0 を用いて、2枚の画像間のオプティカルフローベクトルを計算するクラス。 続き...

#include <opencv2/cudaoptflow.hpp>

Collaboration diagram for cv::cuda::NvidiaOpticalFlow_2_0:

公開型
enum	NVIDIA_OF_HINT_VECTOR_GRID_SIZE {   NV_OF_HINT_VECTOR_GRID_SIZE_UNDEFINED ,   NV_OF_HINT_VECTOR_GRID_SIZE_1 = 1 ,   NV_OF_HINT_VECTOR_GRID_SIZE_2 = 2 ,   NV_OF_HINT_VECTOR_GRID_SIZE_4 = 4 ,   NV_OF_HINT_VECTOR_GRID_SIZE_8 = 8 ,   NV_OF_HINT_VECTOR_GRID_SIZE_MAX }
enum	NVIDIA_OF_OUTPUT_VECTOR_GRID_SIZE {   NV_OF_OUTPUT_VECTOR_GRID_SIZE_UNDEFINED ,   NV_OF_OUTPUT_VECTOR_GRID_SIZE_1 = 1 ,   NV_OF_OUTPUT_VECTOR_GRID_SIZE_2 = 2 ,   NV_OF_OUTPUT_VECTOR_GRID_SIZE_4 = 4 ,   NV_OF_OUTPUT_VECTOR_GRID_SIZE_MAX }
enum	NVIDIA_OF_PERF_LEVEL {   NV_OF_PERF_LEVEL_UNDEFINED ,   NV_OF_PERF_LEVEL_SLOW = 5 ,   NV_OF_PERF_LEVEL_MEDIUM = 10 ,   NV_OF_PERF_LEVEL_FAST = 20 ,   NV_OF_PERF_LEVEL_MAX }

公開メンバ関数
virtual void	convertToFloat (InputArray flow, InputOutputArray floatFlow)=0
	ヘルパー関数 convertToFloat() は、ハードウェアが生成したフローベクトルを浮動小数点表現に変換する (gridSize ごとに1つのフローベクトル)。gridSize は関数 getGridSize() で取得できる。
Public Member Functions inherited from cv::cuda::NvidiaHWOpticalFlow
virtual void	calc (InputArray inputImage, InputArray referenceImage, InputOutputArray flow, Stream &stream=Stream::Null(), InputArray hint=cv::noArray(), OutputArray cost=cv::noArray())=0
	NVIDIA Optical Flow SDKを用いてオプティカルフローを計算する。
virtual void	collectGarbage ()=0
	すべてのバッファ、コンテキスト、デバイスポインタを解放する。
virtual int	getGridSize () const =0
	ハードウェアの能力に応じた出力バッファのグリッドサイズを返す。
Public Member Functions inherited from cv::Algorithm
	Algorithm ()
virtual	~Algorithm ()
virtual void	clear ()
	アルゴリズムの状態をクリアする。
virtual bool	empty () const
	Algorithm が空の場合（たとえば開始直後や読み込みに失敗した後）に true を返す。
virtual String	getDefaultName () const
virtual void	read (const FileNode &fn)
	ファイルストレージからアルゴリズムの引数を読み込む。
virtual void	save (const String &filename) const
virtual void	write (FileStorage &fs) const
	アルゴリズムの引数をファイルストレージに保存する。
void	write (FileStorage &fs, const String &name) const

静的公開メンバ関数
static Ptr< NvidiaOpticalFlow_2_0 >	create (cv::Size imageSize, cv::cuda::NvidiaOpticalFlow_2_0::NVIDIA_OF_PERF_LEVEL perfPreset=cv::cuda::NvidiaOpticalFlow_2_0::NV_OF_PERF_LEVEL_SLOW, cv::cuda::NvidiaOpticalFlow_2_0::NVIDIA_OF_OUTPUT_VECTOR_GRID_SIZE outputGridSize=cv::cuda::NvidiaOpticalFlow_2_0::NV_OF_OUTPUT_VECTOR_GRID_SIZE_1, cv::cuda::NvidiaOpticalFlow_2_0::NVIDIA_OF_HINT_VECTOR_GRID_SIZE hintGridSize=cv::cuda::NvidiaOpticalFlow_2_0::NV_OF_HINT_VECTOR_GRID_SIZE_1, bool enableTemporalHints=false, bool enableExternalHints=false, bool enableCostBuffer=false, int gpuId=0, Stream &inputStream=Stream::Null(), Stream &outputStream=Stream::Null())
	NVIDIA Optical Flow をインスタンス化する。
static Ptr< NvidiaOpticalFlow_2_0 >	create (cv::Size imageSize, std::vector< Rect > roiData, cv::cuda::NvidiaOpticalFlow_2_0::NVIDIA_OF_PERF_LEVEL perfPreset=cv::cuda::NvidiaOpticalFlow_2_0::NV_OF_PERF_LEVEL_SLOW, cv::cuda::NvidiaOpticalFlow_2_0::NVIDIA_OF_OUTPUT_VECTOR_GRID_SIZE outputGridSize=cv::cuda::NvidiaOpticalFlow_2_0::NV_OF_OUTPUT_VECTOR_GRID_SIZE_1, cv::cuda::NvidiaOpticalFlow_2_0::NVIDIA_OF_HINT_VECTOR_GRID_SIZE hintGridSize=cv::cuda::NvidiaOpticalFlow_2_0::NV_OF_HINT_VECTOR_GRID_SIZE_1, bool enableTemporalHints=false, bool enableExternalHints=false, bool enableCostBuffer=false, int gpuId=0, Stream &inputStream=Stream::Null(), Stream &outputStream=Stream::Null())
	ROI 機能付きで NVIDIA Optical Flow をインスタンス化する。
Static Public Member Functions inherited from cv::Algorithm
template<typename _Tp >
static Ptr< _Tp >	load (const String &filename, const String &objname=String())
	ファイルからアルゴリズムを読み込む。
template<typename _Tp >
static Ptr< _Tp >	loadFromString (const String &strModel, const String &objname=String())
	文字列からアルゴリズムを読み込む。
template<typename _Tp >
static Ptr< _Tp >	read (const FileNode &fn)
	ファイルノードからアルゴリズムを読み込む。

Additional Inherited Members
Protected Member Functions inherited from cv::Algorithm
void	writeFormat (FileStorage &fs) const

詳細説明

NVIDIA Optical Flow ハードウェアと Optical Flow SDK 2.0 を用いて、2枚の画像間のオプティカルフローベクトルを計算するクラス。

覚え書き

• NVIDIA Optical Flow の使用例を示すサンプルアプリケーションは opencv_contrib_source_code/modules/cudaoptflow/samples/nvidia_optical_flow.cpp にある
• NVIDIA Optical Flow と OpenCV の他のオプティカルフローアルゴリズムとの精度および性能を比較するサンプルアプリケーションは opencv_contrib_source_code/modules/cudaoptflow/samples/optical_flow.cpp にある

列挙型メンバ詳解

NVIDIA_OF_HINT_VECTOR_GRID_SIZE

enum cv::cuda::NvidiaOpticalFlow_2_0::NVIDIA_OF_HINT_VECTOR_GRID_SIZE

ヒントバッファでサポートされるグリッドサイズ。

列挙値
NV_OF_HINT_VECTOR_GRID_SIZE_UNDEFINED
NV_OF_HINT_VECTOR_GRID_SIZE_1	ヒントバッファのグリッドサイズは 1x1。
NV_OF_HINT_VECTOR_GRID_SIZE_2	ヒントバッファのグリッドサイズは 2x2。
NV_OF_HINT_VECTOR_GRID_SIZE_4	ヒントバッファのグリッドサイズは 4x4。
NV_OF_HINT_VECTOR_GRID_SIZE_8	ヒントバッファのグリッドサイズは 8x8。
NV_OF_HINT_VECTOR_GRID_SIZE_MAX

NVIDIA_OF_OUTPUT_VECTOR_GRID_SIZE

enum cv::cuda::NvidiaOpticalFlow_2_0::NVIDIA_OF_OUTPUT_VECTOR_GRID_SIZE

出力バッファでサポートされるグリッドサイズ。

列挙値
NV_OF_OUTPUT_VECTOR_GRID_SIZE_UNDEFINED
NV_OF_OUTPUT_VECTOR_GRID_SIZE_1	出力バッファのグリッドサイズは 1x1
NV_OF_OUTPUT_VECTOR_GRID_SIZE_2	出力バッファのグリッドサイズは 2x2
NV_OF_OUTPUT_VECTOR_GRID_SIZE_4	出力バッファのグリッドサイズは 4x4
NV_OF_OUTPUT_VECTOR_GRID_SIZE_MAX

NVIDIA_OF_PERF_LEVEL

enum cv::cuda::NvidiaOpticalFlow_2_0::NVIDIA_OF_PERF_LEVEL

サポートされるオプティカルフローのパフォーマンスレベル。

列挙値
NV_OF_PERF_LEVEL_UNDEFINED
NV_OF_PERF_LEVEL_SLOW	Slow パフォーマンスレベルは、最も低い性能と最良の品質をもたらす
NV_OF_PERF_LEVEL_MEDIUM	Medium パフォーマンスレベルは、低い性能と中程度の品質をもたらす
NV_OF_PERF_LEVEL_FAST	Fast パフォーマンスレベルは、高い性能と低い品質をもたらす
NV_OF_PERF_LEVEL_MAX

メンバ関数詳解

convertToFloat()

virtual void cv::cuda::NvidiaOpticalFlow_2_0::convertToFloat ( InputArray flow, InputOutputArray floatFlow )

pure virtual

ヘルパー関数 convertToFloat() は、ハードウェアが生成したフローベクトルを浮動小数点表現に変換する (gridSize ごとに1つのフローベクトル)。gridSize は関数 getGridSize() で取得できる。

引数

flow	calc() によって生成されたフローベクトルを格納する CV_16FC2 型のバッファ。
floatFlow	CV_32FC2 型のバッファ。浮動小数点表現のフローベクトルを格納し、各フローベクトルは gridSize あたり1ピクセル分で、ピッチリニアレイアウトで配置される。

create() [1/2]

static Ptr< NvidiaOpticalFlow_2_0 > cv::cuda::NvidiaOpticalFlow_2_0::create ( cv::Size imageSize, cv::cuda::NvidiaOpticalFlow_2_0::NVIDIA_OF_PERF_LEVEL perfPreset = cv::cuda::NvidiaOpticalFlow_2_0::NV_OF_PERF_LEVEL_SLOW, cv::cuda::NvidiaOpticalFlow_2_0::NVIDIA_OF_OUTPUT_VECTOR_GRID_SIZE outputGridSize = cv::cuda::NvidiaOpticalFlow_2_0::NV_OF_OUTPUT_VECTOR_GRID_SIZE_1, cv::cuda::NvidiaOpticalFlow_2_0::NVIDIA_OF_HINT_VECTOR_GRID_SIZE hintGridSize = cv::cuda::NvidiaOpticalFlow_2_0::NV_OF_HINT_VECTOR_GRID_SIZE_1, bool enableTemporalHints = false, bool enableExternalHints = false, bool enableCostBuffer = false, int gpuId = 0, Stream & inputStream = Stream::Null(), Stream & outputStream = Stream::Null() )

static

NVIDIA Optical Flow をインスタンス化する。

引数

imageSize	入力画像のサイズ（ピクセル単位）。
perfPreset	省略可能な引数。プリセットの詳細については NV OF SDK のドキュメント を参照。デフォルトは NV_OF_PERF_LEVEL_SLOW。
outputGridSize	省略可能な引数。出力グリッドサイズの詳細については NV OF SDK のドキュメント を参照。デフォルトは NV_OF_OUTPUT_VECTOR_GRID_SIZE_1。
hintGridSize	省略可能な引数。ヒントグリッドサイズの詳細については NV OF SDK のドキュメント を参照。デフォルトは NV_OF_HINT_VECTOR_GRID_SIZE_1。
enableTemporalHints	省略可能な引数。時間的ヒントを有効にするフラグ。true に設定すると、ハードウェアは前回の calc() 呼び出しで生成されたフローベクトルを、今回の calc() 呼び出しの内部ヒントとして使用する。連続するビデオフレーム間のフローベクトルを計算する際に有用。デフォルトは false。
enableExternalHints	省略可能な引数。外部のヒントバッファを calc() に渡すことを有効にするフラグ。デフォルトは false。
enableCostBuffer	省略可能な引数。calc() からのコストバッファ出力を有効にするフラグ。デフォルトは false。
gpuId	オプティカルフローを計算する GPU ID を選択する省略可能な引数。マルチGPUシステムで有用。デフォルトは 0。
inputStream	オプティカルフローアルゴリズムは、入力バッファに対する cuda 前処理を任意に含む場合がある。入力 cuda ストリームを用いて、cuda 前処理タスクを OF HW エンジンとパイプライン化・同期できる。入力ストリームが設定されていない場合、execute 関数は NULL ストリームであるデフォルトストリームを使用する。
outputStream	オプティカルフローアルゴリズムは、出力フローベクトルに対する cuda 後処理を任意に含む場合がある。出力 cuda ストリームを用いて、cuda 後処理タスクを OF HW エンジンとパイプライン化・同期できる。出力ストリームが設定されていない場合、execute 関数は NULL ストリームであるデフォルトストリームを使用する。

create() [2/2]

static Ptr< NvidiaOpticalFlow_2_0 > cv::cuda::NvidiaOpticalFlow_2_0::create ( cv::Size imageSize, std::vector< Rect > roiData, cv::cuda::NvidiaOpticalFlow_2_0::NVIDIA_OF_PERF_LEVEL perfPreset = cv::cuda::NvidiaOpticalFlow_2_0::NV_OF_PERF_LEVEL_SLOW, cv::cuda::NvidiaOpticalFlow_2_0::NVIDIA_OF_OUTPUT_VECTOR_GRID_SIZE outputGridSize = cv::cuda::NvidiaOpticalFlow_2_0::NV_OF_OUTPUT_VECTOR_GRID_SIZE_1, cv::cuda::NvidiaOpticalFlow_2_0::NVIDIA_OF_HINT_VECTOR_GRID_SIZE hintGridSize = cv::cuda::NvidiaOpticalFlow_2_0::NV_OF_HINT_VECTOR_GRID_SIZE_1, bool enableTemporalHints = false, bool enableExternalHints = false, bool enableCostBuffer = false, int gpuId = 0, Stream & inputStream = Stream::Null(), Stream & outputStream = Stream::Null() )

static

ROI 機能付きで NVIDIA Optical Flow をインスタンス化する。

引数

imageSize	入力画像のサイズ（ピクセル単位）。
roiData	ROI データへのポインタ。
perfPreset	省略可能な引数。プリセットの詳細については NV OF SDK のドキュメント を参照。デフォルトは NV_OF_PERF_LEVEL_SLOW。
outputGridSize	省略可能な引数。出力グリッドサイズの詳細については NV OF SDK のドキュメント を参照。デフォルトは NV_OF_OUTPUT_VECTOR_GRID_SIZE_1。
hintGridSize	省略可能な引数。ヒントグリッドサイズの詳細については NV OF SDK のドキュメント を参照。デフォルトは NV_OF_HINT_VECTOR_GRID_SIZE_1。
enableTemporalHints	省略可能な引数。時間的ヒントを有効にするフラグ。true に設定すると、ハードウェアは前回の calc() 呼び出しで生成されたフローベクトルを、今回の calc() 呼び出しの内部ヒントとして使用する。連続するビデオフレーム間のフローベクトルを計算する際に有用。デフォルトは false。
enableExternalHints	省略可能な引数。外部のヒントバッファを calc() に渡すことを有効にするフラグ。デフォルトは false。
enableCostBuffer	省略可能な引数。calc() からのコストバッファ出力を有効にするフラグ。デフォルトは false。
gpuId	オプティカルフローを計算する GPU ID を選択する省略可能な引数。マルチGPUシステムで有用。デフォルトは 0。
inputStream	オプティカルフローアルゴリズムは、入力バッファに対する cuda 前処理を任意に含む場合がある。入力 cuda ストリームを用いて、cuda 前処理タスクを OF HW エンジンとパイプライン化・同期できる。入力ストリームが設定されていない場合、execute 関数は NULL ストリームであるデフォルトストリームを使用する。
outputStream	オプティカルフローアルゴリズムは、出力フローベクトルに対する cuda 後処理を任意に含む場合がある。出力 cuda ストリームを用いて、cuda 後処理タスクを OF HW エンジンとパイプライン化・同期できる。出力ストリームが設定されていない場合、execute 関数は NULL ストリームであるデフォルトストリームを使用する。

---

このクラス詳解は次のファイルから抽出されました:

• opencv2/cudaoptflow.hpp