From bffd77ed87fa6edc2a47b6d165766a404552bd84 Mon Sep 17 00:00:00 2001
From: Vadim Pisarevsky <no@email>
Date: Sat, 28 Apr 2012 12:59:21 +0000
Subject: [PATCH] moved planar subdiv docs to legacy; added Input/OutputArray
 docs to core

---
 modules/core/doc/basic_structures.rst         |  86 ++++++++++++++++++
 modules/imgproc/doc/imgproc.rst               |   1 -
 modules/legacy/doc/legacy.rst                 |   1 +
 modules/legacy/doc/pics/quadedge.png          | Bin 0 -> 4679 bytes
 modules/legacy/doc/pics/subdiv.png            | Bin 0 -> 2812 bytes
 .../doc/planar_subdivisions.rst               |   0
 6 files changed, 87 insertions(+), 1 deletion(-)
 create mode 100644 modules/legacy/doc/pics/quadedge.png
 create mode 100644 modules/legacy/doc/pics/subdiv.png
 rename modules/{imgproc => legacy}/doc/planar_subdivisions.rst (100%)

diff --git a/modules/core/doc/basic_structures.rst b/modules/core/doc/basic_structures.rst
index 05f15e755..edf3b80bc 100644
--- a/modules/core/doc/basic_structures.rst
+++ b/modules/core/doc/basic_structures.rst
@@ -1814,6 +1814,84 @@ To use ``Mat_`` for multi-channel images/matrices, pass ``Vec`` as a ``Mat_`` pa
             img(i,j)[2] ^= (uchar)(i ^ j);
 
 
+InputArray
+----------
+
+This is the proxy class for passing read-only input arrays into OpenCV functions. It is defined as ::
+
+    typedef const _InputArray& InputArray;
+    
+where ``_InputArray`` is a class that can be constructed from ``Mat``, ``Mat_<T>``, ``Matx<T, m, n>``, ``std::vector<T>``, ``std::vector<std::vector<T> >`` or ``std::vector<Mat>``. It can also be constructed from a matrix expression.
+
+Since this is mostly implementation-level class, and its interface may change in future versions, we do not describe it in details. There are a few key things, though, that should be kept in mind:
+
+  * When you see in the reference manual or in OpenCV source code a function that takes ``InputArray``, it means that you can actually pass ``Mat``, ``Matx``, ``vector<T>`` etc. (see above the complete list).
+  
+  * Optional input arguments: If some of the input arrays may be empty, pass ``cv::noArray()`` (or simply ``cv::Mat()`` as you probably did before).
+
+  * The class is designed solely for passing parameters. That is, normally you *should not* declare class members, local and global variables of this type.
+  
+  * If you want to design your own function or a class method that can operate of arrays of multiple types, you can use ``InputArray`` (or ``OutputArray``) for the respective parameters. Inside a function you should use ``_InputArray::getMat()`` method to construct a matrix header for the array (without copying data). ``_InputArray::kind()`` can be used to distinguish ``Mat`` from ``vector<>`` etc., but normally it is not needed.
+  
+Here is how you can use a function that takes ``InputArray`` ::
+
+    std::vector<Point2f> vec;
+    // points or a circle
+    for( int i = 0; i < 30; i++ )
+        vec.push_back(Point2f((float)(100 + 30*cos(i*CV_PI*2/5)),
+                              (float)(100 - 30*sin(i*CV_PI*2/5))));
+    cv::transform(vec, vec, cv::Matx23f(0.707, -0.707, 10, 0.707, 0.707, 20));
+
+That is, we form an STL vector containing points, and apply in-place affine transformation to the vector using the 2x3 matrix created inline as ``Matx<float, 2, 3>`` instance.
+
+Here is how such a function can be implemented (for simplicity, we implement a very specific case of it, according to the assertion statement inside) ::
+
+    void myAffineTransform(InputArray _src, OutputArray _dst, InputArray _m)
+    {
+        // get Mat headers for input arrays. This is O(1) operation,
+        // unless _src and/or _m are matrix expressions.
+        Mat src = _src.getMat(), m = _m.getMat();
+        CV_Assert( src.type() == CV_32FC2 && m.type() == CV_32F && m.size() == Size(3, 2) );
+        
+        // [re]create the output array so that it has the proper size and type.
+        // In case of Mat it calls Mat::create, in case of STL vector it calls vector::resize.
+        _dst.create(src.size(), src.type());
+        Mat dst = _dst.getMat();
+        
+        for( int i = 0; i < src.rows; i++ )
+            for( int j = 0; j < src.cols; j++ )
+            {
+                Point2f pt = src.at<Point2f>(i, j);
+                dst.at<Point2f>(i, j) = Point2f(m.at<float>(0, 0)*pt.x +
+                                                m.at<float>(0, 1)*pt.y +
+                                                m.at<float>(0, 2),
+                                                m.at<float>(1, 0)*pt.x +
+                                                m.at<float>(1, 1)*pt.y +
+                                                m.at<float>(1, 2));
+            }
+    }
+
+There is another related type, ``InputArrayOfArrays``, which is currently defined as a synonym for ``InputArray``: ::
+
+    typedef InputArray InputArrayOfArrays;
+    
+It denotes function arguments that are either vectors of vectors or vectors of matrices. A separate synonym is needed to generate Python/Java etc. wrappers properly. At the function implementation level their use is similar, but ``_InputArray::getMat(idx)`` should be used to get header for the idx-th component of the outer vector and ``_InputArray::size().area()`` should be used to find the number of components (vectors/matrices) of the outer vector.
+
+
+OutputArray
+-----------
+
+This type is very similar to ``InputArray`` except that it is used for input/output and output function parameters. Just like with ``InputArray``, OpenCV users should not care about ``OutputArray``, they just pass ``Mat``, ``vector<T>`` etc. to the functions. The same limitation as for ``InputArray``: **Do not explicitly create OutputArray instances** applies here too.
+
+If you want to make your function polymorphic (i.e. accept different arrays as output parameters), it is also not very difficult. Take the sample above as the reference. Note that ``_OutputArray::create()`` needs to be called before ``_OutputArray::getMat()``. This way you guarantee that the output array is properly allocated.
+
+Optional output parameters. If you do not need certain output array to be computed and returned to you, pass ``cv::noArray()``, just like you would in the case of optional input array. At the implementation level, use ``_OutputArray::needed()`` to check if certain output array needs to be computed or not.
+
+There are several synonyms for ``OutputArray`` that are used to assist automatic Python/Java/... wrapper generators: ::
+
+    typedef OutputArray OutputArrayOfArrays;
+    typedef OutputArray InputOutputArray;
+    typedef OutputArray InputOutputArrayOfArrays;
 
 NAryMatIterator
 ---------------
