First CommitHEADmaster

1 files changed, 83 insertions, 0 deletions

diff --git a/thirdparty/linux/include/opencv2/saliency.hpp b/thirdparty/linux/include/opencv2/saliency.hpp
new file mode 100644
index 0000000..56bfe8a
--- /dev/null
+++ b/thirdparty/linux/include/opencv2/saliency.hpp
@@ -0,0 +1,83 @@
+/*M///////////////////////////////////////////////////////////////////////////////////////
+ //
+ //  IMPORTANT: READ BEFORE DOWNLOADING, COPYING, INSTALLING OR USING.
+ //
+ //  By downloading, copying, installing or using the software you agree to this license.
+ //  If you do not agree to this license, do not download, install,
+ //  copy or use the software.
+ //
+ //
+ //                           License Agreement
+ //                For Open Source Computer Vision Library
+ //
+ // Copyright (C) 2014, OpenCV Foundation, all rights reserved.
+ // Third party copyrights are property of their respective owners.
+ //
+ // Redistribution and use in source and binary forms, with or without modification,
+ // are permitted provided that the following conditions are met:
+ //
+ //   * Redistribution's of source code must retain the above copyright notice,
+ //     this list of conditions and the following disclaimer.
+ //
+ //   * Redistribution's in binary form must reproduce the above copyright notice,
+ //     this list of conditions and the following disclaimer in the documentation
+ //     and/or other materials provided with the distribution.
+ //
+ //   * The name of the copyright holders may not be used to endorse or promote products
+ //     derived from this software without specific prior written permission.
+ //
+ // This software is provided by the copyright holders and contributors "as is" and
+ // any express or implied warranties, including, but not limited to, the implied
+ // warranties of merchantability and fitness for a particular purpose are disclaimed.
+ // In no event shall the Intel Corporation or contributors be liable for any direct,
+ // indirect, incidental, special, exemplary, or consequential damages
+ // (including, but not limited to, procurement of substitute goods or services;
+ // loss of use, data, or profits; or business interruption) however caused
+ // and on any theory of liability, whether in contract, strict liability,
+ // or tort (including negligence or otherwise) arising in any way out of
+ // the use of this software, even if advised of the possibility of such damage.
+ //
+ //M*/
+
+#ifndef __OPENCV_SALIENCY_HPP__
+#define __OPENCV_SALIENCY_HPP__
+
+#include "opencv2/saliency/saliencyBaseClasses.hpp"
+#include "opencv2/saliency/saliencySpecializedClasses.hpp"
+
+/** @defgroup saliency Saliency API
+
+Many computer vision applications may benefit from understanding where humans focus given a scene.
+Other than cognitively understanding the way human perceive images and scenes, finding salient
+regions and objects in the images helps various tasks such as speeding up object detection, object
+recognition, object tracking and content-aware image editing.
+
+About the saliency, there is a rich literature but the development is very fragmented. The principal
+purpose of this API is to give a unique interface, a unique framework for use and plug sever
+saliency algorithms, also with very different nature and methodology, but they share the same
+purpose, organizing algorithms into three main categories:
+
+**Static Saliency**: algorithms belonging to this category, exploit different image features that
+allow to detect salient objects in a non dynamic scenarios.
+
+**Motion Saliency**: algorithms belonging to this category, are particularly focused to detect
+salient objects over time (hence also over frame), then there is a temporal component sealing
+cosider that allows to detect "moving" objects as salient, meaning therefore also the more general
+sense of detection the changes in the scene.
+
+**Objectness**: Objectness is usually represented as a value which reflects how likely an image
+window covers an object of any category. Algorithms belonging to this category, avoid making
+decisions early on, by proposing a small number of category-independent proposals, that are expected
+to cover all objects in an image. Being able to perceive objects before identifying them is closely
+related to bottom up visual attention (saliency).
+
+![Saliency diagram](pics/saliency.png)
+
+To see how API works, try tracker demo:
+<https://github.com/fpuja/opencv_contrib/blob/saliencyModuleDevelop/modules/saliency/samples/computeSaliency.cpp>
+
+@note This API has been designed with PlantUML. If you modify this API please change UML.
+
+*/
+
+#endif //__OPENCV_SALIENCY_HPP__