From 13bbc9ff71b7c9660517ee7d7103e6da477c85eb Mon Sep 17 00:00:00 2001 From: Ana Huaman 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 .../imgproc/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 561d9ae..620a75f 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 b4c75d5..774ef28 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 `_ + .. 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_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.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 + .. image:: images/Warp_Affine_Tutorial_Result_Warp_Rotate.jpg + :alt: Original image + :width: 250pt + :align: center -- 2.7.4