Add OpenCV 3.4.1

huihut · Mar 2, 2018 · 3ca4de2 · 3ca4de2
1 parent be9dc3a
commit 3ca4de2
Show file tree

Hide file tree

Showing 126 changed files with 5,365 additions and 1,306 deletions.
diff --git a/README.md b/README.md
@@ -1,19 +1,40 @@
 # OpenCV-MinGW-Build
 
-Compiled OpenCV3.3.1 for MinGW32
+MinGW version of OpenCV compiled on Windows.
 
-## Environment
+## [OpenCV 3.4.1](https://github.com/huihut/OpenCV-MinGW-Build/tree/OpenCV-3.4.1)
+
+```
+git clone -b OpenCV-3.4.1 [email protected]:huihut/OpenCV-MinGW-Build.git
+```
+
+## [OpenCV 3.3.1](https://github.com/huihut/OpenCV-MinGW-Build/tree/OpenCV-3.3.1)
+
+```
+git clone -b OpenCV-3.3.1 [email protected]:huihut/OpenCV-MinGW-Build.git
+```
+
+
+
+## Compiling Environment
 
 * Windows-10-64bit
-* OpenCV-3.3.1
 * MinGW-5.3.0-32bit
 * CMake-3.9.2
 
-## Qt
+## How to compile OpenCV
+
+* [wiki.qt . How to setup Qt and openCV on Windows](https://wiki.qt.io/How_to_setup_Qt_and_openCV_on_Windows)
+* [blog.huihut . OpenCV使用CMake和MinGW的编译安装及其在Qt配置运行](https://blog.huihut.com/2017/12/03/CompiledOpenCVRunInQt/)
+
+## Using OpenCV in Qt
 
 Add OpenCV library file and include path to Qt `.pro` file.
 
-My OpenCV file is located in `E:\OpenCV_3.3.1\OpenCV-MinGW-Build`
+* My version of OpenCV: OpenCV 3.3.1
+* My OpenCV path
+
+My OpenCV file is located in `E:\OpenCV_3.3.1\OpenCV-MinGW-Build`, So the configuration is as follows:
 
 ```
 win32 {
@@ -46,8 +67,4 @@ LIBS += -LE:\OpenCV_3.3.1\OpenCV-MinGW-Build\bin \
     -llibopencv_videoio331 \
     -llibopencv_videostab331
 }
-```
-
-## Compile & Tutorials
-
-[OpenCV使用CMake和MinGW的编译安装及其在Qt配置运行](http://blog.csdn.net/huihut/article/details/78701814)
+```
diff --git a/bin/libopencv_calib3d331.dll b/bin/libopencv_calib3d331.dll
diff --git a/bin/libopencv_calib3d341.dll b/bin/libopencv_calib3d341.dll
diff --git a/bin/libopencv_core331.dll b/bin/libopencv_core331.dll
diff --git a/bin/libopencv_core341.dll b/bin/libopencv_core341.dll
diff --git a/bin/libopencv_dnn331.dll b/bin/libopencv_dnn331.dll
diff --git a/bin/libopencv_dnn341.dll b/bin/libopencv_dnn341.dll
diff --git a/bin/libopencv_features2d331.dll b/bin/libopencv_features2d331.dll
diff --git a/bin/libopencv_features2d341.dll b/bin/libopencv_features2d341.dll
diff --git a/bin/libopencv_flann331.dll b/bin/libopencv_flann331.dll
diff --git a/bin/libopencv_flann341.dll b/bin/libopencv_flann341.dll
diff --git a/bin/libopencv_highgui331.dll b/bin/libopencv_highgui331.dll
diff --git a/bin/libopencv_highgui341.dll b/bin/libopencv_highgui341.dll
diff --git a/bin/libopencv_imgcodecs331.dll b/bin/libopencv_imgcodecs331.dll
diff --git a/bin/libopencv_imgcodecs341.dll b/bin/libopencv_imgcodecs341.dll
diff --git a/bin/libopencv_imgproc331.dll b/bin/libopencv_imgproc331.dll
diff --git a/bin/libopencv_imgproc341.dll b/bin/libopencv_imgproc341.dll
diff --git a/bin/libopencv_ml331.dll b/bin/libopencv_ml331.dll
diff --git a/bin/libopencv_ml341.dll b/bin/libopencv_ml341.dll
diff --git a/bin/libopencv_objdetect331.dll b/bin/libopencv_objdetect331.dll
diff --git a/bin/libopencv_objdetect341.dll b/bin/libopencv_objdetect341.dll
diff --git a/bin/libopencv_photo331.dll b/bin/libopencv_photo331.dll
diff --git a/bin/libopencv_photo341.dll b/bin/libopencv_photo341.dll
diff --git a/bin/libopencv_shape331.dll b/bin/libopencv_shape331.dll
diff --git a/bin/libopencv_shape341.dll b/bin/libopencv_shape341.dll
diff --git a/bin/libopencv_stitching331.dll b/bin/libopencv_stitching331.dll
diff --git a/bin/libopencv_stitching341.dll b/bin/libopencv_stitching341.dll
diff --git a/bin/libopencv_superres331.dll b/bin/libopencv_superres331.dll
diff --git a/bin/libopencv_superres341.dll b/bin/libopencv_superres341.dll
diff --git a/bin/libopencv_video331.dll b/bin/libopencv_video331.dll
diff --git a/bin/libopencv_video341.dll b/bin/libopencv_video341.dll
diff --git a/bin/libopencv_videoio331.dll b/bin/libopencv_videoio331.dll
diff --git a/bin/libopencv_videoio341.dll b/bin/libopencv_videoio341.dll
diff --git a/bin/libopencv_videostab331.dll b/bin/libopencv_videostab331.dll
diff --git a/bin/libopencv_videostab341.dll b/bin/libopencv_videostab341.dll
diff --git a/bin/opencv_annotation.exe b/bin/opencv_annotation.exe
diff --git a/bin/opencv_createsamples.exe b/bin/opencv_createsamples.exe
diff --git a/bin/opencv_interactive-calibration.exe b/bin/opencv_interactive-calibration.exe
diff --git a/bin/opencv_traincascade.exe b/bin/opencv_traincascade.exe
diff --git a/bin/opencv_version.exe b/bin/opencv_version.exe
diff --git a/bin/opencv_visualisation.exe b/bin/opencv_visualisation.exe
diff --git a/include/opencv2/calib3d.hpp b/include/opencv2/calib3d.hpp
diff --git a/include/opencv2/core.hpp b/include/opencv2/core.hpp
diff --git a/include/opencv2/core/affine.hpp b/include/opencv2/core/affine.hpp
@@ -55,7 +55,72 @@ namespace cv
 //! @{
 
     /** @brief Affine transform
-      @todo document
+     *
+     * It represents a 4x4 homogeneous transformation matrix \f$T\f$
+     *
+     *  \f[T =
+     *  \begin{bmatrix}
+     *  R & t\\
+     *  0 & 1\\
+     *  \end{bmatrix}
+     *  \f]
+     *
+     *  where \f$R\f$ is a 3x3 rotation matrix and \f$t\f$ is a 3x1 translation vector.
+     *
+     *  You can specify \f$R\f$ either by a 3x3 rotation matrix or by a 3x1 rotation vector,
+     *  which is converted to a 3x3 rotation matrix by the Rodrigues formula.
+     *
+     *  To construct a matrix \f$T\f$ representing first rotation around the axis \f$r\f$ with rotation
+     *  angle \f$|r|\f$ in radian (right hand rule) and then translation by the vector \f$t\f$, you can use
+     *
+     *  @code
+     *  cv::Vec3f r, t;
+     *  cv::Affine3f T(r, t);
+     *  @endcode
+     *
+     *  If you already have the rotation matrix \f$R\f$, then you can use
+     *
+     *  @code
+     *  cv::Matx33f R;
+     *  cv::Affine3f T(R, t);
+     *  @endcode
+     *
+     *  To extract the rotation matrix \f$R\f$ from \f$T\f$, use
+     *
+     *  @code
+     *  cv::Matx33f R = T.rotation();
+     *  @endcode
+     *
+     *  To extract the translation vector \f$t\f$ from \f$T\f$, use
+     *
+     *  @code
+     *  cv::Vec3f t = T.translation();
+     *  @endcode
+     *
+     *  To extract the rotation vector \f$r\f$ from \f$T\f$, use
+     *
+     *  @code
+     *  cv::Vec3f r = T.rvec();
+     *  @endcode
+     *
+     *  Note that since the mapping from rotation vectors to rotation matrices
+     *  is many to one. The returned rotation vector is not necessarily the one
+     *  you used before to set the matrix.
+     *
+     *  If you have two transformations \f$T = T_1 * T_2\f$, use
+     *
+     *  @code
+     *  cv::Affine3f T, T1, T2;
+     *  T = T2.concatenate(T1);
+     *  @endcode
+     *
+     *  To get the inverse transform of \f$T\f$, use
+     *
+     *  @code
+     *  cv::Affine3f T, T_inv;
+     *  T_inv = T.inv();
+     *  @endcode
+     *
      */
     template<typename T>
     class Affine3
@@ -66,45 +131,127 @@ namespace cv
         typedef Matx<float_type, 4, 4> Mat4;
         typedef Vec<float_type, 3> Vec3;
 
+       //! Default constructor. It represents a 4x4 identity matrix.
         Affine3();
 
         //! Augmented affine matrix
         Affine3(const Mat4& affine);
 
-        //! Rotation matrix
+        /**
+         *  The resulting 4x4 matrix is
+         *
+         *  \f[
+         *  \begin{bmatrix}
+         *  R & t\\
+         *  0 & 1\\
+         *  \end{bmatrix}
+         *  \f]
+         *
+         * @param R 3x3 rotation matrix.
+         * @param t 3x1 translation vector.
+         */
         Affine3(const Mat3& R, const Vec3& t = Vec3::all(0));
 
-        //! Rodrigues vector
+        /**
+         * Rodrigues vector.
+         *
+         * The last row of the current matrix is set to [0,0,0,1].
+         *
+         * @param rvec 3x1 rotation vector. Its direction indicates the rotation axis and its length
+         *             indicates the rotation angle in radian (using right hand rule).
+         * @param t 3x1 translation vector.
+         */
         Affine3(const Vec3& rvec, const Vec3& t = Vec3::all(0));
 
-        //! Combines all contructors above. Supports 4x4, 4x3, 3x3, 1x3, 3x1 sizes of data matrix
+        /**
+         * Combines all constructors above. Supports 4x4, 3x4, 3x3, 1x3, 3x1 sizes of data matrix.
+         *
+         * The last row of the current matrix is set to [0,0,0,1] when data is not 4x4.
+         *
+         * @param data 1-channel matrix.
+         *             when it is 4x4, it is copied to the current matrix and t is not used.
+         *             When it is 3x4, it is copied to the upper part 3x4 of the current matrix and t is not used.
+         *             When it is 3x3, it is copied to the upper left 3x3 part of the current matrix.
+         *             When it is 3x1 or 1x3, it is treated as a rotation vector and the Rodrigues formula is used
+         *                             to compute a 3x3 rotation matrix.
+         * @param t 3x1 translation vector. It is used only when data is neither 4x4 nor 3x4.
+         */
         explicit Affine3(const Mat& data, const Vec3& t = Vec3::all(0));
 
-        //! From 16th element array
+        //! From 16-element array
         explicit Affine3(const float_type* vals);
 
-        //! Create identity transform
+        //! Create an 4x4 identity transform
         static Affine3 Identity();
 
-        //! Rotation matrix
+        /**
+         * Rotation matrix.
+         *
+         * Copy the rotation matrix to the upper left 3x3 part of the current matrix.
+         * The remaining elements of the current matrix are not changed.
+         *
+         * @param R 3x3 rotation matrix.
+         *
+         */
         void rotation(const Mat3& R);
 
-        //! Rodrigues vector
+        /**
+         * Rodrigues vector.
+         *
+         * It sets the upper left 3x3 part of the matrix. The remaining part is unaffected.
+         *
+         * @param rvec 3x1 rotation vector. The direction indicates the rotation axis and
+         *             its length indicates the rotation angle in radian (using the right thumb convention).
+         */
         void rotation(const Vec3& rvec);
 
-        //! Combines rotation methods above. Suports 3x3, 1x3, 3x1 sizes of data matrix;
+        /**
+         * Combines rotation methods above. Supports 3x3, 1x3, 3x1 sizes of data matrix.
+         *
+         * It sets the upper left 3x3 part of the matrix. The remaining part is unaffected.
+         *
+         * @param data 1-channel matrix.
+         *             When it is a 3x3 matrix, it sets the upper left 3x3 part of the current matrix.
+         *             When it is a 1x3 or 3x1 matrix, it is used as a rotation vector. The Rodrigues formula
+         *             is used to compute the rotation matrix and sets the upper left 3x3 part of the current matrix.
+         */
         void rotation(const Mat& data);
 
+        /**
+         * Copy the 3x3 matrix L to the upper left part of the current matrix
+         *
+         * It sets the upper left 3x3 part of the matrix. The remaining part is unaffected.
+         *
+         * @param L 3x3 matrix.
+         */
         void linear(const Mat3& L);
+
+        /**
+         * Copy t to the first three elements of the last column of the current matrix
+         *
+         * It sets the upper right 3x1 part of the matrix. The remaining part is unaffected.
+         *
+         * @param t 3x1 translation vector.
+         */
         void translation(const Vec3& t);
 
+        //! @return the upper left 3x3 part
         Mat3 rotation() const;
+
+        //! @return the upper left 3x3 part
         Mat3 linear() const;
+
+        //! @return the upper right 3x1 part
         Vec3 translation() const;
 
-        //! Rodrigues vector
+        //! Rodrigues vector.
+        //! @return a vector representing the upper left 3x3 rotation matrix of the current matrix.
+        //! @warning  Since the mapping between rotation vectors and rotation matrices is many to one,
+        //!           this function returns only one rotation vector that represents the current rotation matrix,
+        //!           which is not necessarily the same one set by `rotation(const Vec3& rvec)`.
         Vec3 rvec() const;
 
+        //! @return the inverse of the current matrix.
         Affine3 inv(int method = cv::DECOMP_SVD) const;
 
         //! a.rotate(R) is equivalent to Affine(R, 0) * a;
@@ -113,7 +260,7 @@ namespace cv
         //! a.rotate(rvec) is equivalent to Affine(rvec, 0) * a;
         Affine3 rotate(const Vec3& rvec) const;
 
-        //! a.translate(t) is equivalent to Affine(E, t) * a;
+        //! a.translate(t) is equivalent to Affine(E, t) * a, where E is an identity matrix
         Affine3 translate(const Vec3& t) const;
 
         //! a.concatenate(affine) is equivalent to affine * a;
@@ -136,6 +283,7 @@ namespace cv
     template<typename T> static
     Affine3<T> operator*(const Affine3<T>& affine1, const Affine3<T>& affine2);
 
+    //! V is a 3-element vector with member fields x, y and z
     template<typename T, typename V> static
     V operator*(const Affine3<T>& affine, const V& vector);
 
@@ -178,7 +326,7 @@ namespace cv
 //! @cond IGNORED
 
 ///////////////////////////////////////////////////////////////////////////////////
-// Implementaiton
+// Implementation
 
 template<typename T> inline
 cv::Affine3<T>::Affine3()
@@ -212,6 +360,7 @@ template<typename T> inline
 cv::Affine3<T>::Affine3(const cv::Mat& data, const Vec3& t)
 {
     CV_Assert(data.type() == cv::traits::Type<T>::value);
+    CV_Assert(data.channels() == 1);
 
     if (data.cols == 4 && data.rows == 4)
     {
@@ -276,11 +425,12 @@ void cv::Affine3<T>::rotation(const Vec3& _rvec)
     }
 }
 
-//Combines rotation methods above. Suports 3x3, 1x3, 3x1 sizes of data matrix;
+//Combines rotation methods above. Supports 3x3, 1x3, 3x1 sizes of data matrix;
 template<typename T> inline
 void cv::Affine3<T>::rotation(const cv::Mat& data)
 {
     CV_Assert(data.type() == cv::traits::Type<T>::value);
+    CV_Assert(data.channels() == 1);
 
     if (data.cols == 3 && data.rows == 3)
     {
@@ -295,7 +445,7 @@ void cv::Affine3<T>::rotation(const cv::Mat& data)
         rotation(_rvec);
     }
     else
-        CV_Assert(!"Input marix can be 3x3, 1x3 or 3x1");
+        CV_Assert(!"Input matrix can only be 3x3, 1x3 or 3x1");
 }
 
 template<typename T> inline