org.bytedeco.opencv.opencv_stitching

Class Stitcher

java.lang.Object

org.bytedeco.javacpp.Pointer

org.bytedeco.opencv.opencv_stitching.Stitcher

All Implemented Interfaces:

AutoCloseable

@Namespace(value="cv")
 @Properties(inherit=opencv_stitching.class)
public class Stitcher
extends Pointer

\brief 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.

\note - A basic example on image stitching can be found at opencv_source_code/samples/cpp/stitching.cpp - A basic example on image stitching in Python can be found at opencv_source_code/samples/python/stitching.py - A detailed example on image stitching can be found at opencv_source_code/samples/cpp/stitching_detailed.cpp

Nested Class Summary

Nested classes/interfaces inherited from class org.bytedeco.javacpp.Pointer

Pointer.CustomDeallocator, Pointer.Deallocator, Pointer.NativeDeallocator, Pointer.ReferenceCounter

Field Summary

Fields

Modifier and Type	Field and Description
static int	ERR_CAMERA_PARAMS_ADJUST_FAIL enum cv::Stitcher::Status
static int	ERR_HOMOGRAPHY_EST_FAIL enum cv::Stitcher::Status
static int	ERR_NEED_MORE_IMGS enum cv::Stitcher::Status
static int	OK enum cv::Stitcher::Status
static double	ORIG_RESOL
static int	PANORAMA enum cv::Stitcher::Mode
static int	SCANS enum cv::Stitcher::Mode

Fields inherited from class org.bytedeco.javacpp.Pointer

address, capacity, limit, position

Constructor Summary

Constructors

Constructor and Description
Stitcher() Default native constructor.
Stitcher(long size) Native array allocator.
Stitcher(Pointer p) Pointer cast constructor.

Method Summary

Modifier and Type	Method and Description
Blender	blender()
BundleAdjusterBase	bundleAdjuster()
CameraParams	cameras()
IntPointer	component()
int	composePanorama(GpuMat pano)
int	composePanorama(GpuMatVector images, GpuMat pano)
int	composePanorama(GpuMatVector images, Mat pano)
int	composePanorama(GpuMatVector images, UMat pano)
int	composePanorama(Mat pano) \overload
int	composePanorama(MatVector images, GpuMat pano)
int	composePanorama(MatVector images, Mat pano) \brief These functions try to compose the given images (or images stored internally from the other function calls) into the final pano under the assumption that the image transformations were estimated before.
int	composePanorama(MatVector images, UMat pano)
int	composePanorama(UMat pano)
int	composePanorama(UMatVector images, GpuMat pano)
int	composePanorama(UMatVector images, Mat pano)
int	composePanorama(UMatVector images, UMat pano)
double	compositingResol()
static Stitcher	create()
static Stitcher	create(int mode) \brief Creates a Stitcher configured in one of the stitching modes.
int	estimateTransform(GpuMatVector images)
int	estimateTransform(GpuMatVector images, GpuMatVector masks)
int	estimateTransform(MatVector images)
int	estimateTransform(MatVector images, MatVector masks) \brief These functions try to match the given images and to estimate rotations of each camera.
int	estimateTransform(UMatVector images)
int	estimateTransform(UMatVector images, UMatVector masks)
Estimator	estimator()
ExposureCompensator	exposureCompensator()
Feature2D	featuresFinder()
FeaturesMatcher	featuresMatcher()
int	interpolationFlags()
UMat	matchingMask()
static double	ORIG_RESOL() When setting a resolution for stitching, this values is a placeholder for preserving the original resolution.
double	panoConfidenceThresh()
Stitcher	position(long position)
double	registrationResol()
UMat	resultMask()
double	seamEstimationResol()
SeamFinder	seamFinder()
void	setBlender(Blender b)
void	setBundleAdjuster(BundleAdjusterBase bundle_adjuster)
void	setCompositingResol(double resol_mpx)
void	setEstimator(Estimator estimator)
void	setExposureCompensator(ExposureCompensator exposure_comp)
void	setFeaturesFinder(Feature2D features_finder)
void	setFeaturesMatcher(FeaturesMatcher features_matcher)
void	setInterpolationFlags(int interp_flags)
void	setMatchingMask(UMat mask)
void	setPanoConfidenceThresh(double conf_thresh)
void	setRegistrationResol(double resol_mpx)
void	setSeamEstimationResol(double resol_mpx)
void	setSeamFinder(SeamFinder seam_finder)
void	setWarper(WarperCreator creator)
void	setWaveCorrection(boolean flag)
void	setWaveCorrectKind(int kind)
int	stitch(GpuMatVector images, GpuMat pano)
int	stitch(GpuMatVector images, GpuMatVector masks, GpuMat pano)
int	stitch(GpuMatVector images, GpuMatVector masks, Mat pano)
int	stitch(GpuMatVector images, GpuMatVector masks, UMat pano)
int	stitch(GpuMatVector images, Mat pano)
int	stitch(GpuMatVector images, UMat pano)
int	stitch(MatVector images, GpuMat pano)
int	stitch(MatVector images, Mat pano) \overload
int	stitch(MatVector images, MatVector masks, GpuMat pano)
int	stitch(MatVector images, MatVector masks, Mat pano) \brief These functions try to stitch the given images.
int	stitch(MatVector images, MatVector masks, UMat pano)
int	stitch(MatVector images, UMat pano)
int	stitch(UMatVector images, GpuMat pano)
int	stitch(UMatVector images, Mat pano)
int	stitch(UMatVector images, UMat pano)
int	stitch(UMatVector images, UMatVector masks, GpuMat pano)
int	stitch(UMatVector images, UMatVector masks, Mat pano)
int	stitch(UMatVector images, UMatVector masks, UMat pano)
WarperCreator	warper()
boolean	waveCorrection()
int	waveCorrectKind()
double	workScale()

