From 13bbc9ff71b7c9660517ee7d7103e6da477c85eb Mon Sep 17 00:00:00 2001 From: Ana Huaman <no@email> Date: Thu, 30 Jun 2011 13:42:46 +0000 Subject: [PATCH] Added Affine Transformation tutorial in reST --- doc/conf.py | 3 +- .../images/Warp_Affine_Tutorial_Theory_0.jpg | Bin 0 -> 19875 bytes .../imgtrans/warp_affine/warp_affine.rst | 216 +++++++++++++++++- 3 files changed, 206 insertions(+), 13 deletions(-) create mode 100644 doc/tutorials/imgproc/imgtrans/warp_affine/images/Warp_Affine_Tutorial_Theory_0.jpg diff --git a/doc/conf.py b/doc/conf.py index 561d9ae5b..620a75f73 100644 --- a/doc/conf.py +++ b/doc/conf.py @@ -319,7 +319,8 @@ extlinks = {'cvt_color': ('http://opencv.willowgarage.com/documentation/cpp/imgp 'hough_circles' : ('http://opencv.willowgarage.com/documentation/cpp/imgproc_feature_detection.html?#cv-houghcircles%s', None), 'remap' : ('http://opencv.willowgarage.com/documentation/cpp/imgproc_geometric_image_transformations.html?#remap%s', None), 'warp_affine' : ('http://opencv.willowgarage.com/documentation/cpp/imgproc_geometric_image_transformations.html?#cv-warpaffine%s' , None), - 'get_rotation_matrix_2d' : ('http://opencv.willowgarage.com/documentation/cpp/imgproc_geometric_image_transformations.html?#cv-getrotationmatrix2d%s', None) + 'get_rotation_matrix_2d' : ('http://opencv.willowgarage.com/documentation/cpp/imgproc_geometric_image_transformations.html?#cv-getrotationmatrix2d%s', None), + 'get_affine_transform' : ('http://opencv.willowgarage.com/documentation/cpp/imgproc_geometric_image_transformations.html?#cv-getaffinetransform%s', None) } diff --git a/doc/tutorials/imgproc/imgtrans/warp_affine/images/Warp_Affine_Tutorial_Theory_0.jpg b/doc/tutorials/imgproc/imgtrans/warp_affine/images/Warp_Affine_Tutorial_Theory_0.jpg new file mode 100644 index 0000000000000000000000000000000000000000..dd6a46a33a0e448141de8fe199ba82f6425c80df GIT binary patch literal 19875 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 aK|4nGKZe-f=j(4w?8o@U{}#Jt_4OYJ0M0c4 literal 0 HcmV?d00001 diff --git a/doc/tutorials/imgproc/imgtrans/warp_affine/warp_affine.rst b/doc/tutorials/imgproc/imgtrans/warp_affine/warp_affine.rst index b4c75d58d..774ef281e 100644 --- a/doc/tutorials/imgproc/imgtrans/warp_affine/warp_affine.rst +++ b/doc/tutorials/imgproc/imgtrans/warp_affine/warp_affine.rst @@ -16,9 +16,85 @@ b. Use the OpenCV function :get_rotation_matrix_2d:`getRotationMatrix2D <>` to o Theory ====== +What is an Affine Transformation? +---------------------------------- + +#. It is any transformation that can be expressed in the form of a *matrix multiplication* (linear transformation) followed by a *vector addition* (translation). + +#. From the above, We can use an Affine Transformation to express: + + a. Rotations (linear transformation) + b. Translations (vector addition) + c. Scale operations (linear transformation) + + you can see that, in essence, an Affine Transformation represents a **relation** between two images. + +#. The usual way to represent an Affine Transform is by using a :math:`2 \times 3` matrix. + + .. math:: + + A = \begin{bmatrix} + a_{00} & a_{01} \\ + a_{10} & a_{11} + \end{bmatrix}_{2 \times 2} + B = \begin{bmatrix} + b_{00} \\ + b_{10} + \end{bmatrix}_{2 \times 1} + + M = \begin{bmatrix} + A & B + \end{bmatrix} + = + \begin{bmatrix} + a_{00} & a_{01} & b_{00} \\ + a_{10} & a_{11} & b_{10} + \end{bmatrix}_{2 \times 3} + + Considering that we want to transform a 2D vector :math:`X = \begin{bmatrix}x \\ y\end{bmatrix}` by using :math:`A` and :math:`B`, we can do it equivalently with: + + + :math:`T = A \cdot \begin{bmatrix}x \\ y\end{bmatrix} + B` or :math:`T = M \cdot [x, y, 1]^{T}` + + .. math:: + + T = \begin{bmatrix} + a_{00}x + a_{01}y + b_{00} \\ + a_{10}x + a_{11}y + b_{10} + \end{bmatrix} + + +How do we get an Affine Transformation? +--------------------------------------- + +1. Excellent question. We mentioned that an Affine Transformation is basically a **relation** between two images. The information about this relation can come, roughly, in two ways: + + a. We know both :math:`X` and `T` and we also know that they are related. Then our job is to find :math:`M` + + b. We know :math:`M` and :math:'X`. To obtain :math:`T` we only need to apply :math:`T = M \cdot X`. Our information for :math:`M` may be explicit (i.e. have the 2-by-3 matrix) or it can come as a geometric relation between points. + +2. Let's explain a little bit better (b). Since :math:`M` relates 02 images, we can analyze the simplest case in which it relates three points in both images. Look at the figure below: + + .. image:: images/Warp_Affine_Tutorial_Theory_0.jpg + :alt: Theory of Warp Affine + :width: 350pt + :align: center + + the points 1, 2 and 3 (forming a triangle in image 1) are mapped into image 2, still forming a triangle, but now they have changed notoriously. If we find the Affine Transformation with these 3 points (you can choose them as you like), then we can apply this found relation to the whole pixels in the image. + + Code ==== +#. **What does this program do?** + + * Loads an image + * Applies an Affine Transform to the image. This Transform is obtained from the relation between three points. We use the function :warp_affine:`warpAffine <>` for that purpose. + * Applies a Rotation to the image after being transformed. This rotation is with respect to the image center + * Waits until the user exits the program + +#. The tutorial code's is shown lines below. You can also download it from `here <https://code.ros.org/svn/opencv/trunk/opencv/samples/cpp/tutorial_code/ImgTrans/Geometric_Transforms_Demo.cpp>`_ + .. code-block:: cpp #include "opencv2/highgui/highgui.hpp" @@ -97,21 +173,137 @@ Code Explanation =========== +#. Declare some variables we will use, such as the matrices to store our results and 2 arrays of points to store the 2D points that define our Affine Transform. + + .. code-block:: cpp + + Point2f srcTri[3]; + Point2f dstTri[3]; + + Mat rot_mat( 2, 3, CV_32FC1 ); + Mat warp_mat( 2, 3, CV_32FC1 ); + Mat src, warp_dst, warp_rotate_dst; + +#. Load an image: + + .. code-block:: cpp + + src = imread( argv[1], 1 ); + +#. Initialize the destination image as having the same size and type as the source: + + .. code-block:: cpp + + warp_dst = Mat::zeros( src.rows, src.cols, src.type() ); + +#. **Affine Transform:** As we explained lines above, we need two sets of 3 points to derive the affine transform relation. Take a look: + + .. code-block:: cpp + + srcTri[0] = Point2f( 0,0 ); + srcTri[1] = Point2f( src.cols - 1, 0 ); + srcTri[2] = Point2f( 0, src.rows - 1 ); + + dstTri[0] = Point2f( src.cols*0.0, src.rows*0.33 ); + dstTri[1] = Point2f( src.cols*0.85, src.rows*0.25 ); + dstTri[2] = Point2f( src.cols*0.15, src.rows*0.7 ); + + You may want to draw the points to make a better idea of how they change. Their locations are approximately the same as the ones depicted in the example figure (in the Theory section). You may note that the size and orientation of the triangle defined by the 3 points change. + +#. Armed with both sets of points, we calculate the Affine Transform by using OpenCV function :get_affine_transform:`getAffineTransform <>`: + + .. code-block:: cpp + + warp_mat = getAffineTransform( srcTri, dstTri ); + + + We get as an output a :math:`2 \times 3` matrix (in this case **warp_mat**) + +#. We apply the Affine Transform just found to the src image + + .. code-block:: cpp + + warpAffine( src, warp_dst, warp_mat, warp_dst.size() ); + + with the following arguments: + + * **src**: Input image + * **warp_dst**: Output image + * **warp_mat**: Affine transform + * **warp_dst.size()**: The desired size of the output image + + We just got our first transformed image! We will display it in one bit. Before that, we also want to rotate it... + +#. **Rotate:** + To rotate an image, we need to know two things: + + a. The center with respect to which the image will rotate + b. The angle to be rotated. In OpenCV a positive angle is counter-clockwise + c. *Optional:* A scale factor + + We define these parameters with the following snippet: + + .. code-block:: cpp + + Point center = Point( warp_dst.cols/2, warp_dst.rows/2 ); + double angle = -50.0; + double scale = 0.6; + +#. We generate the rotation matrix with the OpenCV function :get_rotation_matrix_2d:`getRotationMatrix2D <>`, which returns a :math:`2 \times 3` matrix (in this case *rot_mat*) + + .. code-block:: cpp + + rot_mat = getRotationMatrix2D( center, angle, scale ); + +#. We now apply the found rotation to the output of our previous Transformation. + + .. code-block:: cpp + + warpAffine( warp_dst, warp_rotate_dst, rot_mat, warp_dst.size() ); + +#. Finally, we display our results in two windows plus the original image for good measure: + + .. code-block:: cpp + + namedWindow( source_window, CV_WINDOW_AUTOSIZE ); + imshow( source_window, src ); + + namedWindow( warp_window, CV_WINDOW_AUTOSIZE ); + imshow( warp_window, warp_dst ); + + namedWindow( warp_rotate_window, CV_WINDOW_AUTOSIZE ); + imshow( warp_rotate_window, warp_rotate_dst ); + + +#. We just have to wait until the user exits the program + + .. code-block:: cpp + + waitKey(0); + + + Result ====== -.. image:: images/Warp_Affine_Tutorial_Original_Image.jpg - :alt: Original image - :width: 250pt - :align: center +#. After compiling the code above, we can give it the path of an image as argument. For instance, for a picture like: -.. image:: images/Warp_Affine_Tutorial_Result_Warp.jpg - :alt: Original image - :width: 250pt - :align: center + .. image:: images/Warp_Affine_Tutorial_Original_Image.jpg + :alt: Original image + :width: 250pt + :align: center + + after applying the first Affine Transform we obtain: -.. image:: images/Warp_Affine_Tutorial_Result_Warp_Rotate.jpg - :alt: Original image - :width: 250pt - :align: center + .. image:: images/Warp_Affine_Tutorial_Result_Warp.jpg + :alt: Original image + :width: 250pt + :align: center + + and finally, after applying a negative rotation (remember negative means clockwise) and a scale factor, we get: + + .. image:: images/Warp_Affine_Tutorial_Result_Warp_Rotate.jpg + :alt: Original image + :width: 250pt + :align: center