opencv/modules/stitching/doc/warpers.rst

264 lines
7.8 KiB
ReStructuredText
Raw Normal View History

2012-01-19 17:43:13 +08:00
Images Warping
==============
.. highlight:: cpp
detail::RotationWarper
----------------------
.. ocv:class:: detail::RotationWarper
2012-01-26 20:44:32 +08:00
Rotation-only model image warper interface. ::
2012-01-19 17:43:13 +08:00
class CV_EXPORTS RotationWarper
{
public:
virtual ~RotationWarper() {}
virtual Point2f warpPoint(const Point2f &pt, InputArray K, InputArray R) = 0;
2012-01-19 17:43:13 +08:00
virtual Rect buildMaps(Size src_size, InputArray K, InputArray R, OutputArray xmap, OutputArray ymap) = 0;
2012-01-19 17:43:13 +08:00
virtual Point warp(InputArray src, InputArray K, InputArray R, int interp_mode, int border_mode,
OutputArray dst) = 0;
virtual void warpBackward(InputArray src, InputArray K, InputArray R, int interp_mode, int border_mode,
Size dst_size, OutputArray dst) = 0;
2012-01-19 17:43:13 +08:00
virtual Rect warpRoi(Size src_size, InputArray K, InputArray R) = 0;
2012-01-19 17:43:13 +08:00
};
2012-01-26 20:44:32 +08:00
detail::RotationWarper::warpPoint
---------------------------------
Projects the image point.
.. ocv:function:: Point2f detail::RotationWarper::warpPoint(const Point2f &pt, InputArray K, InputArray R)
2012-01-26 20:44:32 +08:00
:param pt: Source point
2012-01-26 20:44:32 +08:00
:param K: Camera intrinsic parameters
:param R: Camera rotation matrix
:return: Projected point
detail::RotationWarper::buildMaps
---------------------------------
Builds the projection maps according to the given camera data.
.. ocv:function:: Rect detail::RotationWarper::buildMaps(Size src_size, InputArray K, InputArray R, OutputArray xmap, OutputArray ymap)
2012-01-26 20:44:32 +08:00
:param src_size: Source image size
2012-01-26 20:44:32 +08:00
:param K: Camera intrinsic parameters
:param R: Camera rotation matrix
:param xmap: Projection map for the x axis
:param ymap: Projection map for the y axis
:return: Projected image minimum bounding box
detail::RotationWarper::warp
----------------------------
Projects the image.
.. ocv:function:: Point detail::RotationWarper::warp(InputArray src, InputArray K, InputArray R, int interp_mode, int border_mode, OutputArray dst)
2012-01-26 20:44:32 +08:00
:param src: Source image
2012-01-26 20:44:32 +08:00
:param K: Camera intrinsic parameters
:param R: Camera rotation matrix
:param interp_mode: Interpolation mode
:param border_mode: Border extrapolation mode
:param dst: Projected image
:return: Project image top-left corner
detail::RotationWarper::warpBackward
------------------------------------
Projects the image backward.
.. ocv:function:: void detail::RotationWarper::warpBackward(InputArray src, InputArray K, InputArray R, int interp_mode, int border_mode, Size dst_size, OutputArray dst)
2012-01-26 20:44:32 +08:00
:param src: Projected image
:param K: Camera intrinsic parameters
:param R: Camera rotation matrix
:param interp_mode: Interpolation mode
:param border_mode: Border extrapolation mode
:param dst_size: Backward-projected image size
:param dst: Backward-projected image
2012-01-26 20:44:32 +08:00
detail::RotationWarper::warpRoi
-------------------------------
.. ocv:function:: Rect detail::RotationWarper::warpRoi(Size src_size, InputArray K, InputArray R)
2012-01-26 20:44:32 +08:00
:param src_size: Source image bounding box
2012-01-26 20:44:32 +08:00
:param K: Camera intrinsic parameters
:param R: Camera rotation matrix
:return: Projected image minimum bounding box
detail::ProjectorBase
---------------------
.. ocv:struct:: detail::ProjectorBase
Base class for warping logic implementation. ::
struct CV_EXPORTS ProjectorBase
{
void setCameraParams(InputArray K = Mat::eye(3, 3, CV_32F),
InputArray R = Mat::eye(3, 3, CV_32F),
InputArray T = Mat::zeros(3, 1, CV_32F));
2012-01-26 20:44:32 +08:00
float scale;
float k[9];
float rinv[9];
float r_kinv[9];
float k_rinv[9];
float t[3];
};
detail::RotationWarperBase
--------------------------
.. ocv:class:: detail::RotationWarperBase
Base class for rotation-based warper using a `detail::ProjectorBase`_ derived class. ::
template <class P>
class CV_EXPORTS RotationWarperBase : public RotationWarper
{
2012-01-26 20:44:32 +08:00
public:
Point2f warpPoint(const Point2f &pt, InputArray K, InputArray R);
Rect buildMaps(Size src_size, InputArray K, InputArray R, OutputArray xmap, OutputArray ymap);
2012-01-26 20:44:32 +08:00
Point warp(InputArray src, InputArray K, InputArray R, int interp_mode, int border_mode,
OutputArray dst);
2012-01-26 20:44:32 +08:00
void warpBackward(InputArray src, InputArray K, InputArray R, int interp_mode, int border_mode,
Size dst_size, OutputArray dst);
2012-01-26 20:44:32 +08:00
Rect warpRoi(Size src_size, InputArray K, InputArray R);
2012-01-26 20:44:32 +08:00
protected:
// Detects ROI of the destination image. It's correct for any projection.
virtual void detectResultRoi(Size src_size, Point &dst_tl, Point &dst_br);
// Detects ROI of the destination image by walking over image border.
// Correctness for any projection isn't guaranteed.
void detectResultRoiByBorder(Size src_size, Point &dst_tl, Point &dst_br);
P projector_;
};
2012-01-19 17:43:13 +08:00
detail::PlaneWarper
-------------------
.. ocv:class:: detail::PlaneWarper : public detail::RotationWarperBase<PlaneProjector>
2012-01-19 17:43:13 +08:00
Warper that maps an image onto the z = 1 plane. ::
class CV_EXPORTS PlaneWarper : public RotationWarperBase<PlaneProjector>
{
public:
PlaneWarper(float scale = 1.f) { projector_.scale = scale; }
void setScale(float scale) { projector_.scale = scale; }
Point2f warpPoint(const Point2f &pt, InputArray K, InputArray R, InputArray T);
2012-01-19 17:43:13 +08:00
Rect buildMaps(Size src_size, InputArray K, InputArray R, InputArray T, OutputArray xmap, OutputArray ymap);
2012-01-19 17:43:13 +08:00
Point warp(InputArray src, InputArray K, InputArray R, InputArray T, int interp_mode, int border_mode,
OutputArray dst);
2012-01-19 17:43:13 +08:00
Rect warpRoi(Size src_size, InputArray K, InputArray R, InputArray T);
2012-01-19 17:43:13 +08:00
protected:
void detectResultRoi(Size src_size, Point &dst_tl, Point &dst_br);
};
.. seealso:: :ocv:class:`detail::RotationWarper`
2012-01-27 15:40:23 +08:00
detail::PlaneWarper::PlaneWarper
--------------------------------
Construct an instance of the plane warper class.
.. ocv:function:: void detail::PlaneWarper::PlaneWarper(float scale = 1.f)
:param scale: Projected image scale multiplier
2012-01-19 17:43:13 +08:00
detail::SphericalWarper
-----------------------
.. ocv:class:: detail::SphericalWarper : public detail::RotationWarperBase<SphericalProjector>
2012-01-19 17:43:13 +08:00
Warper that maps an image onto the unit sphere located at the origin. ::
class CV_EXPORTS SphericalWarper : public RotationWarperBase<SphericalProjector>
{
public:
SphericalWarper(float scale) { projector_.scale = scale; }
protected:
void detectResultRoi(Size src_size, Point &dst_tl, Point &dst_br);
};
.. seealso:: :ocv:class:`detail::RotationWarper`
2012-01-27 15:40:23 +08:00
detail::SphericalWarper::SphericalWarper
----------------------------------------
Construct an instance of the spherical warper class.
.. ocv:function:: void detail::SphericalWarper::SphericalWarper(float scale)
:param scale: Projected image scale multiplier
2012-01-19 17:43:13 +08:00
detail::CylindricalWarper
-------------------------
.. ocv:class:: detail::CylindricalWarper : public detail::RotationWarperBase<CylindricalProjector>
2012-01-19 17:43:13 +08:00
Warper that maps an image onto the x*x + z*z = 1 cylinder. ::
2012-01-19 17:43:13 +08:00
class CV_EXPORTS CylindricalWarper : public RotationWarperBase<CylindricalProjector>
{
public:
CylindricalWarper(float scale) { projector_.scale = scale; }
protected:
void detectResultRoi(Size src_size, Point &dst_tl, Point &dst_br)
{
RotationWarperBase<CylindricalProjector>::detectResultRoiByBorder(src_size, dst_tl, dst_br);
2012-01-19 17:43:13 +08:00
}
};
.. seealso:: :ocv:class:`detail::RotationWarper`
2012-01-27 15:40:23 +08:00
detail::CylindricalWarper::CylindricalWarper
--------------------------------------------
Construct an instance of the cylindrical warper class.
.. ocv:function:: void detail::CylindricalWarper::CylindricalWarper(float scale)
2013-08-21 21:26:54 +08:00
:param scale: Projected image scale multiplier