@@ -2230,3 +2308,11 @@ It simplifies notation of some operations. ::
     M.ref(1, 2, 3) = M(4, 5, 6) + M(7, 8, 9);
 
 
+Algorithm
+---------
+
+This is a base class for all more or less complex algorithms in OpenCV, especially for classes of algorithms, for which there can be multiple implementations. The examples are stereo correspondence (for which there are algorithms like block matching, semi-global block matching, graph-cut etc.), background subtraction (which can be done using mixture-of-gaussians models, codebook-based algorithm etc.), optical flow (block matching, Lucas-Kanade, Horn-Schunck etc.).
+
+Algorithm performs several functions:
+
+    * It provides virtual constructor. That is, if algorithm class is 
diff --git a/modules/imgproc/doc/imgproc.rst b/modules/imgproc/doc/imgproc.rst
index 319fb2232..acaebc475 100644
--- a/modules/imgproc/doc/imgproc.rst
+++ b/modules/imgproc/doc/imgproc.rst
@@ -12,7 +12,6 @@ imgproc. Image Processing
     miscellaneous_transformations
     histograms
     structural_analysis_and_shape_descriptors
-    planar_subdivisions
     motion_analysis_and_object_tracking
     feature_detection
     object_detection
diff --git a/modules/legacy/doc/legacy.rst b/modules/legacy/doc/legacy.rst
index 8e6a826aa..ac5dde39f 100644
--- a/modules/legacy/doc/legacy.rst
+++ b/modules/legacy/doc/legacy.rst
@@ -9,3 +9,4 @@ legacy. Deprecated stuff
 
     motion_analysis
     expectation_maximization
+    planar_subdivisions
diff --git a/modules/legacy/doc/pics/quadedge.png b/modules/legacy/doc/pics/quadedge.png
new file mode 100644
index 0000000000000000000000000000000000000000..2fc6c2bfcf7cde160b422bff8d365e23d767ba7f
GIT binary patch
literal 4679
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
JPDHLkV1n<tGUWgO

literal 0
HcmV?d00001

diff --git a/modules/legacy/doc/pics/subdiv.png b/modules/legacy/doc/pics/subdiv.png
new file mode 100644
index 0000000000000000000000000000000000000000..21026e5eeb5b1fe03a07f6639b00de348994eab5
GIT binary patch
literal 2812
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
O0000<MNUMnLSTZ>C4}n$

literal 0
HcmV?d00001

diff --git a/modules/imgproc/doc/planar_subdivisions.rst b/modules/legacy/doc/planar_subdivisions.rst
similarity index 100%
rename from modules/imgproc/doc/planar_subdivisions.rst
rename to modules/legacy/doc/planar_subdivisions.rst