高レベルな画像スティッチャー。続き...

#include <opencv2/stitching.hpp>

Collaboration diagram for cv::Stitcher:

公開型
enum	Mode { PANORAMA = 0 , SCANS = 1 }

enum	Status { OK = 0 , ERR_NEED_MORE_IMGS = 1 , ERR_HOMOGRAPHY_EST_FAIL = 2 , ERR_CAMERA_PARAMS_ADJUST_FAIL = 3 }

公開メンバ関数
Ptr< detail::Blender >	blender ()

const Ptr< detail::Blender >	blender () const

Ptr< detail::BundleAdjusterBase >	bundleAdjuster ()

const Ptr< detail::BundleAdjusterBase >	bundleAdjuster () const

std::vector< cv::detail::CameraParams >	cameras () const

std::vector< int >	component () const
	パノラマのスティッチングに使用された入力画像のインデックスを返す。

Status	composePanorama (InputArrayOfArrays images, OutputArray pano)
	これらの関数は、画像の変換が事前に推定されているという前提のもとで、指定された画像 (または他の関数呼び出しから内部的に格納された画像) を最終的なパノラマに合成しようとする。

Status	composePanorama (OutputArray pano)

double	compositingResol () const

Status	estimateTransform (InputArrayOfArrays images, InputArrayOfArrays masks=noArray())
	これらの関数は、指定された画像をマッチングし、各カメラの回転を推定しようとする。

Ptr< detail::Estimator >	estimator ()

const Ptr< detail::Estimator >	estimator () const

Ptr< detail::ExposureCompensator >	exposureCompensator ()

const Ptr< detail::ExposureCompensator >	exposureCompensator () const

Ptr< Feature2D >	featuresFinder ()

Ptr< Feature2D >	featuresFinder () const

Ptr< detail::FeaturesMatcher >	featuresMatcher ()

Ptr< detail::FeaturesMatcher >	featuresMatcher () const

InterpolationFlags	interpolationFlags () const

const cv::UMat &	matchingMask () const

double	panoConfidenceThresh () const

double	registrationResol () const

UMat	resultMask () const
	パノラマのマスクを返す。

double	seamEstimationResol () const

Ptr< detail::SeamFinder >	seamFinder ()

const Ptr< detail::SeamFinder >	seamFinder () const

void	setBlender (Ptr< detail::Blender > b)

void	setBundleAdjuster (Ptr< detail::BundleAdjusterBase > bundle_adjuster)

void	setCompositingResol (double resol_mpx)

void	setEstimator (Ptr< detail::Estimator > estimator)

void	setExposureCompensator (Ptr< detail::ExposureCompensator > exposure_comp)

void	setFeaturesFinder (Ptr< Feature2D > features_finder)

void	setFeaturesMatcher (Ptr< detail::FeaturesMatcher > features_matcher)

void	setInterpolationFlags (InterpolationFlags interp_flags)

void	setMatchingMask (const cv::UMat &mask)

void	setPanoConfidenceThresh (double conf_thresh)

void	setRegistrationResol (double resol_mpx)

void	setSeamEstimationResol (double resol_mpx)

void	setSeamFinder (Ptr< detail::SeamFinder > seam_finder)

Status	setTransform (InputArrayOfArrays images, const std::vector< detail::CameraParams > &cameras)

Status	setTransform (InputArrayOfArrays images, const std::vector< detail::CameraParams > &cameras, const std::vector< int > &component)
	これらの関数は、Stitcher::cameras 呼び出しで取得できる各カメラのカメラ回転とカメラ内部パラメータを復元する。

void	setWarper (Ptr< WarperCreator > creator)

void	setWaveCorrection (bool flag)

void	setWaveCorrectKind (detail::WaveCorrectKind kind)

Status	stitch (InputArrayOfArrays images, InputArrayOfArrays masks, OutputArray pano)
	これらの関数は指定された画像をスティッチしようとする。

Status	stitch (InputArrayOfArrays images, OutputArray pano)

Ptr< WarperCreator >	warper ()

const Ptr< WarperCreator >	warper () const

bool	waveCorrection () const

detail::WaveCorrectKind	waveCorrectKind () const

double	workScale () const

静的公開メンバ関数
static Ptr< Stitcher >	create (Mode mode=Stitcher::PANORAMA)
	スティッチングモードのいずれかで設定された Stitcher を作成する。

静的公開変数類
static const double	ORIG_RESOL

詳細説明

高レベルな画像スティッチャー。

スティッチングパイプライン全体を把握していなくてもこのクラスを使用できる。ただし、より高いスティッチングの安定性と最終画像の品質を達成するには、少なくとも理論に精通していることが推奨される。

覚え書き

