Adds Edge-Preserving Filter

modules/ximgproc/include/opencv2/ximgproc.hpp

@@ -57,6 +57,7 @@
 #include "ximgproc/ridgefilter.hpp"
 #include "ximgproc/brightedges.hpp"
 #include "ximgproc/run_length_morphology.hpp"
+#include "ximgproc/edgepreserving_filter.hpp"
 
 
 /** @defgroup ximgproc Extended Image Processing

modules/ximgproc/include/opencv2/ximgproc/edgepreserving_filter.hpp

@@ -0,0 +1,31 @@
+// This file is part of OpenCV project.
+// It is subject to the license terms in the LICENSE file found in the top-level directory
+// of this distribution and at http://opencv.org/license.html.
+
+#ifndef __OPENCV_EDGEPRESERVINGFILTER_HPP__
+#define __OPENCV_EDGEPRESERVINGFILTER_HPP__
+
+#include <opencv2/core.hpp>
+
+namespace cv { namespace ximgproc {
+
+    //! @addtogroup ximgproc
+    //! @{
+
+    /**
+    * @brief Smoothes an image using the Edge-Preserving filter.
+    *
+    * The function smoothes Gaussian noise as well as salt & pepper noise.
+    * For more details about this implementation, please see
+    * [ReiWoe18]  Reich, S. and Wörgötter, F. and Dellen, B. (2018). A Real-Time Edge-Preserving Denoising Filter. Proceedings of the 13th International Joint Conference on Computer Vision, Imaging and Computer Graphics Theory and Applications (VISIGRAPP): Visapp, 85-94, 4. DOI: 10.5220/0006509000850094. 
+    *
+    * @param src Source 8-bit 3-channel image.
+    * @param dst Destination image of the same size and type as src.
+    * @param d Diameter of each pixel neighborhood that is used during filtering. Must be greater or equal 3..
+    * @param threshold Threshold, which distinguishes between noise, outliers, and data.
+    */
+    CV_EXPORTS_W void edgepreservingFilter( const InputArray *src, OutputArray *dst, int d, int threshold );
+
+}} // namespace
+
+#endif

modules/ximgproc/samples/edgepreserving_filter_demo.cpp

@@ -0,0 +1,47 @@
+#include <iostream>
+#include <string>
+#include <opencv2/imgcodecs.hpp>
+#include <opencv2/highgui.hpp>
+#include <opencv2/ximgproc.hpp>
+#include <opencv2/opencv.hpp>
+#include <opencv2/epf.hpp>
+
+
+using namespace cv;
+
+
+int main(int argc, char **argv)
+{
+    cv::CommandLineParser parser(argc, argv,
+        "{help h ? |     | help message}"
+        "{@image   |     | Image filename to process }"
+    );
+    if (parser.has("help") || !parser.has("image"))
+    {
+        parser.printMessage();
+        return 0;
+		}
+
+	// Load image from first parameter
+	std::string filename = parser.get<string>("@image");
+	Mat image = imread(filename, 1), res;
+
+	if (!image.data)
+	{
+		std::cerr << "No image data at " << filename << std::endl;
+		throw;
+	}
+
+	// Before filtering
+	imshow("Original image", image);
+	waitKey(0);
+
+	// Initialize filter. Kernel size 5x5, threshold 20
+	ximgproc::edgepreservingFilter(&image, &res, 5, 20);
+
+	// After filtering
+	imshow("Filtered image", res);
+	waitKey(0);
+
+	return 0;
+}