Renesas / opencv-lib

openCV library for Renesas RZ/A

Dependents:   RZ_A2M_Mbed_samples

include/opencv2/stitching/detail/exposure_compensate.hpp@0:0e0631af0305, 2021-01-29 (annotated)

Committer:
RyoheiHagimoto
Date:
Fri Jan 29 04:53:38 2021 +0000
Revision:
0:0e0631af0305
copied from https://github.com/d-kato/opencv-lib.

Who changed what in which revision?

UserRevisionLine numberNew contents of line
RyoheiHagimoto 0:0e0631af0305 1 /*M///////////////////////////////////////////////////////////////////////////////////////
RyoheiHagimoto 0:0e0631af0305 2 //
RyoheiHagimoto 0:0e0631af0305 3 // IMPORTANT: READ BEFORE DOWNLOADING, COPYING, INSTALLING OR USING.
RyoheiHagimoto 0:0e0631af0305 4 //
RyoheiHagimoto 0:0e0631af0305 5 // By downloading, copying, installing or using the software you agree to this license.
RyoheiHagimoto 0:0e0631af0305 6 // If you do not agree to this license, do not download, install,
RyoheiHagimoto 0:0e0631af0305 7 // copy or use the software.
RyoheiHagimoto 0:0e0631af0305 8 //
RyoheiHagimoto 0:0e0631af0305 9 //
RyoheiHagimoto 0:0e0631af0305 10 // License Agreement
RyoheiHagimoto 0:0e0631af0305 11 // For Open Source Computer Vision Library
RyoheiHagimoto 0:0e0631af0305 12 //
RyoheiHagimoto 0:0e0631af0305 13 // Copyright (C) 2000-2008, Intel Corporation, all rights reserved.
RyoheiHagimoto 0:0e0631af0305 14 // Copyright (C) 2009, Willow Garage Inc., all rights reserved.
RyoheiHagimoto 0:0e0631af0305 15 // Third party copyrights are property of their respective owners.
RyoheiHagimoto 0:0e0631af0305 16 //
RyoheiHagimoto 0:0e0631af0305 17 // Redistribution and use in source and binary forms, with or without modification,
RyoheiHagimoto 0:0e0631af0305 18 // are permitted provided that the following conditions are met:
RyoheiHagimoto 0:0e0631af0305 19 //
RyoheiHagimoto 0:0e0631af0305 20 // * Redistribution's of source code must retain the above copyright notice,
RyoheiHagimoto 0:0e0631af0305 21 // this list of conditions and the following disclaimer.
RyoheiHagimoto 0:0e0631af0305 22 //
RyoheiHagimoto 0:0e0631af0305 23 // * Redistribution's in binary form must reproduce the above copyright notice,
RyoheiHagimoto 0:0e0631af0305 24 // this list of conditions and the following disclaimer in the documentation
RyoheiHagimoto 0:0e0631af0305 25 // and/or other materials provided with the distribution.
RyoheiHagimoto 0:0e0631af0305 26 //
RyoheiHagimoto 0:0e0631af0305 27 // * The name of the copyright holders may not be used to endorse or promote products
RyoheiHagimoto 0:0e0631af0305 28 // derived from this software without specific prior written permission.
RyoheiHagimoto 0:0e0631af0305 29 //
RyoheiHagimoto 0:0e0631af0305 30 // This software is provided by the copyright holders and contributors "as is" and
RyoheiHagimoto 0:0e0631af0305 31 // any express or implied warranties, including, but not limited to, the implied
RyoheiHagimoto 0:0e0631af0305 32 // warranties of merchantability and fitness for a particular purpose are disclaimed.
RyoheiHagimoto 0:0e0631af0305 33 // In no event shall the Intel Corporation or contributors be liable for any direct,
RyoheiHagimoto 0:0e0631af0305 34 // indirect, incidental, special, exemplary, or consequential damages
RyoheiHagimoto 0:0e0631af0305 35 // (including, but not limited to, procurement of substitute goods or services;
RyoheiHagimoto 0:0e0631af0305 36 // loss of use, data, or profits; or business interruption) however caused
RyoheiHagimoto 0:0e0631af0305 37 // and on any theory of liability, whether in contract, strict liability,
RyoheiHagimoto 0:0e0631af0305 38 // or tort (including negligence or otherwise) arising in any way out of
RyoheiHagimoto 0:0e0631af0305 39 // the use of this software, even if advised of the possibility of such damage.
RyoheiHagimoto 0:0e0631af0305 40 //
RyoheiHagimoto 0:0e0631af0305 41 //M*/
RyoheiHagimoto 0:0e0631af0305 42
RyoheiHagimoto 0:0e0631af0305 43 #ifndef OPENCV_STITCHING_EXPOSURE_COMPENSATE_HPP
RyoheiHagimoto 0:0e0631af0305 44 #define OPENCV_STITCHING_EXPOSURE_COMPENSATE_HPP
RyoheiHagimoto 0:0e0631af0305 45
RyoheiHagimoto 0:0e0631af0305 46 #if defined(NO)
RyoheiHagimoto 0:0e0631af0305 47 # warning Detected Apple 'NO' macro definition, it can cause build conflicts. Please, include this header before any Apple headers.
RyoheiHagimoto 0:0e0631af0305 48 #endif
RyoheiHagimoto 0:0e0631af0305 49
RyoheiHagimoto 0:0e0631af0305 50 #include "opencv2/core.hpp"
RyoheiHagimoto 0:0e0631af0305 51
RyoheiHagimoto 0:0e0631af0305 52 namespace cv {
RyoheiHagimoto 0:0e0631af0305 53 namespace detail {
RyoheiHagimoto 0:0e0631af0305 54
RyoheiHagimoto 0:0e0631af0305 55 //! @addtogroup stitching_exposure
RyoheiHagimoto 0:0e0631af0305 56 //! @{
RyoheiHagimoto 0:0e0631af0305 57
RyoheiHagimoto 0:0e0631af0305 58 /** @brief Base class for all exposure compensators.
RyoheiHagimoto 0:0e0631af0305 59 */
RyoheiHagimoto 0:0e0631af0305 60 class CV_EXPORTS ExposureCompensator
RyoheiHagimoto 0:0e0631af0305 61 {
RyoheiHagimoto 0:0e0631af0305 62 public:
RyoheiHagimoto 0:0e0631af0305 63 virtual ~ExposureCompensator() {}
RyoheiHagimoto 0:0e0631af0305 64
RyoheiHagimoto 0:0e0631af0305 65 enum { NO, GAIN, GAIN_BLOCKS };
RyoheiHagimoto 0:0e0631af0305 66 static Ptr<ExposureCompensator> createDefault(int type);
RyoheiHagimoto 0:0e0631af0305 67
RyoheiHagimoto 0:0e0631af0305 68 /**
RyoheiHagimoto 0:0e0631af0305 69 @param corners Source image top-left corners
RyoheiHagimoto 0:0e0631af0305 70 @param images Source images
RyoheiHagimoto 0:0e0631af0305 71 @param masks Image masks to update (second value in pair specifies the value which should be used
RyoheiHagimoto 0:0e0631af0305 72 to detect where image is)
RyoheiHagimoto 0:0e0631af0305 73 */
RyoheiHagimoto 0:0e0631af0305 74 void feed(const std::vector<Point> &corners, const std::vector<UMat> &images,
RyoheiHagimoto 0:0e0631af0305 75 const std::vector<UMat> &masks);
RyoheiHagimoto 0:0e0631af0305 76 /** @overload */
RyoheiHagimoto 0:0e0631af0305 77 virtual void feed(const std::vector<Point> &corners, const std::vector<UMat> &images,
RyoheiHagimoto 0:0e0631af0305 78 const std::vector<std::pair<UMat,uchar> > &masks) = 0;
RyoheiHagimoto 0:0e0631af0305 79 /** @brief Compensate exposure in the specified image.
RyoheiHagimoto 0:0e0631af0305 80
RyoheiHagimoto 0:0e0631af0305 81 @param index Image index
RyoheiHagimoto 0:0e0631af0305 82 @param corner Image top-left corner
RyoheiHagimoto 0:0e0631af0305 83 @param image Image to process
RyoheiHagimoto 0:0e0631af0305 84 @param mask Image mask
RyoheiHagimoto 0:0e0631af0305 85 */
RyoheiHagimoto 0:0e0631af0305 86 virtual void apply(int index, Point corner, InputOutputArray image, InputArray mask) = 0;
RyoheiHagimoto 0:0e0631af0305 87 };
RyoheiHagimoto 0:0e0631af0305 88
RyoheiHagimoto 0:0e0631af0305 89 /** @brief Stub exposure compensator which does nothing.
RyoheiHagimoto 0:0e0631af0305 90 */
RyoheiHagimoto 0:0e0631af0305 91 class CV_EXPORTS NoExposureCompensator : public ExposureCompensator
RyoheiHagimoto 0:0e0631af0305 92 {
RyoheiHagimoto 0:0e0631af0305 93 public:
RyoheiHagimoto 0:0e0631af0305 94 void feed(const std::vector<Point> &/*corners*/, const std::vector<UMat> &/*images*/,
RyoheiHagimoto 0:0e0631af0305 95 const std::vector<std::pair<UMat,uchar> > &/*masks*/) { }
RyoheiHagimoto 0:0e0631af0305 96 void apply(int /*index*/, Point /*corner*/, InputOutputArray /*image*/, InputArray /*mask*/) { }
RyoheiHagimoto 0:0e0631af0305 97 };
RyoheiHagimoto 0:0e0631af0305 98
RyoheiHagimoto 0:0e0631af0305 99 /** @brief Exposure compensator which tries to remove exposure related artifacts by adjusting image
RyoheiHagimoto 0:0e0631af0305 100 intensities, see @cite BL07 and @cite WJ10 for details.
RyoheiHagimoto 0:0e0631af0305 101 */
RyoheiHagimoto 0:0e0631af0305 102 class CV_EXPORTS GainCompensator : public ExposureCompensator
RyoheiHagimoto 0:0e0631af0305 103 {
RyoheiHagimoto 0:0e0631af0305 104 public:
RyoheiHagimoto 0:0e0631af0305 105 void feed(const std::vector<Point> &corners, const std::vector<UMat> &images,
RyoheiHagimoto 0:0e0631af0305 106 const std::vector<std::pair<UMat,uchar> > &masks);
RyoheiHagimoto 0:0e0631af0305 107 void apply(int index, Point corner, InputOutputArray image, InputArray mask);
RyoheiHagimoto 0:0e0631af0305 108 std::vector<double> gains() const;
RyoheiHagimoto 0:0e0631af0305 109
RyoheiHagimoto 0:0e0631af0305 110 private:
RyoheiHagimoto 0:0e0631af0305 111 Mat_<double> gains_;
RyoheiHagimoto 0:0e0631af0305 112 };
RyoheiHagimoto 0:0e0631af0305 113
RyoheiHagimoto 0:0e0631af0305 114 /** @brief Exposure compensator which tries to remove exposure related artifacts by adjusting image block
RyoheiHagimoto 0:0e0631af0305 115 intensities, see @cite UES01 for details.
RyoheiHagimoto 0:0e0631af0305 116 */
RyoheiHagimoto 0:0e0631af0305 117 class CV_EXPORTS BlocksGainCompensator : public ExposureCompensator
RyoheiHagimoto 0:0e0631af0305 118 {
RyoheiHagimoto 0:0e0631af0305 119 public:
RyoheiHagimoto 0:0e0631af0305 120 BlocksGainCompensator(int bl_width = 32, int bl_height = 32)
RyoheiHagimoto 0:0e0631af0305 121 : bl_width_(bl_width), bl_height_(bl_height) {}
RyoheiHagimoto 0:0e0631af0305 122 void feed(const std::vector<Point> &corners, const std::vector<UMat> &images,
RyoheiHagimoto 0:0e0631af0305 123 const std::vector<std::pair<UMat,uchar> > &masks);
RyoheiHagimoto 0:0e0631af0305 124 void apply(int index, Point corner, InputOutputArray image, InputArray mask);
RyoheiHagimoto 0:0e0631af0305 125
RyoheiHagimoto 0:0e0631af0305 126 private:
RyoheiHagimoto 0:0e0631af0305 127 int bl_width_, bl_height_;
RyoheiHagimoto 0:0e0631af0305 128 std::vector<UMat> gain_maps_;
RyoheiHagimoto 0:0e0631af0305 129 };
RyoheiHagimoto 0:0e0631af0305 130
RyoheiHagimoto 0:0e0631af0305 131 //! @}
RyoheiHagimoto 0:0e0631af0305 132
RyoheiHagimoto 0:0e0631af0305 133 } // namespace detail
RyoheiHagimoto 0:0e0631af0305 134 } // namespace cv
RyoheiHagimoto 0:0e0631af0305 135
RyoheiHagimoto 0:0e0631af0305 136 #endif // OPENCV_STITCHING_EXPOSURE_COMPENSATE_HPP