画像スティッチングの基本的な例は opencv_source_code/samples/cpp/stitching.cpp にある
Pythonでの画像スティッチングの基本的な例は opencv_source_code/samples/python/stitching.py にある
画像スティッチングの詳細な例は opencv_source_code/samples/cpp/stitching_detailed.cpp にある

列挙型メンバ詳解

◆ Mode

enum cv::Stitcher::Mode

列挙値

PANORAMA

写真パノラマを作成するためのモード。透視変換のもとにある画像を期待し、結果のパノラマを球面に投影する。

関連項目: detail::BestOf2NearestMatcher SphericalWarper

SCANS

スキャンを合成するためのモード。アフィン変換のもとにある画像を期待し、デフォルトでは露出を補償しない。

関連項目: detail::AffineBestOf2NearestMatcher AffineWarper

◆ Status

enum cv::Stitcher::Status

列挙値
OK
ERR_NEED_MORE_IMGS
ERR_HOMOGRAPHY_EST_FAIL
ERR_CAMERA_PARAMS_ADJUST_FAIL

メンバ関数詳解

◆ blender() [1/2]

Ptr< detail::Blender > cv::Stitcher::blender ( )

inline

◆ blender() [2/2]

const Ptr< detail::Blender > cv::Stitcher::blender ( ) const

inline

◆ bundleAdjuster() [1/2]

Ptr< detail::BundleAdjusterBase > cv::Stitcher::bundleAdjuster ( )

inline

◆ bundleAdjuster() [2/2]

const Ptr< detail::BundleAdjusterBase > cv::Stitcher::bundleAdjuster ( ) const

inline

◆ cameras()

std::vector< cv::detail::CameraParams > cv::Stitcher::cameras ( ) const

inline

Python:
	cv.Stitcher.cameras(		) ->	retval

スティッチングされたすべての画像について推定されたカメラパラメータを返す

◆ component()

std::vector< int > cv::Stitcher::component ( ) const

inline

Python:
	cv.Stitcher.component(		) ->	retval

パノラマスティッチングで使用された入力画像のインデックスを返す。

◆ composePanorama() [1/2]

Status cv::Stitcher::composePanorama	(	InputArrayOfArrays	images,
		OutputArray	pano )

Python:
	cv.Stitcher.composePanorama(	[, pano]	) ->	retval, pano
	cv.Stitcher.composePanorama(	images[, pano]	) ->	retval, pano

これらの関数は、画像変換が事前に推定されていることを前提として、指定された画像（または他の関数呼び出しで内部に保存された画像）を最終的なパノラマに合成しようとする。

覚え書き: スティッチングのパイプラインを理解している場合にのみこれらの関数を使用すること。そうでない場合は Stitcher::stitch を使用する。

引数

images	入力画像。
pano	最終的なパノラマ。

戻り値: ステータスコード。

◆ composePanorama() [2/2]

Status cv::Stitcher::composePanorama ( OutputArray pano )

Python:
	cv.Stitcher.composePanorama(	[, pano]	) ->	retval, pano
	cv.Stitcher.composePanorama(	images[, pano]	) ->	retval, pano

これは利便性のために提供されているオーバーロードされたメンバ関数である。上記の関数とは、受け取る引数のみが異なる。

◆ compositingResol()

double cv::Stitcher::compositingResol ( ) const

inline

Python:
	cv.Stitcher.compositingResol(		) ->	retval

◆ create()

static Ptr< Stitcher > cv::Stitcher::create ( Mode mode = Stitcher::PANORAMA )

static

Python:
	cv.Stitcher.create(	[, mode]	) ->	retval
	cv.Stitcher_create(	[, mode]	) ->	retval

いずれかのスティッチングモードで構成された Stitcher を作成する。

引数

mode	スティッチャー動作のシナリオ。これは通常、スティッチする画像のソースとその変換によって決まる。指定されたシナリオでの動作に対してデフォルト引数が選択される。

戻り値: Stitcher クラスのインスタンス。

◆ estimateTransform()

Status cv::Stitcher::estimateTransform	(	InputArrayOfArrays	images,
		InputArrayOfArrays	masks = noArray() )

Python:
	cv.Stitcher.estimateTransform(	images[, masks]	) ->	retval

これらの関数は、指定された画像をマッチングし、各カメラの回転を推定しようとする。

覚え書き: スティッチングのパイプラインを理解している場合にのみこれらの関数を使用すること。そうでない場合は Stitcher::stitch を使用する。

引数

images	入力画像。
masks	各入力画像について、キーポイントを探す場所を指定するマスク (省略可能)。

戻り値: ステータスコード。

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

◆ estimator() [1/2]

Ptr< detail::Estimator > cv::Stitcher::estimator ( )

inline

◆ estimator() [2/2]

const Ptr< detail::Estimator > cv::Stitcher::estimator ( ) const

inline

◆ exposureCompensator() [1/2]

