opencv/modules/stitching/doc/blenders.rst

116 lines
3.1 KiB
ReStructuredText

Image Blenders
==============
.. highlight:: cpp
detail::Blender
---------------
.. ocv:class:: detail::Blender
Base class for all blenders. ::
class CV_EXPORTS Blender
{
public:
virtual ~Blender() {}
enum { NO, FEATHER, MULTI_BAND };
static Ptr<Blender> createDefault(int type, bool try_gpu = false);
void prepare(const std::vector<Point> &corners, const std::vector<Size> &sizes);
virtual void prepare(Rect dst_roi);
virtual void feed(const Mat &img, const Mat &mask, Point tl);
virtual void blend(Mat &dst, Mat &dst_mask);
protected:
Mat dst_, dst_mask_;
Rect dst_roi_;
};
detail::Blender::prepare
------------------------
Prepares the blender for blending.
.. ocv:function:: void detail::Blender::prepare(const std::vector<Point> &corners, const std::vector<Size> &sizes)
:param corners: Source images top-left corners
:param sizes: Source image sizes
detail::Blender::feed
---------------------
Processes the image.
.. ocv:function:: void detail::Blender::feed(const Mat &img, const Mat &mask, Point tl)
:param img: Source image
:param mask: Source image mask
:param tl: Source image top-left corners
detail::Blender::blend
----------------------
Blends and returns the final pano.
.. ocv:function:: void detail::Blender::blend(Mat &dst, Mat &dst_mask)
:param dst: Final pano
:param dst_mask: Final pano mask
detail::FeatherBlender
----------------------
.. ocv:class:: detail::FeatherBlender : public detail::Blender
Simple blender which mixes images at its borders. ::
class CV_EXPORTS FeatherBlender : public Blender
{
public:
FeatherBlender(float sharpness = 0.02f) { setSharpness(sharpness); }
float sharpness() const { return sharpness_; }
void setSharpness(float val) { sharpness_ = val; }
void prepare(Rect dst_roi);
void feed(const Mat &img, const Mat &mask, Point tl);
void blend(Mat &dst, Mat &dst_mask);
// Creates weight maps for fixed set of source images by their masks and top-left corners.
// Final image can be obtained by simple weighting of the source images.
Rect createWeightMaps(const std::vector<Mat> &masks, const std::vector<Point> &corners,
std::vector<Mat> &weight_maps);
private:
/* hidden */
};
.. seealso:: :ocv:class:`detail::Blender`
detail::MultiBandBlender
------------------------
.. ocv:class:: detail::MultiBandBlender : public detail::Blender
Blender which uses multi-band blending algorithm (see [BA83]_). ::
class CV_EXPORTS MultiBandBlender : public Blender
{
public:
MultiBandBlender(int try_gpu = false, int num_bands = 5);
int numBands() const { return actual_num_bands_; }
void setNumBands(int val) { actual_num_bands_ = val; }
void prepare(Rect dst_roi);
void feed(const Mat &img, const Mat &mask, Point tl);
void blend(Mat &dst, Mat &dst_mask);
private:
/* hidden */
};
.. seealso:: :ocv:class:`detail::Blender`