Methods inherited from class org.bytedeco.javacpp.Pointer

address, asBuffer, asByteBuffer, availablePhysicalBytes, calloc, capacity, capacity, close, deallocate, deallocate, deallocateReferences, deallocator, deallocator, equals, fill, formatBytes, free, hashCode, isNull, isNull, limit, limit, malloc, maxBytes, maxPhysicalBytes, memchr, memcmp, memcpy, memmove, memset, offsetof, parseBytes, physicalBytes, position, put, realloc, referenceCount, releaseReference, retainReference, setNull, sizeof, toString, totalBytes, totalPhysicalBytes, withDeallocator, zero

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

ORIG_RESOL

public static final double ORIG_RESOL

OK

public static final int OK

enum cv::Stitcher::Status

See Also:

Constant Field Values

ERR_NEED_MORE_IMGS

public static final int ERR_NEED_MORE_IMGS

enum cv::Stitcher::Status

See Also:

Constant Field Values

ERR_HOMOGRAPHY_EST_FAIL

public static final int ERR_HOMOGRAPHY_EST_FAIL

enum cv::Stitcher::Status

See Also:

Constant Field Values

ERR_CAMERA_PARAMS_ADJUST_FAIL

public static final int ERR_CAMERA_PARAMS_ADJUST_FAIL

enum cv::Stitcher::Status

See Also:

Constant Field Values

PANORAMA

public static final int PANORAMA

enum cv::Stitcher::Mode

See Also:

Constant Field Values

SCANS

public static final int SCANS

enum cv::Stitcher::Mode

See Also:

Constant Field Values

Constructor Detail

Stitcher

public Stitcher()

Default native constructor.

Stitcher

public Stitcher(long size)

Native array allocator. Access with Pointer.position(long).

Stitcher

public Stitcher(Pointer p)

Pointer cast constructor. Invokes Pointer.Pointer(Pointer).

Method Detail

position

public Stitcher position(long position)

Overrides:

position in class Pointer

ORIG_RESOL

@MemberGetter
public static double ORIG_RESOL()

When setting a resolution for stitching, this values is a placeholder for preserving the original resolution.

create

@opencv_core.Ptr
public static Stitcher create(@Cast(value="cv::Stitcher::Mode")
                                               int mode)

\brief Creates a Stitcher configured in one of the stitching modes.

Parameters:

mode - Scenario for stitcher operation. This is usually determined by source of images to stitch and their transformation. Default parameters will be chosen for operation in given scenario.

Returns:

Stitcher class instance.

create

@opencv_core.Ptr
public static Stitcher create()

registrationResol

public double registrationResol()

setRegistrationResol

public void setRegistrationResol(double resol_mpx)

seamEstimationResol

public double seamEstimationResol()

setSeamEstimationResol

public void setSeamEstimationResol(double resol_mpx)

compositingResol

public double compositingResol()

setCompositingResol

public void setCompositingResol(double resol_mpx)

panoConfidenceThresh

public double panoConfidenceThresh()

setPanoConfidenceThresh

public void setPanoConfidenceThresh(double conf_thresh)

waveCorrection

@Cast(value="bool")
public boolean waveCorrection()

setWaveCorrection

public void setWaveCorrection(@Cast(value="bool")
                              boolean flag)

interpolationFlags

@Cast(value="cv::InterpolationFlags")
public int interpolationFlags()

setInterpolationFlags

public void setInterpolationFlags(@Cast(value="cv::InterpolationFlags")
                                  int interp_flags)

waveCorrectKind

@Cast(value="cv::detail::WaveCorrectKind")
public int waveCorrectKind()

setWaveCorrectKind

public void setWaveCorrectKind(@Cast(value="cv::detail::WaveCorrectKind")
                               int kind)

featuresFinder

