slic.hpp

/*********************************************************************





* Software License Agreement (BSD License)





*





* Copyright (c) 2013





* Radhakrishna Achanta





* email : Radhakrishna [dot] Achanta [at] epfl [dot] ch





* web : http://ivrl.epfl.ch/people/achanta





*





*  Redistribution and use in source and binary forms, with or without





*  modification, are permitted provided that the following conditions





*  are met:





*





*   * Redistributions of source code must retain the above copyright





*     notice, this list of conditions and the following disclaimer.





*   * Redistributions 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.





*   * Neither the name of the copyright holders nor the names of its





*     contributors may 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





*  COPYRIGHT OWNER 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.





*********************************************************************/








/*





"SLIC Superpixels Compared to State-of-the-art Superpixel Methods"





Radhakrishna Achanta, Appu Shaji, Kevin Smith, Aurelien Lucchi, Pascal Fua,





and Sabine Susstrunk, IEEE TPAMI, Volume 34, Issue 11, Pages 2274-2282,





November 2012.










"SLIC Superpixels" Radhakrishna Achanta, Appu Shaji, Kevin Smith,





Aurelien Lucchi, Pascal Fua, and Sabine Süsstrunk, EPFL Technical





Report no. 149300, June 2010.










OpenCV port by: Cristian Balint <cristian dot balint at gmail dot com>





*/








#ifndef __OPENCV_SLIC_HPP__




#define __OPENCV_SLIC_HPP__




#ifdef __cplusplus








#include <opencv2/core.hpp>








namespace

cv



{



namespace
ximgproc


{











enum
SLICType { SLIC = 100, SLICO = 101, MSLIC = 102 };







class
CV_EXPORTS_W SuperpixelSLIC :
public
Algorithm


{



public:







CV_WRAP
virtual
int
getNumberOfSuperpixels()
const
= 0;







CV_WRAP
virtual
void
iterate(
int
num_iterations = 10 ) = 0;







CV_WRAP
virtual
void
getLabels( OutputArray labels_out )
const
= 0;







CV_WRAP
virtual
void
getLabelContourMask( OutputArray image,
bool
thick_line =
true
)
const
= 0;







CV_WRAP
virtual
void
enforceLabelConnectivity(
int
min_element_size = 25 ) = 0;










};







CV_EXPORTS_W Ptr<SuperpixelSLIC> createSuperpixelSLIC( InputArray image,
int
algorithm = SLICO,



int
region_size = 10,
float
ruler = 10.0f );










}


}



#endif




#endif