From a7bcf63765995676a7bb999df49a3001ec245fb9 Mon Sep 17 00:00:00 2001 From: Fedor Morozov Date: Fri, 6 Sep 2013 18:21:59 +0400 Subject: [PATCH] Robertson docs --- modules/photo/doc/hdr_imaging.rst | 46 ++++++++++++++++++++++++++++++++++----- 1 file changed, 40 insertions(+), 6 deletions(-) diff --git a/modules/photo/doc/hdr_imaging.rst b/modules/photo/doc/hdr_imaging.rst index 56b74a6..042f888 100644 --- a/modules/photo/doc/hdr_imaging.rst +++ b/modules/photo/doc/hdr_imaging.rst @@ -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 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. -- 2.7.4