@opencv_core.Ptr
public Feature2D featuresFinder()

setFeaturesFinder

public void setFeaturesFinder(@opencv_core.Ptr
                              Feature2D features_finder)

featuresMatcher

@opencv_core.Ptr
public FeaturesMatcher featuresMatcher()

setFeaturesMatcher

public void setFeaturesMatcher(@opencv_core.Ptr
                               FeaturesMatcher features_matcher)

matchingMask

@Const
 @ByRef
public UMat matchingMask()

setMatchingMask

public void setMatchingMask(@Const @ByRef
                            UMat mask)

bundleAdjuster

@opencv_core.Ptr
public BundleAdjusterBase bundleAdjuster()

setBundleAdjuster

public void setBundleAdjuster(@opencv_core.Ptr
                              BundleAdjusterBase bundle_adjuster)

estimator

@opencv_core.Ptr
public Estimator estimator()

setEstimator

public void setEstimator(@opencv_core.Ptr
                         Estimator estimator)

warper

@opencv_core.Ptr
public WarperCreator warper()

setWarper

public void setWarper(@opencv_core.Ptr
                      WarperCreator creator)

exposureCompensator

@opencv_core.Ptr
public ExposureCompensator exposureCompensator()

setExposureCompensator

public void setExposureCompensator(@opencv_core.Ptr
                                   ExposureCompensator exposure_comp)

seamFinder

@opencv_core.Ptr
public SeamFinder seamFinder()

setSeamFinder

public void setSeamFinder(@opencv_core.Ptr
                          SeamFinder seam_finder)

blender

@opencv_core.Ptr
public Blender blender()

setBlender

public void setBlender(@opencv_core.Ptr
                       Blender b)

estimateTransform

@Cast(value="cv::Stitcher::Status")
public int estimateTransform(@ByVal
                                                                 MatVector images,
                                                                 @ByVal(nullValue="cv::InputArrayOfArrays(cv::noArray())")
                                                                 MatVector masks)

\brief These functions try to match the given images and to estimate rotations of each camera.

\note Use the functions only if you're aware of the stitching pipeline, otherwise use Stitcher::stitch.

Parameters:

images - Input images.

masks - Masks for each input image specifying where to look for keypoints (optional).

Returns:

Status code.

estimateTransform

@Cast(value="cv::Stitcher::Status")
public int estimateTransform(@ByVal
                                                                 MatVector images)

estimateTransform

@Cast(value="cv::Stitcher::Status")
public int estimateTransform(@ByVal
                                                                 UMatVector images,
                                                                 @ByVal(nullValue="cv::InputArrayOfArrays(cv::noArray())")
                                                                 UMatVector masks)

estimateTransform

@Cast(value="cv::Stitcher::Status")
public int estimateTransform(@ByVal
                                                                 UMatVector images)

estimateTransform

@Cast(value="cv::Stitcher::Status")
public int estimateTransform(@ByVal
                                                                 GpuMatVector images,
                                                                 @ByVal(nullValue="cv::InputArrayOfArrays(cv::noArray())")
                                                                 GpuMatVector masks)

estimateTransform

@Cast(value="cv::Stitcher::Status")
public int estimateTransform(@ByVal
                                                                 GpuMatVector images)

composePanorama

@Cast(value="cv::Stitcher::Status")
public int composePanorama(@ByVal
                                                               Mat pano)

\overload

composePanorama

@Cast(value="cv::Stitcher::Status")
public int composePanorama(@ByVal
                                                               UMat pano)

composePanorama

@Cast(value="cv::Stitcher::Status")
public int composePanorama(@ByVal
                                                               GpuMat pano)

composePanorama

@Cast(value="cv::Stitcher::Status")
public int composePanorama(@ByVal
                                                               MatVector images,
                                                               @ByVal
                                                               Mat pano)

\brief These functions try to compose the given images (or images stored internally from the other function calls) into the final pano under the assumption that the image transformations were estimated before.

\note Use the functions only if you're aware of the stitching pipeline, otherwise use Stitcher::stitch.

Parameters:

images - Input images.

pano - Final pano.

Returns:

Status code.

composePanorama

@Cast(value="cv::Stitcher::Status")
public int composePanorama(@ByVal
                                                               UMatVector images,
                                                               @ByVal
                                                               Mat pano)

composePanorama

@Cast(value="cv::Stitcher::Status")
public int composePanorama(@ByVal
                                                               GpuMatVector images,
                                                               @ByVal
                                                               Mat pano)

composePanorama

@Cast(value="cv::Stitcher::Status")
public int composePanorama(@ByVal
                                                               MatVector images,
                                                               @ByVal
                                                               UMat pano)

composePanorama

@Cast(value="cv::Stitcher::Status")
public int composePanorama(@ByVal
                                                               UMatVector images,
                                                               @ByVal
                                                               UMat pano)

