High level image stitcher

It's possible to use this class without being aware of the entire stitching pipeline. However, to be able to achieve higher stitching stability and quality of the final images at least being familiar with the theory is recommended.

This figure illustrates the stitching module pipeline implemented in the cv.Stitcher class. Using that class it's possible to configure/remove some steps, i.e. adjust the stitching pipeline according to the particular needs.

The implemented stitching pipeline is very similar to the one proposed in [BL07].

Camera models

There are currently 2 camera models implemented in stitching pipeline.

Homography model expecting perspective transformations between images implemented in BestOf2NearestMatcher, HomographyBasedEstimator, BundleAdjusterReproj, and BundleAdjusterRay.
Affine model expecting affine transformation with 6 DOF or 4 DOF implemented in AffineBestOf2NearestMatcher, AffineBasedEstimator, BundleAdjusterAffine, BundleAdjusterAffinePartial, and AffineWarper.

Homography model is useful for creating photo panoramas captured by camera, while affine-based model can be used to stitch scans and object captured by specialized devices. Use cv.Stitcher.Stitcher to get preconfigured pipeline for one of those models.

Note: Certain detailed settings of cv.Stitcher might not make sense. Especially you should not mix classes implementing affine model and classes implementing Homography model, as they work with different transformations.

Example

A basic example on image stitching can be found in the stitching_demo.m sample
A detailed example on image stitching can be found in the stitching_detailed_demo.m sample.

References

[BL07]:

Matthew Brown and David G Lowe. "Automatic panoramic image stitching using invariant features". International journal of computer vision, 74(1):59-73, 2007.

Superclasses	handle
Sealed	false
Construct on load	false

CompositingResol	Compositing resolution. default 'Orig'
PanoConfidenceThresh	Panorama confidence threshold. default 1
RegistrationResol	Registration resolution. default 0.6
SeamEstimationResol	Seam estimation resolution. default 1
WaveCorrectKind	Correction kind. default 'Horiz'
WaveCorrection	Whether it should try to make panorama more horizontal (or vertical).
id	Object ID

	addlistener	Add listener for event.
	cameras	Estimates camera parameters
	component	Image indices
	composePanorama	Compose panorama
	delete	Destructor
	eq	== (EQ) Test handle equality.
	estimateTransform	Estimate transformation
	findobj	Find objects matching specified conditions.
	findprop	Find property of MATLAB handle object.
	ge	>= (GE) Greater than or equal relation for handles.
	getBlender	Get the blender
	getBundleAdjuster	Get the bundle adjuster
	getExposureCompensator	Get the exposire compensator
	getFeaturesFinder	Get the features finder
	getFeaturesMatcher	Get the features matcher
	getMatchingMask
	getSeamFinder	Get the seam finder
	getWarper	Get the warper
	gt	> (GT) Greater than relation for handles.
Sealed	isvalid	Test handle validity.
	le	<= (LE) Less than or equal relation for handles.
	listener	Add listener for event without binding the listener to the source object.
	lt	< (LT) Less than relation for handles.
	ne	~= (NE) Not equal relation for handles.
	notify	Notify listeners of event.
	setBlender	Set the blender
	setBundleAdjuster	Set the bundle adjuster
	setExposureCompensator	Set the exposure compensator
	setFeaturesFinder	Set the features finder
	setFeaturesMatcher	Set the features matcher
	setMatchingMask
	setSeamFinder	Set the seam finder
	setWarper	Set the image warper
	stitch	Tries to stitch the given images
	workScale	Work scale