Robertson docs
authorFedor Morozov <f-morozov@ya.ru>
Fri, 6 Sep 2013 14:21:59 +0000 (18:21 +0400)
committerFedor Morozov <f-morozov@ya.ru>
Fri, 6 Sep 2013 14:21:59 +0000 (18:21 +0400)
modules/photo/doc/hdr_imaging.rst

index 56b74a6..042f888 100644 (file)
@@ -204,7 +204,7 @@ Computes median threshold and exclude bitmaps of given image.
     :param tb: median threshold bitmap
     
     :param eb: exclude bitmap
-       
+    
 createAlignMTB
 ---------------------------
 Creates AlignMTB object
@@ -214,8 +214,8 @@ Creates AlignMTB object
     :param max_bits: logarithm to the base 2 of maximal shift in each dimension. Values of 5 and 6 are usually good enough (31 and 63 pixels shift respectively).
     
     :param exclude_range: range for exclusion bitmap that is constructed to suppress noise around the median value.
-       
-       :param cut: if true cuts images, otherwise fills the new regions with zeros.
+    
+    :param cut: if true cuts images, otherwise fills the new regions with zeros.
     
 ExposureCalibrate
 ---------------------------
@@ -253,8 +253,27 @@ Creates CalibrateDebevec object
     :param samples: number of pixel locations to use
     
     :param lambda: smoothness term weight. Greater values produce smoother results, but can alter the response.
-       
-       :param random: if true sample pixel locations are chosen at random, otherwise the form a rectangular grid.
+    
+    :param random: if true sample pixel locations are chosen at random, otherwise the form a rectangular grid.
+    
+CalibrateRobertson
+---------------------------
+.. ocv:class:: CalibrateRobertson : public ExposureCalibrate
+
+Inverse camera response function is extracted for each brightness value by minimizing an objective function as linear system.
+This algorithm uses all image pixels.
+
+For more information see [RB99]_.
+
+createCalibrateRobertson
+---------------------------
+Creates CalibrateRobertson object
+
+.. ocv:function:: createCalibrateRobertson(int max_iter = 30, float threshold = 0.01f)
+
+    :param max_iter: maximal number of Gauss-Seidel solver iterations.
+    
+    :param threshold: target difference between results of two successive steps of the minimization.
     
 ExposureMerge
 ---------------------------
@@ -312,7 +331,6 @@ Short version of process, that doesn't take extra arguments.
    
     :param dst: result image
 
-
 createMergeMertens
 ---------------------------
 Creates MergeMertens object
@@ -324,6 +342,20 @@ Creates MergeMertens object
     :param saturation_weight: saturation measure weight
     
     :param exposure_weight: well-exposedness measure weight
+
+MergeRobertson
+---------------------------
+.. ocv:class:: MergeRobertson : public ExposureMerge
+
+The resulting HDR image is calculated as weighted average of the exposures considering exposure values and camera response.
+
+For more information see [RB99]_.
+
+createMergeRobertson
+---------------------------
+Creates MergeRobertson object
+
+.. ocv:function:: Ptr<MergeRobertson> createMergeRobertson()
     
 References
 ==========
@@ -343,3 +375,5 @@ References
 .. [DM97] P. Debevec, J. Malik, "Recovering High Dynamic Range Radiance Maps from Photographs", Proceedings OF ACM SIGGRAPH, 1997, 369 - 378.
 
 .. [MK07] T. Mertens, J. Kautz, F. Van Reeth, "Exposure Fusion", Proceedings of the 15th Pacific Conference on Computer Graphics and Applications, 2007, 382 - 390.
+
+.. [RB99]  M. Robertson , S. Borman , R. Stevenson , "Dynamic range improvement through multiple exposures ", Proceedings of the Int. Conf. on Image Processing , 1999, 159 - 163.