composePanorama

@Cast(value="cv::Stitcher::Status")
public int composePanorama(@ByVal
                                                               GpuMatVector images,
                                                               @ByVal
                                                               UMat pano)

composePanorama

@Cast(value="cv::Stitcher::Status")
public int composePanorama(@ByVal
                                                               MatVector images,
                                                               @ByVal
                                                               GpuMat pano)

composePanorama

@Cast(value="cv::Stitcher::Status")
public int composePanorama(@ByVal
                                                               UMatVector images,
                                                               @ByVal
                                                               GpuMat pano)

composePanorama

@Cast(value="cv::Stitcher::Status")
public int composePanorama(@ByVal
                                                               GpuMatVector images,
                                                               @ByVal
                                                               GpuMat pano)

stitch

@Cast(value="cv::Stitcher::Status")
public int stitch(@ByVal
                                                      MatVector images,
                                                      @ByVal
                                                      Mat pano)

\overload

stitch

@Cast(value="cv::Stitcher::Status")
public int stitch(@ByVal
                                                      UMatVector images,
                                                      @ByVal
                                                      Mat pano)

stitch

@Cast(value="cv::Stitcher::Status")
public int stitch(@ByVal
                                                      GpuMatVector images,
                                                      @ByVal
                                                      Mat pano)

stitch

@Cast(value="cv::Stitcher::Status")
public int stitch(@ByVal
                                                      MatVector images,
                                                      @ByVal
                                                      UMat pano)

stitch

@Cast(value="cv::Stitcher::Status")
public int stitch(@ByVal
                                                      UMatVector images,
                                                      @ByVal
                                                      UMat pano)

stitch

@Cast(value="cv::Stitcher::Status")
public int stitch(@ByVal
                                                      GpuMatVector images,
                                                      @ByVal
                                                      UMat pano)

stitch

@Cast(value="cv::Stitcher::Status")
public int stitch(@ByVal
                                                      MatVector images,
                                                      @ByVal
                                                      GpuMat pano)

stitch

@Cast(value="cv::Stitcher::Status")
public int stitch(@ByVal
                                                      UMatVector images,
                                                      @ByVal
                                                      GpuMat pano)

stitch

@Cast(value="cv::Stitcher::Status")
public int stitch(@ByVal
                                                      GpuMatVector images,
                                                      @ByVal
                                                      GpuMat pano)

stitch

@Cast(value="cv::Stitcher::Status")
public int stitch(@ByVal
                                                      MatVector images,
                                                      @ByVal
                                                      MatVector masks,
                                                      @ByVal
                                                      Mat pano)

\brief These functions try to stitch the given images.

Parameters:

images - Input images.

masks - Masks for each input image specifying where to look for keypoints (optional).

pano - Final pano.

Returns:

Status code.

stitch

@Cast(value="cv::Stitcher::Status")
public int stitch(@ByVal
                                                      UMatVector images,
                                                      @ByVal
                                                      UMatVector masks,
                                                      @ByVal
                                                      Mat pano)

stitch

@Cast(value="cv::Stitcher::Status")
public int stitch(@ByVal
                                                      GpuMatVector images,
                                                      @ByVal
                                                      GpuMatVector masks,
                                                      @ByVal
                                                      Mat pano)

stitch

@Cast(value="cv::Stitcher::Status")
public int stitch(@ByVal
                                                      MatVector images,
                                                      @ByVal
                                                      MatVector masks,
                                                      @ByVal
                                                      UMat pano)

stitch

@Cast(value="cv::Stitcher::Status")
public int stitch(@ByVal
                                                      UMatVector images,
                                                      @ByVal
                                                      UMatVector masks,
                                                      @ByVal
                                                      UMat pano)

stitch

@Cast(value="cv::Stitcher::Status")
public int stitch(@ByVal
                                                      GpuMatVector images,
                                                      @ByVal
                                                      GpuMatVector masks,
                                                      @ByVal
                                                      UMat pano)

stitch

@Cast(value="cv::Stitcher::Status")
public int stitch(@ByVal
                                                      MatVector images,
                                                      @ByVal
                                                      MatVector masks,
                                                      @ByVal
                                                      GpuMat pano)

stitch

@Cast(value="cv::Stitcher::Status")
public int stitch(@ByVal
                                                      UMatVector images,
                                                      @ByVal
                                                      UMatVector masks,
                                                      @ByVal
                                                      GpuMat pano)

stitch

@Cast(value="cv::Stitcher::Status")
public int stitch(@ByVal
                                                      GpuMatVector images,
                                                      @ByVal
                                                      GpuMatVector masks,
                                                      @ByVal
                                                      GpuMat pano)

component

@StdVector
public IntPointer component()

cameras

@StdVector
public CameraParams cameras()

workScale

public double workScale()

resultMask

@ByVal
public UMat resultMask()