From 5ce78496a0b0de8e301e7f303747656e67cc59b0 Mon Sep 17 00:00:00 2001
From: "Christian S. Perone" <christian.perone@gmail.com>
Date: Fri, 20 Jun 2014 00:52:22 -0300
Subject: [PATCH 1/3] Fixing typo in the getting started part of the contours
 tutorial.

---
 .../py_contours/py_contours_begin/py_contours_begin.rst         | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/source/py_tutorials/py_imgproc/py_contours/py_contours_begin/py_contours_begin.rst b/source/py_tutorials/py_imgproc/py_contours/py_contours_begin/py_contours_begin.rst
index ae28199..5c1b769 100644
--- a/source/py_tutorials/py_imgproc/py_contours/py_contours_begin/py_contours_begin.rst
+++ b/source/py_tutorials/py_imgproc/py_contours/py_contours_begin/py_contours_begin.rst
@@ -43,7 +43,7 @@ To draw the contours, ``cv2.drawContours`` function is used. It can also be used
 To draw all the contours in an image:
 ::
 
-    img = cv2.drawContour(img, contours, -1, (0,255,0), 3)
+    img = cv2.drawContours(img, contours, -1, (0,255,0), 3)
     
 To draw an individual contour, say 4th contour:
 ::

From ab6dcc5094699fe5013c688dca5a15389b83e148 Mon Sep 17 00:00:00 2001
From: abidrahmank <abidrahman2@gmail.com>
Date: Thu, 24 Jul 2014 23:14:27 +0530
Subject: [PATCH 2/3] pybindings

---
 .../.py_bindings_basics.rst.swp               | Bin 0 -> 20480 bytes
 .../py_bindings_basics/py_bindings_basics.rst | 112 ++++++++++++++++++
 .../images/inpainticon.jpg                    | Bin 0 -> 5020 bytes
 .../images/nlm_icon.jpg                       | Bin 0 -> 3735 bytes
 .../py_table_of_contents_bindings.rst         |  36 ++++++
 source/py_tutorials/py_tutorials.rst          |  18 ++-
 6 files changed, 163 insertions(+), 3 deletions(-)
 create mode 100644 source/py_tutorials/py_bindings/py_bindings_basics/.py_bindings_basics.rst.swp
 create mode 100644 source/py_tutorials/py_bindings/py_bindings_basics/py_bindings_basics.rst
 create mode 100644 source/py_tutorials/py_bindings/py_table_of_contents_bindings/images/inpainticon.jpg
 create mode 100644 source/py_tutorials/py_bindings/py_table_of_contents_bindings/images/nlm_icon.jpg
 create mode 100644 source/py_tutorials/py_bindings/py_table_of_contents_bindings/py_table_of_contents_bindings.rst