Ptr< detail::ExposureCompensator > cv::Stitcher::exposureCompensator ( )

inline

◆ exposureCompensator() [2/2]

const Ptr< detail::ExposureCompensator > cv::Stitcher::exposureCompensator ( ) const

inline

◆ featuresFinder() [1/2]

Ptr< Feature2D > cv::Stitcher::featuresFinder ( )

inline

◆ featuresFinder() [2/2]

Ptr< Feature2D > cv::Stitcher::featuresFinder ( ) const

inline

◆ featuresMatcher() [1/2]

Ptr< detail::FeaturesMatcher > cv::Stitcher::featuresMatcher ( )

inline

◆ featuresMatcher() [2/2]

Ptr< detail::FeaturesMatcher > cv::Stitcher::featuresMatcher ( ) const

inline

◆ interpolationFlags()

InterpolationFlags cv::Stitcher::interpolationFlags ( ) const

inline

Python:
	cv.Stitcher.interpolationFlags(		) ->	retval

◆ matchingMask()

const cv::UMat & cv::Stitcher::matchingMask ( ) const

inline

◆ panoConfidenceThresh()

double cv::Stitcher::panoConfidenceThresh ( ) const

inline

Python:
	cv.Stitcher.panoConfidenceThresh(		) ->	retval

◆ registrationResol()

double cv::Stitcher::registrationResol ( ) const

inline

Python:
	cv.Stitcher.registrationResol(		) ->	retval

◆ resultMask()

UMat cv::Stitcher::resultMask ( ) const

inline

パノラマのマスクを返す。

マスクは次の値を持つ 8U の UMat である。入力画像で埋められたピクセルは 0xFF (白)、未使用のピクセルは 0 (黒)。インペイント用のマスクとして使用できる。

戻り値: マスク。

◆ seamEstimationResol()

double cv::Stitcher::seamEstimationResol ( ) const

inline

Python:
	cv.Stitcher.seamEstimationResol(		) ->	retval

◆ seamFinder() [1/2]

Ptr< detail::SeamFinder > cv::Stitcher::seamFinder ( )

inline

◆ seamFinder() [2/2]

const Ptr< detail::SeamFinder > cv::Stitcher::seamFinder ( ) const

inline

◆ setBlender()

void cv::Stitcher::setBlender ( Ptr< detail::Blender > b )

inline

◆ setBundleAdjuster()

void cv::Stitcher::setBundleAdjuster ( Ptr< detail::BundleAdjusterBase > bundle_adjuster )

inline

◆ setCompositingResol()

void cv::Stitcher::setCompositingResol ( double resol_mpx )

inline

Python:
	cv.Stitcher.setCompositingResol(	resol_mpx	) ->	None

◆ setEstimator()

void cv::Stitcher::setEstimator ( Ptr< detail::Estimator > estimator )

inline

◆ setExposureCompensator()

void cv::Stitcher::setExposureCompensator ( Ptr< detail::ExposureCompensator > exposure_comp )

inline

◆ setFeaturesFinder()

void cv::Stitcher::setFeaturesFinder ( Ptr< Feature2D > features_finder )

inline

◆ setFeaturesMatcher()

void cv::Stitcher::setFeaturesMatcher ( Ptr< detail::FeaturesMatcher > features_matcher )

inline

◆ setInterpolationFlags()

void cv::Stitcher::setInterpolationFlags ( InterpolationFlags interp_flags )

inline

Python:
	cv.Stitcher.setInterpolationFlags(	interp_flags	) ->	None

◆ setMatchingMask()

void cv::Stitcher::setMatchingMask ( const cv::UMat & mask )

inline

◆ setPanoConfidenceThresh()

void cv::Stitcher::setPanoConfidenceThresh ( double conf_thresh )

inline

Python:
	cv.Stitcher.setPanoConfidenceThresh(	conf_thresh	) ->	None

◆ setRegistrationResol()

void cv::Stitcher::setRegistrationResol ( double resol_mpx )

inline

Python:
	cv.Stitcher.setRegistrationResol(	resol_mpx	) ->	None

◆ setSeamEstimationResol()

void cv::Stitcher::setSeamEstimationResol ( double resol_mpx )

inline

Python:
	cv.Stitcher.setSeamEstimationResol(	resol_mpx	) ->	None

◆ setSeamFinder()

void cv::Stitcher::setSeamFinder ( Ptr< detail::SeamFinder > seam_finder )

inline

◆ setTransform() [1/2]

Status cv::Stitcher::setTransform	(	InputArrayOfArrays	images,
		const std::vector< detail::CameraParams > &	cameras )

これは利便性のために提供されているオーバーロードされたメンバ関数である。上記の関数とは、受け取る引数のみが異なる。

◆ setTransform() [2/2]

