Exposure Compensation

detail::ExposureCompensator

class detail::ExposureCompensator

Base class for all exposure compensators.

class CV_EXPORTS ExposureCompensator
{
public:
    virtual ~ExposureCompensator() {}

    enum { NO, GAIN, GAIN_BLOCKS };
    static Ptr<ExposureCompensator> createDefault(int type);

    void feed(const std::vector<Point> &corners, const std::vector<Mat> &images,
              const std::vector<Mat> &masks);
    virtual void feed(const std::vector<Point> &corners, const std::vector<Mat> &images,
                      const std::vector<std::pair<Mat,uchar> > &masks) = 0;
    virtual void apply(int index, Point corner, Mat &image, const Mat &mask) = 0;
};

detail::ExposureCompensator::feed

C++: void detail::ExposureCompensator::feed(const std::vector<Point>& corners, const std::vector<UMat>& images, const std::vector<UMat>& masks)
C++: void detail::ExposureCompensator::feed(const std::vector<Point>& corners, const std::vector<UMat>& images, const std::vector<std::pair<UMat, uchar>>& masks)
Parameters:
  • corners – Source image top-left corners
  • images – Source images
  • masks – Image masks to update (second value in pair specifies the value which should be used to detect where image is)

detil::ExposureCompensator::apply

Compensate exposure in the specified image.

C++: void detail::ExposureCompensator::apply(int index, Point corner, InputOutputArray image, InputArray mask)
Parameters:
  • index – Image index
  • corner – Image top-left corner
  • image – Image to process
  • mask – Image mask

detail::NoExposureCompensator

class detail::NoExposureCompensator : public detail::ExposureCompensator

Stub exposure compensator which does nothing.

class CV_EXPORTS NoExposureCompensator : public ExposureCompensator
{
public:
    void feed(const std::vector<Point> &/*corners*/, const std::vector<Mat> &/*images*/,
              const std::vector<std::pair<Mat,uchar> > &/*masks*/) { }
    void apply(int /*index*/, Point /*corner*/, Mat &/*image*/, const Mat &/*mask*/) { }
};

detail::GainCompensator

class detail::GainCompensator : public detail::ExposureCompensator

Exposure compensator which tries to remove exposure related artifacts by adjusting image intensities, see [BL07] and [WJ10] for details.

class CV_EXPORTS GainCompensator : public ExposureCompensator
{
public:
    void feed(const std::vector<Point> &corners, const std::vector<Mat> &images,
              const std::vector<std::pair<Mat,uchar> > &masks);
    void apply(int index, Point corner, Mat &image, const Mat &mask);
    std::vector<double> gains() const;

private:
    /* hidden */
};

detail::BlocksGainCompensator

class detail::BlocksGainCompensator : public detail::ExposureCompensator

Exposure compensator which tries to remove exposure related artifacts by adjusting image block intensities, see [UES01] for details.

class CV_EXPORTS BlocksGainCompensator : public ExposureCompensator
{
public:
    BlocksGainCompensator(int bl_width = 32, int bl_height = 32)
            : bl_width_(bl_width), bl_height_(bl_height) {}
    void feed(const std::vector<Point> &corners, const std::vector<Mat> &images,
              const std::vector<std::pair<Mat,uchar> > &masks);
    void apply(int index, Point corner, Mat &image, const Mat &mask);

private:
    /* hidden */
};