diff --git a/source/py_tutorials/py_bindings/py_bindings_basics/.py_bindings_basics.rst.swp b/source/py_tutorials/py_bindings/py_bindings_basics/.py_bindings_basics.rst.swp
new file mode 100644
index 0000000000000000000000000000000000000000..96597f450e4848c194a2b2f4100debc670df067b
GIT binary patch
literal 20480
zcmeHOOKc=Z8Sb#aZUWgw2`40^N&*|(nVqq{Q5GDc$Z@=}VZFB2-d&!Wsp+nnY22^v
zhsOg%NN_;n!X@GnDH4QBB9ORnLm)sx;s8Q{1aaa32Ovl}aYf?$|ElWgnH_r#;vtkC
z?eCfHuKKI$tN&fS-NhT5TjEmlQ3s!QInHm^U)g=_XLmWTUUD4S^}SRMLK*GT(<47J
zJ^s1v*h-726)Mk{tqSYb`bT$GukLPcUu|tCDq6d-d|_vl58~*;UXjPCFN3U=#YO6>
zRx)bm<vm<<{mAp9ent=M?{-&azB}tyGtF{4mHN9z;LU|Vk@qfq;9lqA^3ozL{GkUQ
z5cl7A{mq3zz1kXq8i5*t8i5*t8i5*t8i5*tH#q`%a?1HUFnEi>;X(6#*VOkZbG>1{
zADVjpR&)J!^PNmRH<$HSjX;e+jX;e+jX;e+jX;e+jX;e+jX;e+jX;gS{{R8$IS&3g
zXDH#v`M=Ho|9Z}GUI+ag^li|Kpcg=21AP_r70{PK9|z5W9tQpWEZ!dg{TlTAI~?a5
zpx_?I*$3T!#&PZgT}Odn5A-Yw3ZDag3*&whbOUr9v<GT|?gr7EPJ{j{pC?Z8aW>+i
z$YY@na}{|aQbQ5OUJ<B_?&{YTp2T!_W04R1OyFNWP=a4c5C<yF{5TSEPYl3DzwBV%
zbrAOT1tC)<`YKYX%$3(<RuNjqQ7|H&QC|eAms`$m943AsbHf*dWl9WFnItL|J)b5v
z9Qf`)^!)?;E;6yO;2tb5ESPyW1*SS2s7Q?BLbx&rgcQ9Za*1O@WO5`rofJKv5b9PT
z1OGE>!_V?LKkP3x@Mn3x(-D4Tmfk>P_h4mZOXj$p<!RyO1@(606kkcquWJxgoepv6
zbf^chL30T}c`W=M`j|*piC&!IeGz^{bJJ*cIulc&8Q2-qRMsAOq$w`@kqiXJEP|ZI
zz^@8hH;%9wz!y8??xPcCB*oPtOh&*zl_Q1)ys|-@qQ4BnILq-Bh#0^!+!^nb7e~qr
zIt{exl*v$uEK#%!n!n6R0BDlDw*w_TY*ixD3}2}NUJ+Ph?`Q#CAKMMQsS7vp%B5ya
zv0bEARN_=*Zt5qwn1k>vH<Qu42GLCw1ZgZ1W@|HomKQ|wY2nLSZXmNvWi1sIAzr)T
z9n9>|-I17_?%c;%Xd;@eN0JWVGcC02c|}SRTa{9vN<(%!-NFyNmQf$P!9%b7v}iBm
zfDi##olY_W-jRFIE;XXP&>T=B67Bh>c&f;W9dssys6t}07;tNS(+Va$nag~XKneqY
zUkS)&L)=jAqkco|LY$joZ=gm{Wo!_{04%g};}S1ELF5BS!)1V_4rQ1G3erG41hFLf
zC;~`Pr4x8m1WAu^L^~<+0vu^`^I=S4sQR!GLgg+5&<~;5X)tQcSRer!s6(S-<83Q9
zQuENNfBe!`A=Fs`3!zs#LsG~hC4qE-2sW?NncA`}b(gVyuqw?#l5{$dYuc4bN%3Np
zMGxm%l8%-;8i1suB1BEG8D%-N#Nt5HaiP5uZA0m%G1SHL^zKpLuIl?yL}Ev{vP^mk
za&6UCgQ6nYWwSjV&FCOD(Dzi7`@PXvF^p(v9b}P#sN2yoAw2^q2+hD#2Pz;#0h17m
zB#ry247Ke7gWPuu%%<ecwq~*$=8Gv<(>>nQ+2W?%4jW0mHbN+h^QL%O0VP;X4TPPq
zHLm0mB0@ZZ#0zLWc_*?;3ieUMJ+03y3S=QzSEMof#`KV#oh2K_AVD(328^W!!c4k!
zdq%-aJBDq~*&ktdu@<QK<X}gPHSp55-ba`~8gZ}Uh9^amOo(~jFGeuYfuHNSY3+j5
ztcW3LXDqUie1Mrd8D>~v_Vr}>_!_n@V$r0Ap21&sV`zjV>7U;HhG3Jc^>xb3*o`mU
zp%y=q#l9kb>>A8~B=BX22u`PAya`*X2Iim89MXOfLbx-SG4qq38>6G$W|eJLE&@VC
zYa&Ut<A95C5oQ^XSvFp*#xRl<03leHeY}A=LrT`R<i5I07QLAtQse*`k-`me*LpQA
z*zQ2N`+AQmVb_%P)w{#;!;&uX#%KtaO##G6FpF{_M{uD~1UlQL#rkP=71-~++ufYq
za|X`fWISo33KrUBxdi$eC33+W5LD#C%m`?0MkYk0_#*)I@iJ^afFU6*^vMCxPHL;n
zL632U5XDMkS4QNY3ewqL8i&I3dp$VJC>Mc@`i1OU&!~ZGh!4vHsV8WaCq#@Qk{AX8
zHd7cYH$!#VD_ey4f+IL=W;gY{KH27cs9<z3UA9+7ld2|}W(pq&8Ruw}T9)Fb7hpGd
z&#FPGuZhp`CfU0o1zM1!0foZs4Jg#>r*T21O^SXTdtx7vb)aZs=%LxR*2L=0CiP4a
zW%?;%aIq>fhTDb!2*yp2KuR|`L(JPO$^hS^5y{HNy`JylZD#x2i(OVljwU~`^eMI^
zI`$y8@FD5g0TBZe&x}XFMhqbm)S66J8TOkPPpeVxhw1_eUJ+8mTxR<`l8uhwn9&>Q
z00|YuDF}Sn;#>?V3O0>w^u?+N@tPh9A~~UCEN5gW2peq!DEFZ8IX*K8>4??3Ig;ui
zb}8+l)z0)KWYKS8d`b_3I5wd>?=^-S2``4?oFtLsHk{4rB_5xKA*B=eEQs6FKZ8)k
zkm$udS?O`IA!r2WijrxxV%Fe16U)GH7EbV)v6QFG%kko7obG2>LbEB__GbGjeoKDE
zq5S`o$g#gpF90C_x99ukkk6k5{phUY{1Egq=p~Q@bwHzg9p@0_fn3me&@bQVIKKd`
zfIbL%Kj?j+zo8EB2Ivo_Ch#1-cR}v~y&H5t=qGnO&W}Og1$_tfCD27s6Z9w44W0)*
z23i9B>a^p00n`Hh9<_wufnI-`<NO8m8t7Hf_dqX$UI2X&^dZon@sh$HK`((q&?V3^
z=p5(_=rm|>%5nOjUC=d93p5XUFX%4N_kj~(^#(9|1@u$Uiy#S_@e$%N{zqT`G6~UY
zJ%E@u%2Sw+5E%|!hy#XV?M8ctzN^otE+?8#x1D$hUe~sF+ShJEjS4dKB3xW-h;WJi
zEH2^CGGF4?zl%?}cpRrYJ)_m1bjIQ0G8S-=7O+f9S)$9ui;p`r2z>~`EP*kef;a&b
zzPsX3o6quJ9k5|={Ku8;YkRxxo9(UD9kFHhh4jpgJ$0cAYqr0#BHRQo!|YOCs^eH4
zM4I@Z%(0ETP=^Uh4lse*Ty{Fs<4_rc6J8i?c&V~I+(H?TM_9%I@({Q~g!D3nB{#F1
zn`f^;{)@9&a(sT?)b{P!F&Y(UdqE6W>LJ*bk*jnQ#(@y2w1e|NRMOw{4j;#ZR!cxy
zVaNRt5e5vprw)(m#SOV%*$deZmopF{9ozL*0WWF0@&)468C|PG-@Jz1dKx*rJD8(M
zw=EM2l5uILV=ncY5XUhNZ41Qw1Xw5Md15wZfD_5z?&j9cm36Zyw)8V3kaL%5u_Lcr
z7CdIkoaU`_DN1u}QK*s&A`m%{L7^yWn+S)RVqMFb4q88=MmsSuZcqgUB?rzG5Kkk<
z4i)M@o^Dpo2Ygup2wliMh2=e81xGbA#(<`(_q*J6ae@!+edehoAE4NI0XBkf+#25z
zl`TI3Ka}Tkq+F|1PZZfL#9xhxTe%-V&l^0)ijuGHl29t7AHl_WaS;0y4e9GSltRWF
zQ+JXd4ZzIU8K6K^<OuC33bXySF7m>dKi2@ML59*UB3+}a1T)>$6P)VJBk&(_!p{sC
z7}+tfM?*aum*xKmE-YRpR5~}Cf@Zw<%EWH|vzw#^YrK3bS9jRABh-2uc>*jG6~M-M
zQt3?Sm}0gwS=}W)p_FlmYLTgaCaCSejnKIUl@JiE>jYIvXscykmLn)Z19Q#?;Uc&P
zEWQqakp@!!PJ-l0m<@6?Mvljvx~P*4DPc@irK-RQE|O5xKM{tY#()DCngG|@Gakpo
zB%r7grAwq$hhSX}TNX~owxdmp#Wcp5FbowXF(MwLXDpEQg{6#RtJ%6A_-T%Eunmq-
zfmsXu<O<5PIlL;T_Anfax4Q+~k##w%b~AC7Yx&HN85}u0b3sxYjOLEB240p|xShm_
zh_x%L8|z|4=*D8z795TcJStY9jtS>(d<v=#Sxn`fs&eRR4pkqp&E>(F4xtR<ri(H1
zh-q}|av#levhHJUY`ZiY?Gj+~OU%TbKA7S5^*zDPXt{TuV{4T*D4e1D?4!?%RC+#6
z%#7Kuu1c#s66*EH4Pr`c*ZkBC)P#jj$kk<yBjDSZIQSviM4bSY4@6no{F;Itu24Lj
zsNLx@$i5m4;}pJ-k2N}-u{2Eh1wh7bmNcD`Z>k5NZU?2O6BDcW1DSfL5}?e(!@>xZ
z<D%q6TTO*3gv`3&ZiduwF>ISx2{}6$#Rj~KdQWbLZsG**Shog2rX83aRbMWTv+fwj
zU}`*hlyk<>FN6&>^&!~>GDJv!Cw7JFt!%<7h0KhOmtgi#1ma?bEr!_B0DBfun#;=R
z1L7eZteF!;Z8NwWh+{+?j__v4h^jjJ09Ui*f*Ku6qOLblX3@={ShTmP3K4EoiNy|#
zUACIZ62R=ISabgW+p~^y4|09V|B*`b=Lfic4zvy006hbuHtV4JQzK9#P$N(yP$N(y
zP$N(yP$N(yP$N(yP$TgFi$M7v7bV(MwhZN`QTO1(2!3zdCiu26NkvC}v~O#M6ScqT
zqsgeC<I|{E!qGxh&~ao`(0L^8^Bp>o#QmuwNqg!W;Z10M{Ti>ORt|uv(1q&C^jIN}
W74ldij}`J*xKD?l1)qNMSpNW%h@z|j

literal 0
HcmV?d00001

diff --git a/source/py_tutorials/py_bindings/py_bindings_basics/py_bindings_basics.rst b/source/py_tutorials/py_bindings/py_bindings_basics/py_bindings_basics.rst
new file mode 100644
index 0000000..7334123
--- /dev/null
+++ b/source/py_tutorials/py_bindings/py_bindings_basics/py_bindings_basics.rst
@@ -0,0 +1,112 @@
+.. _Bindings_Basics:
+
+How OpenCV-Python Bindings Works?
+************************************
+
+Goal
+=====
+
+Learn:
+    
+    * How OpenCV-Python bindings are generated?
+    * How to extend new OpenCV modules to Python?
+
+How OpenCV-Python bindings are generated?
+=========================================
+
+In OpenCV, all algorithms are implemented in C++. But these algorithms can be used from different languages like Python, Java etc. This is made possible by the bindings generator files. These files form a bridge between C++ and Python which enable users to call C++ functions from Python. To get a complete picture of what is happening background, a good knowledge of Python/C API is required. A simple example on extending C++ functions to Python can be found in official Python documentation[1]. So extending every function in OpenCV to Python by writing its wrapper function is a time-consuming task. So OpenCV does it more intelligent way. OpenCV generates these wrapper functions automatically from the C++ headers using some Python scripts which are located in ``modules/python/src2``. We will look into what they do.
+
+First, ``modules/python/CMakeFiles.txt`` is a cmake script which checks the modules to be extended to Python. It will automatically check all the modules to be extended and grab their header files. These header files contain list of all classes, functions, constants etc. for that particular modules.
+
+Second, these header files are passed to a Python script, ``modules/python/src2/gen2.py``. He is the Python bindings generator script. It calls another Python script ``modules/python/src2/hdr_parser.py``. This is the header parser file. This guy splits the complete header file into small Python lists. So these lists contain all details about a particular function, class etc. For example, a function will be parsed to get a list containing function name, return type, input arguments, argument types etc. Final list contains details of all the functions, structs, classes etc. in that header file.
+
+But header parser doesn't parse all the functions/classes in the header file. Instead, there are certain macros added to the beginning of these declarations which enables the header parser to identify functions to be parsed. These macros are added by the developer who programs the particular function. So the developer decides which functions should be extended to Python and which are not. Details of the macros will be given in next session.
+
+So header parser returns a final big list of parsed functions. Our generator script (gen2.py) will create wrapper functions for all the functions/classes/enums/structs parsed by header parser (You can find these header files during compilation in the ``build/modules/python/`` folder as ``pyopencv_generated_*.h`` files). But there may be some basic OpenCV datatypes like Mat, Vec4i, Size. They need to be extended manually. For example, a Mat type should be extended to Numpy array, Size should be extended to a tuple of two integers etc. Similarly, there may be some complex structs/classes/functions etc. which need to be extended manually. All such manual wrapper functions are placed in ``modules/python/src2/pycv2.hpp``.
+
+So now only thing left is the compilation of these wrapper files which gives us **cv2** module. So when you call a function, say ``res = equalizeHist(img1,img2)`` in Python, ``cv::Mat`` structures corresponding to ``img1``, ``img2`` and ``res`` will be formed and calls the ``equalizeHist()`` function in C++. Final result, ``res`` will be converted back into a Numpy array. So in short, almost all operations are done in C++ which gives us almost same speed as that of C++.
+
+So this is the basic version of how OpenCV-Python bindings are generated.
+
+
+How to extend new modules to Python?
+=====================================
+
+Header parser parse the header files based on some wrapper macros added to function declaration. Enumeration constants don't need any wrapper macros. They are automatically wrapped. But remaining functions, classes etc. need wrapper macros.
+
+Functions are extended using ``CV_EXPORTS_W`` macro. An example is shown below.
+
+.. code-block:: cpp
+
+    CV_EXPORTS_W void equalizeHist( InputArray src, OutputArray dst );
+
+Header parser can understand the input and output arguments from keywords like ``InputArray, OutputArray`` etc. But sometimes, we may need to hard-code inputs and outputs. For that, macros like ``CV_OUT, CV_IN_OUT`` etc. are used.
+
+.. code-block:: cpp
+
+    CV_EXPORTS_W void minEnclosingCircle( InputArray points,
+                                         CV_OUT Point2f& center, CV_OUT float& radius );
+
+For large classes also, ``CV_EXPORTS_W`` is used. To extend class methods, ``CV_WRAP`` is used. Similarly, ``CV_PROP`` is used for class fields. 
+
+.. code-block:: cpp
+
+    class CV_EXPORTS_W CLAHE : public Algorithm
+    {
+    public:
+        CV_WRAP virtual void apply(InputArray src, OutputArray dst) = 0;
+    
+        CV_WRAP virtual void setClipLimit(double clipLimit) = 0;
+        CV_WRAP virtual double getClipLimit() const = 0;
+    }
+
+Overloaded functions can be extended using ``CV_EXPORTS_AS``. But we need to pass a new name so that each function will be called by that name in Python. Take the case of integral function below. Three functions are available, so each one is named with a suffix in Python. Similarly ``CV_WRAP_AS`` can be used to wrap overloaded methods.
+
+.. code-block:: cpp
+
+    //! computes the integral image
+    CV_EXPORTS_W void integral( InputArray src, OutputArray sum, int sdepth = -1 );
+    
+    //! computes the integral image and integral for the squared image
+    CV_EXPORTS_AS(integral2) void integral( InputArray src, OutputArray sum,
+                                            OutputArray sqsum, int sdepth = -1, int sqdepth = -1 );
+    
+    //! computes the integral image, integral for the squared image and the tilted integral image
+    CV_EXPORTS_AS(integral3) void integral( InputArray src, OutputArray sum,
+                                            OutputArray sqsum, OutputArray tilted,
+                                            int sdepth = -1, int sqdepth = -1 );
+     
+Small classes/structs are extended using ``CV_EXPORTS_W_SIMPLE``. These structs are passed by value to C++ functions. Examples are KeyPoint, Match etc. Their methods are extended by ``CV_WRAP`` and fields are extended by ``CV_PROP_RW``. 
+
+.. code-block:: cpp
+
+    class CV_EXPORTS_W_SIMPLE DMatch
+    {
+    public:
+        CV_WRAP DMatch();
+        CV_WRAP DMatch(int _queryIdx, int _trainIdx, float _distance);
+        CV_WRAP DMatch(int _queryIdx, int _trainIdx, int _imgIdx, float _distance);
+    
+        CV_PROP_RW int queryIdx; // query descriptor index
+        CV_PROP_RW int trainIdx; // train descriptor index
+        CV_PROP_RW int imgIdx;   // train image index
+    
+        CV_PROP_RW float distance;
+    };
+
+Some other small classes/structs can be exported using ``CV_EXPORTS_W_MAP`` where it is exported to a Python native dictionary. Moments() is an example of it.
+
+.. code-block:: cpp
+
+    class CV_EXPORTS_W_MAP Moments
+    {
+    public:
+        //! spatial moments
+        CV_PROP_RW double  m00, m10, m01, m20, m11, m02, m30, m21, m12, m03;
+        //! central moments
+        CV_PROP_RW double  mu20, mu11, mu02, mu30, mu21, mu12, mu03;
+        //! central normalized moments
+        CV_PROP_RW double  nu20, nu11, nu02, nu30, nu21, nu12, nu03;
+    };
+
+So these are the major extension macros available in OpenCV.
diff --git a/source/py_tutorials/py_bindings/py_table_of_contents_bindings/images/inpainticon.jpg b/source/py_tutorials/py_bindings/py_table_of_contents_bindings/images/inpainticon.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..dc22cf0377a5600a2f6ecd6fe51767f555cb05db
GIT binary patch
literal 5020
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

literal 0
HcmV?d00001

diff --git a/source/py_tutorials/py_bindings/py_table_of_contents_bindings/images/nlm_icon.jpg b/source/py_tutorials/py_bindings/py_table_of_contents_bindings/images/nlm_icon.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..0861964b9cd7fd2fff6fc1dffc62f725b3900505
GIT binary patch
literal 3735
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

literal 0
HcmV?d00001

diff --git a/source/py_tutorials/py_bindings/py_table_of_contents_bindings/py_table_of_contents_bindings.rst b/source/py_tutorials/py_bindings/py_table_of_contents_bindings/py_table_of_contents_bindings.rst
new file mode 100644
index 0000000..70c40b5
--- /dev/null
+++ b/source/py_tutorials/py_bindings/py_table_of_contents_bindings/py_table_of_contents_bindings.rst
@@ -0,0 +1,36 @@
+.. _PY_Table-Of-Content-Bindings:
+
+
+OpenCV-Python Bindings
+--------------------------------
+
+Here, you will learn how OpenCV-Python bindings are generated.
+
+
+*  :ref:`Bindings_Basics`
+
+  .. tabularcolumns:: m{100pt} m{300pt}
+  .. cssclass:: toctableopencv
+
+  =========== ======================================================
+  |bind1|      Learn how OpenCV-Python bindings are generated.
+
+  =========== ======================================================
+
+  .. |bind1|  image:: images/nlm_icon.jpg
+                 :height: 90pt
+                 :width:  90pt
+                 
+
+             
+                 
+               
+.. raw:: latex
+
+   \pagebreak
+
+.. We use a custom table of content format and as the table of content only informs Sphinx about the hierarchy of the files, no need to show it.
+.. toctree::
+   :hidden:
+
+   ../py_bindings_basics/py_bindings_basics
diff --git a/source/py_tutorials/py_tutorials.rst b/source/py_tutorials/py_tutorials.rst
index e4818ec..c3e9a0e 100644
--- a/source/py_tutorials/py_tutorials.rst
+++ b/source/py_tutorials/py_tutorials.rst
@@ -159,6 +159,20 @@ OpenCV-Python Tutorials
                  :alt: OD Icon
 
 
+*  :ref:`PY_Table-Of-Content-Bindings`
+
+   .. tabularcolumns:: m{100pt} m{300pt}
+   .. cssclass:: toctableopencv
+
+   =========== =====================================================================
+   |PyBin|     In this section, we will see how OpenCV-Python bindings are generated
+
+   =========== =====================================================================
+
+   .. |PyBin| image:: images/obj_icon.jpg
+                 :height: 80pt
+                 :width:  80pt
+                 :alt: OD Icon
                  
 .. raw:: latex
 
@@ -178,6 +192,4 @@ OpenCV-Python Tutorials
    py_ml/py_table_of_contents_ml/py_table_of_contents_ml
    py_photo/py_table_of_contents_photo/py_table_of_contents_photo
    py_objdetect/py_table_of_contents_objdetect/py_table_of_contents_objdetect
-   
-
-                             
+   py_bindings/py_table_of_contents_bindings/py_table_of_contents_bindings

From 435328569162104db9c14f718f4ba170d1206470 Mon Sep 17 00:00:00 2001
From: abidrahmank <abidrahman2@gmail.com>
Date: Sun, 10 Aug 2014 11:53:46 +0530
Subject: [PATCH 3/3] updated bindings section

---
 .../.py_bindings_basics.rst.swp                 | Bin 20480 -> 0 bytes
 .../py_bindings_basics/py_bindings_basics.rst   |  14 +++++++-------
 2 files changed, 7 insertions(+), 7 deletions(-)
 delete mode 100644 source/py_tutorials/py_bindings/py_bindings_basics/.py_bindings_basics.rst.swp

diff --git a/source/py_tutorials/py_bindings/py_bindings_basics/.py_bindings_basics.rst.swp b/source/py_tutorials/py_bindings/py_bindings_basics/.py_bindings_basics.rst.swp
deleted file mode 100644
index 96597f450e4848c194a2b2f4100debc670df067b..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 20480
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
W74ldij}`J*xKD?l1)qNMSpNW%h@z|j

diff --git a/source/py_tutorials/py_bindings/py_bindings_basics/py_bindings_basics.rst b/source/py_tutorials/py_bindings/py_bindings_basics/py_bindings_basics.rst
index 7334123..7e48930 100644
--- a/source/py_tutorials/py_bindings/py_bindings_basics/py_bindings_basics.rst
+++ b/source/py_tutorials/py_bindings/py_bindings_basics/py_bindings_basics.rst
@@ -14,17 +14,17 @@ Learn:
 How OpenCV-Python bindings are generated?
 =========================================
 
-In OpenCV, all algorithms are implemented in C++. But these algorithms can be used from different languages like Python, Java etc. This is made possible by the bindings generator files. These files form a bridge between C++ and Python which enable users to call C++ functions from Python. To get a complete picture of what is happening background, a good knowledge of Python/C API is required. A simple example on extending C++ functions to Python can be found in official Python documentation[1]. So extending every function in OpenCV to Python by writing its wrapper function is a time-consuming task. So OpenCV does it more intelligent way. OpenCV generates these wrapper functions automatically from the C++ headers using some Python scripts which are located in ``modules/python/src2``. We will look into what they do.
+In OpenCV, all algorithms are implemented in C++. But these algorithms can be used from different languages like Python, Java etc. This is made possible by the bindings generators. These generators create a bridge between C++ and Python which enables users to call C++ functions from Python. To get a complete picture of what is happening in background, a good knowledge of Python/C API is required. A simple example on extending C++ functions to Python can be found in official Python documentation[1]. So extending all functions in OpenCV to Python by writing their wrapper functions manually is a time-consuming task. So OpenCV does it in a  more intelligent way. OpenCV generates these wrapper functions automatically from the C++ headers using some Python scripts which are located in ``modules/python/src2``. We will look into what they do.
 
-First, ``modules/python/CMakeFiles.txt`` is a cmake script which checks the modules to be extended to Python. It will automatically check all the modules to be extended and grab their header files. These header files contain list of all classes, functions, constants etc. for that particular modules.
+First, ``modules/python/CMakeFiles.txt`` is a CMake script which checks the modules to be extended to Python. It will automatically check all the modules to be extended and grab their header files. These header files contain list of all classes, functions, constants etc. for that particular modules.
 
-Second, these header files are passed to a Python script, ``modules/python/src2/gen2.py``. He is the Python bindings generator script. It calls another Python script ``modules/python/src2/hdr_parser.py``. This is the header parser file. This guy splits the complete header file into small Python lists. So these lists contain all details about a particular function, class etc. For example, a function will be parsed to get a list containing function name, return type, input arguments, argument types etc. Final list contains details of all the functions, structs, classes etc. in that header file.
+Second, these header files are passed to a Python script, ``modules/python/src2/gen2.py``. This is the Python bindings generator script. It calls another Python script ``modules/python/src2/hdr_parser.py``. This is the header parser script. This header parser splits the complete header file into small Python lists. So these lists contain all details about a particular function, class etc. For example, a function will be parsed to get a list containing function name, return type, input arguments, argument types etc. Final list contains details of all the functions, structs, classes etc. in that header file.
 
-But header parser doesn't parse all the functions/classes in the header file. Instead, there are certain macros added to the beginning of these declarations which enables the header parser to identify functions to be parsed. These macros are added by the developer who programs the particular function. So the developer decides which functions should be extended to Python and which are not. Details of the macros will be given in next session.
+But header parser doesn't parse all the functions/classes in the header file. The developer has to specify which functions should be exported to Python. For that, there are certain macros added to the beginning of these declarations which enables the header parser to identify functions to be parsed. These macros are added by the developer who programs the particular function. In short, the developer decides which functions should be extended to Python and which are not. Details of those macros will be given in next session.
 
 So header parser returns a final big list of parsed functions. Our generator script (gen2.py) will create wrapper functions for all the functions/classes/enums/structs parsed by header parser (You can find these header files during compilation in the ``build/modules/python/`` folder as ``pyopencv_generated_*.h`` files). But there may be some basic OpenCV datatypes like Mat, Vec4i, Size. They need to be extended manually. For example, a Mat type should be extended to Numpy array, Size should be extended to a tuple of two integers etc. Similarly, there may be some complex structs/classes/functions etc. which need to be extended manually. All such manual wrapper functions are placed in ``modules/python/src2/pycv2.hpp``.
 
-So now only thing left is the compilation of these wrapper files which gives us **cv2** module. So when you call a function, say ``res = equalizeHist(img1,img2)`` in Python, ``cv::Mat`` structures corresponding to ``img1``, ``img2`` and ``res`` will be formed and calls the ``equalizeHist()`` function in C++. Final result, ``res`` will be converted back into a Numpy array. So in short, almost all operations are done in C++ which gives us almost same speed as that of C++.
+So now only thing left is the compilation of these wrapper files which gives us **cv2** module. So when you call a function, say ``res = equalizeHist(img1,img2)`` in Python, you pass two numpy arrays and you expect another numpy array as the output. So these numpy arrays are converted to ``cv::Mat`` and then calls the ``equalizeHist()`` function in C++. Final result, ``res`` will be converted back into a Numpy array. So in short, almost all operations are done in C++ which gives us almost same speed as that of C++.
 
 So this is the basic version of how OpenCV-Python bindings are generated.
 
@@ -40,7 +40,7 @@ Functions are extended using ``CV_EXPORTS_W`` macro. An example is shown below.
 
     CV_EXPORTS_W void equalizeHist( InputArray src, OutputArray dst );
 
-Header parser can understand the input and output arguments from keywords like ``InputArray, OutputArray`` etc. But sometimes, we may need to hard-code inputs and outputs. For that, macros like ``CV_OUT, CV_IN_OUT`` etc. are used.
+Header parser can understand the input and output arguments from keywords like ``InputArray, OutputArray`` etc. But sometimes, we may need to hardcode inputs and outputs. For that, macros like ``CV_OUT, CV_IN_OUT`` etc. are used.
 
 .. code-block:: cpp
 
@@ -109,4 +109,4 @@ Some other small classes/structs can be exported using ``CV_EXPORTS_W_MAP`` wher
         CV_PROP_RW double  nu20, nu11, nu02, nu30, nu21, nu12, nu03;
     };
 
-So these are the major extension macros available in OpenCV.
+So these are the major extension macros available in OpenCV. Typically, a developer has to put proper macros in their appropriate positions. Rest is done by generator scripts. Sometimes, there may be an exceptional cases where generator scripts cannot create the wrappers. Such functions need to be handled manually. But most of the time, a code written according to OpenCV coding guidelines will be automatically wrapped by generator scripts.