Status cv::Stitcher::setTransform	(	InputArrayOfArrays	images,
		const std::vector< detail::CameraParams > &	cameras,
		const std::vector< int > &	component )

これらの関数は、Stitcher::cameras 呼び出しで取得できる各カメラのカメラ回転とカメラ内部パラメータを復元する。

引数

images	入力画像。
cameras	各入力画像に対するカメラの推定された回転。
component	最終的なパノラマを構成する画像のインデックス (0始まり) (省略可能)。

戻り値: ステータスコード。

◆ setWarper()

void cv::Stitcher::setWarper ( Ptr< WarperCreator > creator )

inline

◆ setWaveCorrection()

void cv::Stitcher::setWaveCorrection ( bool flag )

inline

Python:
	cv.Stitcher.setWaveCorrection(	flag	) ->	None

◆ setWaveCorrectKind()

void cv::Stitcher::setWaveCorrectKind ( detail::WaveCorrectKind kind )

inline

◆ stitch() [1/2]

Status cv::Stitcher::stitch	(	InputArrayOfArrays	images,
		InputArrayOfArrays	masks,
		OutputArray	pano )

Python:
	cv.Stitcher.stitch(	images[, pano]	) ->	retval, pano
	cv.Stitcher.stitch(	images, masks[, pano]	) ->	retval, pano

これらの関数は、指定された画像をスティッチングしようとする。

引数

images	入力画像。
masks	各入力画像について、キーポイントを探す場所を指定するマスク (省略可能)。
pano	最終的なパノラマ。

戻り値: ステータスコード。

◆ stitch() [2/2]

Status cv::Stitcher::stitch	(	InputArrayOfArrays	images,
		OutputArray	pano )

Python:
	cv.Stitcher.stitch(	images[, pano]	) ->	retval, pano
	cv.Stitcher.stitch(	images, masks[, pano]	) ->	retval, pano

これは利便性のために提供されているオーバーロードされたメンバ関数である。上記の関数とは、受け取る引数のみが異なる。

◆ warper() [1/2]

Ptr< WarperCreator > cv::Stitcher::warper ( )

inline

◆ warper() [2/2]

const Ptr< WarperCreator > cv::Stitcher::warper ( ) const

inline

◆ waveCorrection()

bool cv::Stitcher::waveCorrection ( ) const

inline

Python:
	cv.Stitcher.waveCorrection(		) ->	retval

◆ waveCorrectKind()

detail::WaveCorrectKind cv::Stitcher::waveCorrectKind ( ) const

inline

◆ workScale()

double cv::Stitcher::workScale ( ) const

inline

Python:
	cv.Stitcher.workScale(		) ->	retval

メンバ変数詳解

◆ ORIG_RESOL

const double cv::Stitcher::ORIG_RESOL

static

スティッチングの解像度を設定する際、この値は元の解像度を保持するためのプレースホルダである。

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

opencv2/stitching.hpp

公開型

公開メンバ関数

静的公開メンバ関数

静的公開変数類

詳細説明

列挙型メンバ詳解

◆ Mode

◆ Status

メンバ関数詳解

◆ blender() [1/2]

◆ blender() [2/2]

◆ bundleAdjuster() [1/2]

◆ bundleAdjuster() [2/2]

◆ cameras()

◆ component()

◆ composePanorama() [1/2]

◆ composePanorama() [2/2]

◆ compositingResol()

◆ create()

◆ estimateTransform()

◆ estimator() [1/2]

◆ estimator() [2/2]

◆ exposureCompensator() [1/2]

◆ exposureCompensator() [2/2]

◆ featuresFinder() [1/2]

◆ featuresFinder() [2/2]

◆ featuresMatcher() [1/2]

◆ featuresMatcher() [2/2]

◆ interpolationFlags()

◆ matchingMask()

◆ panoConfidenceThresh()

◆ registrationResol()

◆ resultMask()

◆ seamEstimationResol()

◆ seamFinder() [1/2]

◆ seamFinder() [2/2]

◆ setBlender()

◆ setBundleAdjuster()

◆ setCompositingResol()

◆ setEstimator()

◆ setExposureCompensator()

◆ setFeaturesFinder()

◆ setFeaturesMatcher()

◆ setInterpolationFlags()

◆ setMatchingMask()

◆ setPanoConfidenceThresh()

◆ setRegistrationResol()

◆ setSeamEstimationResol()

◆ setSeamFinder()

◆ setTransform() [1/2]

◆ setTransform() [2/2]

◆ setWarper()

◆ setWaveCorrection()

◆ setWaveCorrectKind()

◆ stitch() [1/2]

◆ stitch() [2/2]

◆ warper() [1/2]

◆ warper() [2/2]

◆ waveCorrection()

◆ waveCorrectKind()

◆ workScale()

メンバ変数詳解

◆ ORIG_RESOL