// copy or use the software.
//
//
-// Intel License Agreement
+// License Agreement
// For Open Source Computer Vision Library
//
-// Copyright (C) 2000, Intel Corporation, all rights reserved.
+// Copyright (C) 2000-2008, Intel Corporation, all rights reserved.
+// Copyright (C) 2009, Willow Garage Inc., all rights reserved.
// Third party copyrights are property of their respective owners.
//
// Redistribution and use in source and binary forms, with or without modification,
// this list of conditions and the following disclaimer in the documentation
// and/or other materials provided with the distribution.
//
-// * The name of Intel Corporation may not be used to endorse or promote products
+// * 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
//
//M*/
-//#ifdef WIN32
-
-#ifndef _CV_HPP_
-#define _CV_HPP_
-
-#include "cv.h"
+#ifndef __OPENCV_CV_HPP__
+#define __OPENCV_CV_HPP__
#ifdef __cplusplus
-#if _MSC_VER >= 1200
-
-#pragma warning(disable : 4710) /* function not inlined */
-#pragma warning(disable : 4711)
-#pragma warning(disable : 4514)
-
-#endif
-
-/* high-level C interface */
-#include <assert.h>
-
-#if defined _MSC_VER || defined __ICL || defined __BORLANDC__
-
-#define CVH_DECLARE_STORAGE
-#include "cvstorage.hpp"
+namespace cv
+{
+enum { BORDER_REPLICATE=IPL_BORDER_REPLICATE, BORDER_CONSTANT=IPL_BORDER_CONSTANT,
+ BORDER_REFLECT=IPL_BORDER_REFLECT, BORDER_REFLECT_101=IPL_BORDER_REFLECT_101,
+ BORDER_REFLECT101=BORDER_REFLECT_101, BORDER_WRAP=IPL_BORDER_WRAP,
+ BORDER_TRANSPARENT, BORDER_DEFAULT=BORDER_REFLECT_101, BORDER_ISOLATED=16 };
-/****************************************************************************************\
-* Template classes for dynamic data structures *
-\****************************************************************************************/
+CV_EXPORTS int borderInterpolate( int p, int len, int borderType );
-template<class Val> class CvArrayIterator
+class CV_EXPORTS BaseRowFilter
{
public:
- typedef Val value_type;
- typedef int idx_type;
- typedef CvArrayIterator<value_type> iterator;
-
- value_type& operator *() const {return *current;}
- idx_type get_idx() const {return current - begin;}
-
- iterator& operator ++() { current++; return *this; }
- const iterator operator ++(int) { iterator temp = *this; current++; return temp; }
-
- operator value_type*() {return *current;}
-
- CvArrayIterator() {current = begin = 0;}
- CvArrayIterator( value_type* _begin ) {begin = current = _begin;}
-
- CvArrayIterator( value_type* _begin, value_type* _current )
- {begin = _begin; current = _current;}
-
- CvArrayIterator( const iterator& another ) {*this = another;}
+ BaseRowFilter();
+ virtual ~BaseRowFilter();
+ virtual void operator()(const uchar* src, uchar* dst,
+ int width, int cn) = 0;
+ int ksize, anchor;
+};
- void init( value_type* _begin, value_type* _current )
- {begin = _begin; current = _current;}
- bool operator == ( const iterator& another ) const
- {return (current == another.current) && (begin == another.begin);}
- bool operator != ( const iterator& another ) const
- {return (current != another.current) || (begin != another.begin);}
+class CV_EXPORTS BaseColumnFilter
+{
+public:
+ BaseColumnFilter();
+ virtual ~BaseColumnFilter();
+ virtual void operator()(const uchar** src, uchar* dst, int dststep,
+ int dstcount, int width) = 0;
+ virtual void reset();
+ int ksize, anchor;
+};
- value_type* get_begin(){ return begin; }
- value_type* get_current(){ return current; }
-protected:
- value_type* current;
- value_type* begin;
+class CV_EXPORTS BaseFilter
+{
+public:
+ BaseFilter();
+ virtual ~BaseFilter();
+ virtual void operator()(const uchar** src, uchar* dst, int dststep,
+ int dstcount, int width, int cn) = 0;
+ virtual void reset();
+ Size ksize;
+ Point anchor;
};
-template<class Node> class CvTreeIterator
+class CV_EXPORTS FilterEngine
{
public:
- typedef Node node_type;
- typedef typename node_type::value_type value_type;
- typedef typename node_type::idx_type idx_type;
- typedef CvTreeIterator<node_type> iterator;
-
- value_type& operator *() { assert( node != 0 ); return node->val; }
- idx_type get_idx() { assert( node != 0 ); return node->idx; }
- node_type* get_node() { assert( node != 0 ); return node; }
+ FilterEngine();
+ FilterEngine(const Ptr<BaseFilter>& _filter2D,
+ const Ptr<BaseRowFilter>& _rowFilter,
+ const Ptr<BaseColumnFilter>& _columnFilter,
+ int srcType, int dstType, int bufType,
+ int _rowBorderType=BORDER_REPLICATE,
+ int _columnBorderType=-1,
+ const Scalar& _borderValue=Scalar());
+ virtual ~FilterEngine();
+ void init(const Ptr<BaseFilter>& _filter2D,
+ const Ptr<BaseRowFilter>& _rowFilter,
+ const Ptr<BaseColumnFilter>& _columnFilter,
+ int srcType, int dstType, int bufType,
+ int _rowBorderType=BORDER_REPLICATE, int _columnBorderType=-1,
+ const Scalar& _borderValue=Scalar());
+ virtual int start(Size wholeSize, Rect roi, int maxBufRows=-1);
+ virtual int start(const Mat& src, const Rect& srcRoi=Rect(0,0,-1,-1),
+ bool isolated=false, int maxBufRows=-1);
+ virtual int proceed(const uchar* src, int srcStep, int srcCount,
+ uchar* dst, int dstStep);
+ virtual void apply( const Mat& src, Mat& dst,
+ const Rect& srcRoi=Rect(0,0,-1,-1),
+ Point dstOfs=Point(0,0),
+ bool isolated=false);
+ bool isSeparable() const { return (const BaseFilter*)filter2D == 0; }
+ int remainingInputRows() const;
+ int remainingOutputRows() const;
- iterator operator ++();
- iterator operator ++(int);
- iterator& operator =( const iterator& _iterator )
- { node = _iterator.node; return *this; }
-
- CvTreeIterator() { node = 0; }
- CvTreeIterator( const iterator& another ) { node = another.node; }
- CvTreeIterator( node_type* root_node ) { node = root_node; }
-
- void init( node_type* _node ) { node = _node; }
+ int srcType, dstType, bufType;
+ Size ksize;
+ Point anchor;
+ int maxWidth;
+ Size wholeSize;
+ Rect roi;
+ int dx1, dx2;
+ int rowBorderType, columnBorderType;
+ vector<int> borderTab;
+ int borderElemSize;
+ vector<uchar> ringBuf;
+ vector<uchar> srcRow;
+ vector<uchar> constBorderValue;
+ vector<uchar> constBorderRow;
+ int bufStep, startY, startY0, endY, rowCount, dstY;
+ vector<uchar*> rows;
+
+ Ptr<BaseFilter> filter2D;
+ Ptr<BaseRowFilter> rowFilter;
+ Ptr<BaseColumnFilter> columnFilter;
+};
- bool operator==( const iterator& another ) { return node == another.node; }
- bool operator!=( const iterator& another ) { return node != another.node; }
+enum { KERNEL_GENERAL=0, KERNEL_SYMMETRICAL=1, KERNEL_ASYMMETRICAL=2,
+ KERNEL_SMOOTH=4, KERNEL_INTEGER=8 };
-protected:
- node_type* node;
- node_type* next();
-};
+CV_EXPORTS int getKernelType(const Mat& kernel, Point anchor);
-template<class Node> class _CvNodeManager
-{
-public:
- typedef Node node_type;
- typedef node_type::value_type value_type;
- typedef node_type::idx_type idx_type;
- typedef _CvNodeBlock<node_type> block_type;
- typedef CvNodeIterator<node_type> iterator;
- typedef _CvNodeManager<node_type> manager_type;
+CV_EXPORTS Ptr<BaseRowFilter> getLinearRowFilter(int srcType, int bufType,
+ const Mat& kernel, int anchor,
+ int symmetryType);
- _CvNodeManager();
- ~_CvNodeManager() { destroy(); }
+CV_EXPORTS Ptr<BaseColumnFilter> getLinearColumnFilter(int bufType, int dstType,
+ const Mat& kernel, int anchor,
+ int symmetryType, double delta=0,
+ int bits=0);
- void destroy();
- void clear();
- node_type* new_node();
- void release_node( node_type* _node );
+CV_EXPORTS Ptr<BaseFilter> getLinearFilter(int srcType, int dstType,
+ const Mat& kernel,
+ Point anchor=Point(-1,-1),
+ double delta=0, int bits=0);
- iterator begin() const { return iterator( first_block ); }
- iterator end() const { return iterator( last_block, block_type::block_nodes - 1 ); }
+CV_EXPORTS Ptr<FilterEngine> createSeparableLinearFilter(int srcType, int dstType,
+ const Mat& rowKernel, const Mat& columnKernel,
+ Point _anchor=Point(-1,-1), double delta=0,
+ int _rowBorderType=BORDER_DEFAULT,
+ int _columnBorderType=-1,
+ const Scalar& _borderValue=Scalar());
-protected:
- node_type* first_free;
- block_type* first_block;
- block_type* last_block;
- node_type* allocate_new_block();
-};
+CV_EXPORTS Ptr<FilterEngine> createLinearFilter(int srcType, int dstType,
+ const Mat& kernel, Point _anchor=Point(-1,-1),
+ double delta=0, int _rowBorderType=BORDER_DEFAULT,
+ int _columnBorderType=-1, const Scalar& _borderValue=Scalar());
+CV_EXPORTS Mat getGaussianKernel( int ksize, double sigma, int ktype=CV_64F );
-/************************* tree class *******************************/
-template<class Val, class Idx = int> class CvTree
-{
-public:
+CV_EXPORTS Ptr<FilterEngine> createGaussianFilter( int type, Size ksize,
+ double sigma1, double sigma2=0,
+ int borderType=BORDER_DEFAULT);
- typedef Val value_type;
- typedef Idx idx_type;
- typedef _CvTreeNode<value_type, idx_type> node_type;
- typedef _CvNodeManager<node_type> node_manager;
- typedef CvNodeIterator<node_type> raw_iterator;
- typedef CvTreeIterator<node_type> iterator;
- typedef CvTree<value_type,idx_type> storage;
+CV_EXPORTS void getDerivKernels( Mat& kx, Mat& ky, int dx, int dy, int ksize,
+ bool normalize=false, int ktype=CV_32F );
- value_type query( idx_type idx ) const;
+CV_EXPORTS Ptr<FilterEngine> createDerivFilter( int srcType, int dstType,
+ int dx, int dy, int ksize,
+ int borderType=BORDER_DEFAULT );
- value_type& operator []( idx_type idx )
- { assert( size == 0 || idx < size ); return create_node( idx )->val; }
+CV_EXPORTS Ptr<BaseRowFilter> getRowSumFilter(int srcType, int sumType,
+ int ksize, int anchor=-1);
+CV_EXPORTS Ptr<BaseColumnFilter> getColumnSumFilter(int sumType, int dstType,
+ int ksize, int anchor=-1,
+ double scale=1);
+CV_EXPORTS Ptr<FilterEngine> createBoxFilter( int srcType, int dstType, Size ksize,
+ Point anchor=Point(-1,-1),
+ bool normalize=true,
+ int borderType=BORDER_DEFAULT);
- void remove( idx_type idx );
- void clear() { root = 0; size = 0; manager.clear(); }
- void destroy() { root = 0; size = 0; manager.destroy(); }
+enum { MORPH_ERODE=0, MORPH_DILATE=1, MORPH_OPEN=2, MORPH_CLOSE=3,
+ MORPH_GRADIENT=4, MORPH_TOPHAT=5, MORPH_BLACKHAT=6 };
- idx_type get_size() const { return size; }
-
- iterator begin() const;
- iterator end() const;
+CV_EXPORTS Ptr<BaseRowFilter> getMorphologyRowFilter(int op, int type, int ksize, int anchor=-1);
+CV_EXPORTS Ptr<BaseColumnFilter> getMorphologyColumnFilter(int op, int type, int ksize, int anchor=-1);
+CV_EXPORTS Ptr<BaseFilter> getMorphologyFilter(int op, int type, const Mat& kernel,
+ Point anchor=Point(-1,-1));
- raw_iterator raw_begin() const { return manager.begin(); }
- raw_iterator raw_end() const { return manager.end(); }
+static inline Scalar morphologyDefaultBorderValue() { return Scalar::all(DBL_MAX); }
- void set_size( idx_type _size ) { size = _size; }
+CV_EXPORTS Ptr<FilterEngine> createMorphologyFilter(int op, int type, const Mat& kernel,
+ Point anchor=Point(-1,-1), int _rowBorderType=BORDER_CONSTANT,
+ int _columnBorderType=-1,
+ const Scalar& _borderValue=morphologyDefaultBorderValue());
- CvTree() {root = 0; size = 0;}
- CvTree( idx_type _size ) { root = 0; size = _size; }
- CvTree( const storage& another );
+enum { MORPH_RECT=0, MORPH_CROSS=1, MORPH_ELLIPSE=2 };
+CV_EXPORTS Mat getStructuringElement(int shape, Size ksize, Point anchor=Point(-1,-1));
- storage& operator = ( const storage& another );
+template<> inline void Ptr<IplConvKernel>::delete_obj()
+{ cvReleaseStructuringElement(&obj); }
- template<class Op> double operate_with( const storage& another, Op operation ) const
- {
- iterator iter1 = begin();
- iterator iter2 = another.begin();
- iterator end1 = end();
- iterator end2 = another.end();
-
- Op::result_type s = 0.0;
- value_type val = 0;
-
- do{
- if( iter1.get_idx() > iter2.get_idx() )
- s = operation( s, val, *iter2++ );
- else if( iter1.get_idx() < iter2.get_idx() )
- s = operation( s, *iter1++, (value_type)0 );
- else if( iter1.get_idx() == iter2.get_idx() )
- s = operation( s, *iter1++, *iter2++ );
- }while( iter1 != end1 && iter2 != end2 );
- if( iter1.get_idx() == iter2.get_idx() ) s = operation( s, *iter1, *iter2 );
- return s;
- }
-
- node_type* get_root() const { return root; }
-protected:
+CV_EXPORTS void copyMakeBorder( const Mat& src, Mat& dst,
+ int top, int bottom, int left, int right,
+ int borderType, const Scalar& value=Scalar() );
+
+CV_EXPORTS void medianBlur( const Mat& src, Mat& dst, int ksize );
+CV_EXPORTS void GaussianBlur( const Mat& src, Mat& dst, Size ksize,
+ double sigma1, double sigma2=0,
+ int borderType=BORDER_DEFAULT );
+CV_EXPORTS void bilateralFilter( const Mat& src, Mat& dst, int d,
+ double sigmaColor, double sigmaSpace,
+ int borderType=BORDER_DEFAULT );
+CV_EXPORTS void boxFilter( const Mat& src, Mat& dst, int ddepth,
+ Size ksize, Point anchor=Point(-1,-1),
+ bool normalize=true,
+ int borderType=BORDER_DEFAULT );
+static inline void blur( const Mat& src, Mat& dst,
+ Size ksize, Point anchor=Point(-1,-1),
+ int borderType=BORDER_DEFAULT )
+{
+ boxFilter( src, dst, -1, ksize, anchor, true, borderType );
+}
+
+CV_EXPORTS void filter2D( const Mat& src, Mat& dst, int ddepth,
+ const Mat& kernel, Point anchor=Point(-1,-1),
+ double delta=0, int borderType=BORDER_DEFAULT );
+
+CV_EXPORTS void sepFilter2D( const Mat& src, Mat& dst, int ddepth,
+ const Mat& kernelX, const Mat& kernelY,
+ Point anchor=Point(-1,-1),
+ double delta=0, int borderType=BORDER_DEFAULT );
+
+CV_EXPORTS void Sobel( const Mat& src, Mat& dst, int ddepth,
+ int dx, int dy, int ksize=3,
+ double scale=1, double delta=0,
+ int borderType=BORDER_DEFAULT );
+
+CV_EXPORTS void Scharr( const Mat& src, Mat& dst, int ddepth,
+ int dx, int dy, double scale=1, double delta=0,
+ int borderType=BORDER_DEFAULT );
+
+CV_EXPORTS void Laplacian( const Mat& src, Mat& dst, int ddepth,
+ int ksize=1, double scale=1, double delta=0,
+ int borderType=BORDER_DEFAULT );
+
+CV_EXPORTS void Canny( const Mat& image, Mat& edges,
+ double threshold1, double threshold2,
+ int apertureSize=3, bool L2gradient=false );
+
+CV_EXPORTS void cornerMinEigenVal( const Mat& src, Mat& dst,
+ int blockSize, int ksize=3,
+ int borderType=BORDER_DEFAULT );
+
+CV_EXPORTS void cornerHarris( const Mat& src, Mat& dst, int blockSize,
+ int ksize, double k,
+ int borderType=BORDER_DEFAULT );
+
+CV_EXPORTS void cornerEigenValsAndVecs( const Mat& src, Mat& dst,
+ int blockSize, int ksize,
+ int borderType=BORDER_DEFAULT );
+
+CV_EXPORTS void preCornerDetect( const Mat& src, Mat& dst, int ksize,
+ int borderType=BORDER_DEFAULT );
+
+CV_EXPORTS void cornerSubPix( const Mat& image, vector<Point2f>& corners,
+ Size winSize, Size zeroZone,
+ TermCriteria criteria );
+
+CV_EXPORTS void goodFeaturesToTrack( const Mat& image, vector<Point2f>& corners,
+ int maxCorners, double qualityLevel, double minDistance,
+ const Mat& mask=Mat(), int blockSize=3,
+ bool useHarrisDetector=false, double k=0.04 );
+
+CV_EXPORTS void HoughLines( const Mat& image, vector<Vec2f>& lines,
+ double rho, double theta, int threshold,
+ double srn=0, double stn=0 );
+
+CV_EXPORTS void HoughLinesP( Mat& image, vector<Vec4i>& lines,
+ double rho, double theta, int threshold,
+ double minLineLength=0, double maxLineGap=0 );
+
+CV_EXPORTS void HoughCircles( const Mat& image, vector<Vec3f>& circles,
+ int method, double dp, double minDist,
+ double param1=100, double param2=100,
+ int minRadius=0, int maxRadius=0 );
+
+CV_EXPORTS void erode( const Mat& src, Mat& dst, const Mat& kernel,
+ Point anchor=Point(-1,-1), int iterations=1,
+ int borderType=BORDER_CONSTANT,
+ const Scalar& borderValue=morphologyDefaultBorderValue() );
+CV_EXPORTS void dilate( const Mat& src, Mat& dst, const Mat& kernel,
+ Point anchor=Point(-1,-1), int iterations=1,
+ int borderType=BORDER_CONSTANT,
+ const Scalar& borderValue=morphologyDefaultBorderValue() );
+CV_EXPORTS void morphologyEx( const Mat& src, Mat& dst, int op, const Mat& kernel,
+ Point anchor=Point(-1,-1), int iterations=1,
+ int borderType=BORDER_CONSTANT,
+ const Scalar& borderValue=morphologyDefaultBorderValue() );
+
+enum { INTER_NEAREST=0, INTER_LINEAR=1, INTER_CUBIC=2, INTER_AREA=3,
+ INTER_LANCZOS4=4, INTER_MAX=7, WARP_INVERSE_MAP=16 };
+
+CV_EXPORTS void resize( const Mat& src, Mat& dst,
+ Size dsize, double fx=0, double fy=0,
+ int interpolation=INTER_LINEAR );
+
+CV_EXPORTS void warpAffine( const Mat& src, Mat& dst,
+ const Mat& M, Size dsize,
+ int flags=INTER_LINEAR,
+ int borderMode=BORDER_CONSTANT,
+ const Scalar& borderValue=Scalar());
+CV_EXPORTS void warpPerspective( const Mat& src, Mat& dst,
+ const Mat& M, Size dsize,
+ int flags=INTER_LINEAR,
+ int borderMode=BORDER_CONSTANT,
+ const Scalar& borderValue=Scalar());
+
+CV_EXPORTS void remap( const Mat& src, Mat& dst, const Mat& map1, const Mat& map2,
+ int interpolation, int borderMode=BORDER_CONSTANT,
+ const Scalar& borderValue=Scalar());
+
+CV_EXPORTS void convertMaps( const Mat& map1, const Mat& map2, Mat& dstmap1, Mat& dstmap2,
+ int dstmap1type, bool nninterpolation=false );
+
+CV_EXPORTS Mat getRotationMatrix2D( Point2f center, double angle, double scale );
+CV_EXPORTS Mat getPerspectiveTransform( const Point2f src[], const Point2f dst[] );
+CV_EXPORTS Mat getAffineTransform( const Point2f src[], const Point2f dst[] );
+CV_EXPORTS void invertAffineTransform(const Mat& M, Mat& iM);
+
+CV_EXPORTS void getRectSubPix( const Mat& image, Size patchSize,
+ Point2f center, Mat& patch, int patchType=-1 );
+
+CV_EXPORTS void integral( const Mat& src, Mat& sum, int sdepth=-1 );
+CV_EXPORTS void integral( const Mat& src, Mat& sum, Mat& sqsum, int sdepth=-1 );
+CV_EXPORTS void integral( const Mat& src, Mat& sum, Mat& sqsum, Mat& tilted, int sdepth=-1 );
+
+CV_EXPORTS void accumulate( const Mat& src, Mat& dst, const Mat& mask=Mat() );
+CV_EXPORTS void accumulateSquare( const Mat& src, Mat& dst, const Mat& mask=Mat() );
+CV_EXPORTS void accumulateProduct( const Mat& src1, const Mat& src2,
+ Mat& dst, const Mat& mask=Mat() );
+CV_EXPORTS void accumulateWeighted( const Mat& src, Mat& dst,
+ double alpha, const Mat& mask=Mat() );
+
+enum { THRESH_BINARY=0, THRESH_BINARY_INV=1, THRESH_TRUNC=2, THRESH_TOZERO=3,
+ THRESH_TOZERO_INV=4, THRESH_MASK=7, THRESH_OTSU=8 };
+
+CV_EXPORTS double threshold( const Mat& src, Mat& dst, double thresh, double maxval, int type );
+
+enum { ADAPTIVE_THRESH_MEAN_C=0, ADAPTIVE_THRESH_GAUSSIAN_C=1 };
+
+CV_EXPORTS void adaptiveThreshold( const Mat& src, Mat& dst, double maxValue,
+ int adaptiveMethod, int thresholdType,
+ int blockSize, double C );
+
+CV_EXPORTS void pyrDown( const Mat& src, Mat& dst, const Size& dstsize=Size());
+CV_EXPORTS void pyrUp( const Mat& src, Mat& dst, const Size& dstsize=Size());
+CV_EXPORTS void buildPyramid( const Mat& src, vector<Mat>& dst, int maxlevel );
+
+
+CV_EXPORTS void undistort( const Mat& src, Mat& dst, const Mat& cameraMatrix,
+ const Mat& distCoeffs, const Mat& newCameraMatrix=Mat() );
+CV_EXPORTS void initUndistortRectifyMap( const Mat& cameraMatrix, const Mat& distCoeffs,
+ const Mat& R, const Mat& newCameraMatrix,
+ Size size, int m1type, Mat& map1, Mat& map2 );
+CV_EXPORTS Mat getOptimalNewCameraMatrix( const Mat& cameraMatrix, const Mat& distCoeffs,
+ Size imageSize, double alpha, Size newImgSize=Size(),
+ Rect* validPixROI=0);
+CV_EXPORTS Mat getDefaultNewCameraMatrix( const Mat& cameraMatrix, Size imgsize=Size(),
+ bool centerPrincipalPoint=false );
+
+enum { OPTFLOW_USE_INITIAL_FLOW=4, OPTFLOW_FARNEBACK_GAUSSIAN=256 };
+
+CV_EXPORTS void calcOpticalFlowPyrLK( const Mat& prevImg, const Mat& nextImg,
+ const vector<Point2f>& prevPts, vector<Point2f>& nextPts,
+ vector<uchar>& status, vector<float>& err,
+ Size winSize=Size(15,15), int maxLevel=3,
+ TermCriteria criteria=TermCriteria(
+ TermCriteria::COUNT+TermCriteria::EPS,
+ 30, 0.01),
+ double derivLambda=0.5,
+ int flags=0 );
+
+CV_EXPORTS void calcOpticalFlowFarneback( const Mat& prev0, const Mat& next0,
+ Mat& flow0, double pyr_scale, int levels, int winsize,
+ int iterations, int poly_n, double poly_sigma, int flags );
+
- node_type* root;
- node_manager manager;
- idx_type size;
+template<> inline void Ptr<CvHistogram>::delete_obj()
+{ cvReleaseHist(&obj); }
+
+CV_EXPORTS void calcHist( const Mat* images, int nimages,
+ const int* channels, const Mat& mask,
+ MatND& hist, int dims, const int* histSize,
+ const float** ranges, bool uniform=true,
+ bool accumulate=false );
+
+CV_EXPORTS void calcHist( const Mat* images, int nimages,
+ const int* channels, const Mat& mask,
+ SparseMat& hist, int dims, const int* histSize,
+ const float** ranges, bool uniform=true,
+ bool accumulate=false );
+
+CV_EXPORTS void calcBackProject( const Mat* images, int nimages,
+ const int* channels, const MatND& hist,
+ Mat& backProject, const float** ranges,
+ double scale=1, bool uniform=true );
+
+CV_EXPORTS void calcBackProject( const Mat* images, int nimages,
+ const int* channels, const SparseMat& hist,
+ Mat& backProject, const float** ranges,
+ double scale=1, bool uniform=true );
- node_type* create_node( idx_type idx );
-};
+CV_EXPORTS double compareHist( const MatND& H1, const MatND& H2, int method );
+CV_EXPORTS double compareHist( const SparseMat& H1, const SparseMat& H2, int method );
-/************************* array class *******************************/
-template<class Val> class CvArray
-{
-public:
+CV_EXPORTS void equalizeHist( const Mat& src, Mat& dst );
- typedef Val value_type;
- typedef int idx_type;
- typedef CvArrayIterator<value_type> iterator;
- typedef iterator raw_iterator;
- typedef CvArray<value_type> storage;
-
- value_type query( idx_type idx ) const
- { assert( size == 0 || idx < size );
- return array[idx]; }
-
- value_type& operator []( idx_type idx )
- { assert( size == 0 || idx < size ); return array[idx]; }
+CV_EXPORTS void watershed( const Mat& image, Mat& markers );
- void remove( idx_type idx );
- void clear();
- void destroy();
+enum { GC_BGD = 0, // background
+ GC_FGD = 1, // foreground
+ GC_PR_BGD = 2, // most probably background
+ GC_PR_FGD = 3 // most probably foreground
+ };
- idx_type get_size() const { return size; };
- idx_type get_capacity(){ return capacity; };
- value_type* get_array() const { return array; }
-
- iterator begin() const;
- iterator end() const;
+enum { GC_INIT_WITH_RECT = 0,
+ GC_INIT_WITH_MASK = 1,
+ GC_EVAL = 2
+ };
- raw_iterator raw_begin() const;
- raw_iterator raw_end() const;
+CV_EXPORTS void grabCut( const Mat& img, Mat& mask, Rect rect,
+ Mat& bgdModel, Mat& fgdModel,
+ int iterCount, int mode = GC_EVAL );
- void set_size( idx_type _size );
- void set_capacity( idx_type _capacity );
+enum { INPAINT_NS=CV_INPAINT_NS, INPAINT_TELEA=CV_INPAINT_TELEA };
- CvArray() { array = 0; size = capacity = 0; }
- CvArray( idx_type _size );
- CvArray( idx_type _size, idx_type _capacity );
- CvArray( const storage& another );
+CV_EXPORTS void inpaint( const Mat& src, const Mat& inpaintMask,
+ Mat& dst, double inpaintRange, int flags );
- ~CvArray() { if( array != 0 ) delete array; }
+CV_EXPORTS void distanceTransform( const Mat& src, Mat& dst, Mat& labels,
+ int distanceType, int maskSize );
- storage& operator = ( const storage& another );
+CV_EXPORTS void distanceTransform( const Mat& src, Mat& dst,
+ int distanceType, int maskSize );
- template<class Op> double operate_with( const storage& another, Op operation ) const
- {
- Op::result_type s = 0.0;
- for( idx_type i = 0; i < size; i++ )
- s = operation( s, array[i], another.array[i] );
- return s;
- }
+enum { FLOODFILL_FIXED_RANGE = 1 << 16,
+ FLOODFILL_MASK_ONLY = 1 << 17 };
-protected:
+CV_EXPORTS int floodFill( Mat& image,
+ Point seedPoint, Scalar newVal, Rect* rect=0,
+ Scalar loDiff=Scalar(), Scalar upDiff=Scalar(),
+ int flags=4 );
- value_type* array;
- idx_type size;
- idx_type capacity;
-};
+CV_EXPORTS int floodFill( Mat& image, Mat& mask,
+ Point seedPoint, Scalar newVal, Rect* rect=0,
+ Scalar loDiff=Scalar(), Scalar upDiff=Scalar(),
+ int flags=4 );
-/****************************************************************************************\
-* Multi-dimensional histogram *
-\****************************************************************************************/
+CV_EXPORTS void cvtColor( const Mat& src, Mat& dst, int code, int dstCn=0 );
-template <class Storage = CvArray<class Val> > class CVHistogram
+class CV_EXPORTS Moments
{
public:
-
- typedef Storage storage_type;
- typedef storage_type::value_type value_type; // type of histogram bins
- typedef storage_type::idx_type idx_type; // type of bin indices
- typedef typename storage_type::iterator iterator;
- typedef typename storage_type::raw_iterator raw_iterator;
- typedef CVHistogram<storage_type> histogram;
-
- void create( int bins0, int bins1 = 0, int bins2 = 0,
- int bins3 = 0, int bins4 = 0, int bins5 = 0 );
- void clear() { storage.clear(); } // clear histogram
- void destroy() { storage.destroy(); dims = 0; } // clear and free memory
-
- // lookup operations
- value_type query( int i0 ) const { return storage.query( i0 ); }
- value_type query( int i0, int i1 ) const
- { return storage.query( i0 + i1 * mbins[1] ); }
- value_type query( int i0, int i1, int i2 ) const
- { return storage.query( i0 + i1 * mbins[1] + i2 * mbins[2] ); }
- value_type query( int i0, int i1, int i2, int i3, int i4 = 0, int i5 = 0 ) const
- { return storage.query( get_idx( i0, i1, i2, i3, i4, i5 ) ); }
- value_type query( const int* idxs ) const;
-
- // retrieving references to bins
- value_type& operator []( int i0 ) { return storage[i0]; }
- value_type& operator ()( int i0 ) { return storage[i0]; }
- value_type& operator ()( int i0, int i1 ) { return storage[i0 + i1 * mbins[1]]; }
- value_type& operator ()( int i0, int i1, int i2 )
- { return storage[i0 + i1 * mbins[1] + i2 * mbins[2]]; }
- value_type& operator ()( int i0, int i1, int i2, int i3, int i4 = 0, int i5 = 0 )
- { return storage[get_idx( i0, i1, i2, i3, i4, i5 )]; }
- value_type& operator ()( const int* idxs );
-
- // hi-level iterators
- iterator begin() const { return storage.begin(); }
- iterator end() const { return storage.end(); }
-
- // low-level iterators
- raw_iterator raw_begin() const { return storage.raw_begin(); }
- raw_iterator raw_end() const { return storage.raw_end(); }
-
- // normalizing
- void normalize( value_type norm_factor = 1 );
- void normalize( histogram& result, value_type norm_factor = 1 ) const;
- // thresholding
- void threshold( value_type threshold );
- void threshold( value_type threshold, histogram& result );
-
- histogram& operator -= (value_type val);
- histogram& operator *= (value_type val);
- double mean() const;
+ Moments();
+ Moments(double m00, double m10, double m01, double m20, double m11,
+ double m02, double m30, double m21, double m12, double m03 );
+ Moments( const CvMoments& moments );
+ operator CvMoments() const;
- // some other operations: -=val, *=val, blur, mean ...
-
- // constructors/destructor
- CVHistogram() { dims = 0; }
- CVHistogram( int bins0, int bins1 = 0, int bins2 = 0,
- int bins3 = 0, int bins4 = 0, int bins5 = 0 )
- { create( bins0, bins1, bins2, bins3, bins4, bins5 ); }
- CVHistogram( const histogram& another );
- ~CVHistogram() { destroy(); }
-
- // copy operation
- histogram& operator = (const histogram& another);
-
- int get_dims() const { return dims; }
- int get_dim_size(int n = 0) const { return bins[n]; };
+ double m00, m10, m01, m20, m11, m02, m30, m21, m12, m03; // spatial moments
+ double mu20, mu11, mu02, mu30, mu21, mu12, mu03; // central moments
+ double nu20, nu11, nu02, nu30, nu21, nu12, nu03; // central normalized moments
+};
- // helper template method for histograms comparing
- template<class Op> double operate_with( const histogram& another, Op operation ) const
- {
- return storage.operate_with( another.storage, operation );
- }
+CV_EXPORTS Moments moments( const Mat& array, bool binaryImage=false );
- bool check_size_equality( const histogram& another )
- {
- if( dims != another.dims ) return false;
- for( int i = 0; i < dims; i++ ) if( bins[i] != another.bins[i] ) return false;
- return true;
- }
+CV_EXPORTS void HuMoments( const Moments& moments, double hu[7] );
- enum { max_dims = 6 };
+enum { TM_SQDIFF=CV_TM_SQDIFF, TM_SQDIFF_NORMED=CV_TM_SQDIFF_NORMED,
+ TM_CCORR=CV_TM_CCORR, TM_CCORR_NORMED=CV_TM_CCORR_NORMED,
+ TM_CCOEFF=CV_TM_CCOEFF, TM_CCOEFF_NORMED=CV_TM_CCOEFF_NORMED };
-protected:
+CV_EXPORTS void matchTemplate( const Mat& image, const Mat& templ, Mat& result, int method );
- int dims;
- int bins[max_dims];
- int mbins[max_dims];
- storage_type storage;
+enum { RETR_EXTERNAL=CV_RETR_EXTERNAL, RETR_LIST=CV_RETR_LIST,
+ RETR_CCOMP=CV_RETR_CCOMP, RETR_TREE=CV_RETR_TREE };
- idx_type get_idx( int bin0, int bin1 = 0, int bin2 = 0,
- int bin3 = 0, int bin4 = 0, int bin5 = 0 ) const
- { return bin0 * mbins[0] + bin1 * mbins[1] + bin2 * mbins[2] + bin3 * mbins[3]
- + bin4 * mbins[4] + bin5 * mbins[5]; }
-};
+enum { CHAIN_APPROX_NONE=CV_CHAIN_APPROX_NONE,
+ CHAIN_APPROX_SIMPLE=CV_CHAIN_APPROX_SIMPLE,
+ CHAIN_APPROX_TC89_L1=CV_CHAIN_APPROX_TC89_L1,
+ CHAIN_APPROX_TC89_KCOS=CV_CHAIN_APPROX_TC89_KCOS };
+CV_EXPORTS void findContours( Mat& image, vector<vector<Point> >& contours,
+ vector<Vec4i>& hierarchy, int mode,
+ int method, Point offset=Point());
-template <class Hist> inline double calc_histogram_intersection( const Hist& hist1,
- const Hist& hist2 );
+CV_EXPORTS void findContours( Mat& image, vector<vector<Point> >& contours,
+ int mode, int method, Point offset=Point());
-template <class Hist> inline double calc_histogram_chi_square( const Hist& hist1,
- const Hist& hist2 );
+CV_EXPORTS void drawContours( Mat& image, const vector<vector<Point> >& contours,
+ int contourIdx, const Scalar& color,
+ int thickness=1, int lineType=8,
+ const vector<Vec4i>& hierarchy=vector<Vec4i>(),
+ int maxLevel=INT_MAX, Point offset=Point() );
-template <class Hist> inline double calc_histogram_correlation( const Hist& hist1,
- const Hist& hist2 );
+CV_EXPORTS void approxPolyDP( const Mat& curve,
+ vector<Point>& approxCurve,
+ double epsilon, bool closed );
+CV_EXPORTS void approxPolyDP( const Mat& curve,
+ vector<Point2f>& approxCurve,
+ double epsilon, bool closed );
+
+CV_EXPORTS double arcLength( const Mat& curve, bool closed );
+CV_EXPORTS Rect boundingRect( const Mat& points );
+CV_EXPORTS double contourArea( const Mat& contour );
+CV_EXPORTS RotatedRect minAreaRect( const Mat& points );
+CV_EXPORTS void minEnclosingCircle( const Mat& points,
+ Point2f& center, float& radius );
+CV_EXPORTS double matchShapes( const Mat& contour1,
+ const Mat& contour2,
+ int method, double parameter );
+
+CV_EXPORTS void convexHull( const Mat& points, vector<int>& hull, bool clockwise=false );
+CV_EXPORTS void convexHull( const Mat& points, vector<Point>& hull, bool clockwise=false );
+CV_EXPORTS void convexHull( const Mat& points, vector<Point2f>& hull, bool clockwise=false );
-template<class Histogram, class SrcType, class ThreshType> void
- calc_histogram_from_images( Histogram& hist, SrcType** src,
- CvSize roi, int step, ThreshType** thresh );
+CV_EXPORTS bool isContourConvex( const Mat& contour );
-template<class Histogram, class SrcType, class ThreshType, class DstType> void
- calc_back_project_from_images( Histogram& Hmodel,
- SrcType* src,
- CvSize roi,
- int src_step,
- ThreshType** thresh,
- DstType* measure,
- int dst_step,
- DstType threshold = 0 );
+CV_EXPORTS RotatedRect fitEllipse( const Mat& points );
-#define CvBackProject calc_back_project_from_images
-#define CvCalculateC1 calc_histogram_from_images
+CV_EXPORTS void fitLine( const Mat& points, Vec4f& line, int distType,
+ double param, double reps, double aeps );
+CV_EXPORTS void fitLine( const Mat& points, Vec6f& line, int distType,
+ double param, double reps, double aeps );
+CV_EXPORTS double pointPolygonTest( const Mat& contour,
+ Point2f pt, bool measureDist );
-#define CVH_IMPLEMENT_STORAGE
-#include "cvstorage.hpp"
+CV_EXPORTS Mat estimateRigidTransform( const Mat& A, const Mat& B,
+ bool fullAffine );
+CV_EXPORTS void updateMotionHistory( const Mat& silhouette, Mat& mhi,
+ double timestamp, double duration );
-#endif /* #if defined _MSC_VER || defined __ICL || defined __BORLANDC__ */
+CV_EXPORTS void calcMotionGradient( const Mat& mhi, Mat& mask,
+ Mat& orientation,
+ double delta1, double delta2,
+ int apertureSize=3 );
-/****************************************************************************************\
-* Image class *
-\****************************************************************************************/
+CV_EXPORTS double calcGlobalOrientation( const Mat& orientation, const Mat& mask,
+ const Mat& mhi, double timestamp,
+ double duration );
+// TODO: need good API for cvSegmentMotion
-struct CV_DLL_ENTRY CvImage : public IplImage
+CV_EXPORTS RotatedRect CamShift( const Mat& probImage, Rect& window,
+ TermCriteria criteria );
+
+CV_EXPORTS int meanShift( const Mat& probImage, Rect& window,
+ TermCriteria criteria );
+
+CV_EXPORTS int estimateAffine3D(const Mat& from, const Mat& to, Mat& out,
+ vector<uchar>& outliers,
+ double param1 = 3.0, double param2 = 0.99);
+
+class CV_EXPORTS KalmanFilter
{
- CvImage();
- CvImage( CvSize size, int depth, int channels );
- ~CvImage();
+public:
+ KalmanFilter();
+ KalmanFilter(int dynamParams, int measureParams, int controlParams=0);
+ void init(int dynamParams, int measureParams, int controlParams=0);
+
+ const Mat& predict(const Mat& control=Mat());
+ const Mat& correct(const Mat& measurement);
+
+ Mat statePre; // predicted state (x'(k)):
+ // x(k)=A*x(k-1)+B*u(k)
+ Mat statePost; // corrected state (x(k)):
+ // x(k)=x'(k)+K(k)*(z(k)-H*x'(k))
+ Mat transitionMatrix; // state transition matrix (A)
+ Mat controlMatrix; // control matrix (B)
+ // (it is not used if there is no control)
+ Mat measurementMatrix; // measurement matrix (H)
+ Mat processNoiseCov; // process noise covariance matrix (Q)
+ Mat measurementNoiseCov;// measurement noise covariance matrix (R)
+ Mat errorCovPre; // priori error estimate covariance matrix (P'(k)):
+ // P'(k)=A*P(k-1)*At + Q)*/
+ Mat gain; // Kalman gain matrix (K(k)):
+ // K(k)=P'(k)*Ht*inv(H*P'(k)*Ht+R)
+ Mat errorCovPost; // posteriori error estimate covariance matrix (P(k)):
+ // P(k)=(I-K(k)*H)*P'(k)
+ Mat temp1; // temporary matrices
+ Mat temp2;
+ Mat temp3;
+ Mat temp4;
+ Mat temp5;
+};
- uchar* image_data();
- const uchar* image_data() const;
- CvSize image_roi_size() const;
- int byte_per_pixel() const;
+///////////////////////////// Object Detection ////////////////////////////
- CvImage& operator = ( const CvImage& another )
- { return copy( another ); }
+CV_EXPORTS void groupRectangles(vector<Rect>& rectList, int groupThreshold, double eps=0.2);
+CV_EXPORTS void groupRectangles(vector<Rect>& rectList, vector<int>& weights, int groupThreshold, double eps=0.2);
+
+class CV_EXPORTS FeatureEvaluator
+{
+public:
+ enum { HAAR = 0, LBP = 1 };
+ virtual ~FeatureEvaluator();
+ virtual bool read(const FileNode& node);
+ virtual Ptr<FeatureEvaluator> clone() const;
+ virtual int getFeatureType() const;
- CvImage& copy( const CvImage& another );
-};
+ virtual bool setImage(const Mat&, Size origWinSize);
+ virtual bool setWindow(Point p);
+ virtual double calcOrd(int featureIdx) const;
+ virtual int calcCat(int featureIdx) const;
-class CV_DLL_ENTRY CvImageGroup
+ static Ptr<FeatureEvaluator> create(int type);
+};
+
+template<> inline void Ptr<CvHaarClassifierCascade>::delete_obj()
+{ cvReleaseHaarClassifierCascade(&obj); }
+
+class CV_EXPORTS CascadeClassifier
{
public:
- enum{ max_count = 7 };
+ struct CV_EXPORTS DTreeNode
+ {
+ int featureIdx;
+ float threshold; // for ordered features only
+ int left;
+ int right;
+ };
- CvImageGroup( int _count = 0 )
- { assert( _count < max_count ); clear(); operator=(_count); }
-
+ struct CV_EXPORTS DTree
+ {
+ int nodeCount;
+ };
+
+ struct CV_EXPORTS Stage
+ {
+ int first;
+ int ntrees;
+ float threshold;
+ };
+
+ enum { BOOST = 0 };
+ enum { DO_CANNY_PRUNING = CV_HAAR_DO_CANNY_PRUNING,
+ SCALE_IMAGE = CV_HAAR_SCALE_IMAGE,
+ FIND_BIGGEST_OBJECT = CV_HAAR_FIND_BIGGEST_OBJECT,
+ DO_ROUGH_SEARCH = CV_HAAR_DO_ROUGH_SEARCH };
+
+ CascadeClassifier();
+ CascadeClassifier(const string& filename);
+ ~CascadeClassifier();
+
+ bool empty() const;
+ bool load(const string& filename);
+ bool read(const FileNode& node);
+ void detectMultiScale( const Mat& image,
+ vector<Rect>& objects,
+ double scaleFactor=1.1,
+ int minNeighbors=3, int flags=0,
+ Size minSize=Size());
+
+ bool setImage( Ptr<FeatureEvaluator>&, const Mat& );
+ int runAt( Ptr<FeatureEvaluator>&, Point );
+
+ bool is_stump_based;
+
+ int stageType;
+ int featureType;
+ int ncategories;
+ Size origWinSize;
+
+ vector<Stage> stages;
+ vector<DTree> classifiers;
+ vector<DTreeNode> nodes;
+ vector<float> leaves;
+ vector<int> subsets;
+
+ Ptr<FeatureEvaluator> feval;
+ Ptr<CvHaarClassifierCascade> oldCascade;
+};
- ~CvImageGroup() { destroy(); }
- CvImage& operator[]( int count ) { return (CvImage&)*image[count]; }
+CV_EXPORTS void undistortPoints( const Mat& src, vector<Point2f>& dst,
+ const Mat& cameraMatrix, const Mat& distCoeffs,
+ const Mat& R=Mat(), const Mat& P=Mat());
+CV_EXPORTS void undistortPoints( const Mat& src, Mat& dst,
+ const Mat& cameraMatrix, const Mat& distCoeffs,
+ const Mat& R=Mat(), const Mat& P=Mat());
+
+CV_EXPORTS void Rodrigues(const Mat& src, Mat& dst);
+CV_EXPORTS void Rodrigues(const Mat& src, Mat& dst, Mat& jacobian);
+
+enum { LMEDS=4, RANSAC=8 };
+
+CV_EXPORTS Mat findHomography( const Mat& srcPoints,
+ const Mat& dstPoints,
+ Mat& mask, int method=0,
+ double ransacReprojThreshold=0 );
+
+CV_EXPORTS Mat findHomography( const Mat& srcPoints,
+ const Mat& dstPoints,
+ vector<uchar>& mask, int method=0,
+ double ransacReprojThreshold=0 );
+
+CV_EXPORTS Mat findHomography( const Mat& srcPoints,
+ const Mat& dstPoints,
+ int method=0, double ransacReprojThreshold=0 );
+
+/* Computes RQ decomposition for 3x3 matrices */
+CV_EXPORTS void RQDecomp3x3( const Mat& M, Mat& R, Mat& Q );
+CV_EXPORTS Vec3d RQDecomp3x3( const Mat& M, Mat& R, Mat& Q,
+ Mat& Qx, Mat& Qy, Mat& Qz );
+
+CV_EXPORTS void decomposeProjectionMatrix( const Mat& projMatrix, Mat& cameraMatrix,
+ Mat& rotMatrix, Mat& transVect );
+CV_EXPORTS void decomposeProjectionMatrix( const Mat& projMatrix, Mat& cameraMatrix,
+ Mat& rotMatrix, Mat& transVect,
+ Mat& rotMatrixX, Mat& rotMatrixY,
+ Mat& rotMatrixZ, Vec3d& eulerAngles );
+
+CV_EXPORTS void matMulDeriv( const Mat& A, const Mat& B, Mat& dABdA, Mat& dABdB );
+
+CV_EXPORTS void composeRT( const Mat& rvec1, const Mat& tvec1,
+ const Mat& rvec2, const Mat& tvec2,
+ Mat& rvec3, Mat& tvec3 );
+
+CV_EXPORTS void composeRT( const Mat& rvec1, const Mat& tvec1,
+ const Mat& rvec2, const Mat& tvec2,
+ Mat& rvec3, Mat& tvec3,
+ Mat& dr3dr1, Mat& dr3dt1,
+ Mat& dr3dr2, Mat& dr3dt2,
+ Mat& dt3dr1, Mat& dt3dt1,
+ Mat& dt3dr2, Mat& dt3dt2 );
+
+CV_EXPORTS void projectPoints( const Mat& objectPoints,
+ const Mat& rvec, const Mat& tvec,
+ const Mat& cameraMatrix,
+ const Mat& distCoeffs,
+ vector<Point2f>& imagePoints );
+
+CV_EXPORTS void projectPoints( const Mat& objectPoints,
+ const Mat& rvec, const Mat& tvec,
+ const Mat& cameraMatrix,
+ const Mat& distCoeffs,
+ vector<Point2f>& imagePoints,
+ Mat& dpdrot, Mat& dpdt, Mat& dpdf,
+ Mat& dpdc, Mat& dpddist,
+ double aspectRatio=0 );
+
+CV_EXPORTS void solvePnP( const Mat& objectPoints,
+ const Mat& imagePoints,
+ const Mat& cameraMatrix,
+ const Mat& distCoeffs,
+ Mat& rvec, Mat& tvec,
+ bool useExtrinsicGuess=false );
+
+CV_EXPORTS Mat initCameraMatrix2D( const vector<vector<Point3f> >& objectPoints,
+ const vector<vector<Point2f> >& imagePoints,
+ Size imageSize, double aspectRatio=1. );
+
+enum { CALIB_CB_ADAPTIVE_THRESH = CV_CALIB_CB_ADAPTIVE_THRESH,
+ CALIB_CB_NORMALIZE_IMAGE = CV_CALIB_CB_NORMALIZE_IMAGE,
+ CALIB_CB_FILTER_QUADS = CV_CALIB_CB_FILTER_QUADS };
+
+CV_EXPORTS bool findChessboardCorners( const Mat& image, Size patternSize,
+ vector<Point2f>& corners,
+ int flags=CV_CALIB_CB_ADAPTIVE_THRESH+
+ CV_CALIB_CB_NORMALIZE_IMAGE );
+
+CV_EXPORTS void drawChessboardCorners( Mat& image, Size patternSize,
+ const Mat& corners,
+ bool patternWasFound );
+
+enum
+{
+ CALIB_USE_INTRINSIC_GUESS = CV_CALIB_USE_INTRINSIC_GUESS,
+ CALIB_FIX_ASPECT_RATIO = CV_CALIB_FIX_ASPECT_RATIO,
+ CALIB_FIX_PRINCIPAL_POINT = CV_CALIB_FIX_PRINCIPAL_POINT,
+ CALIB_ZERO_TANGENT_DIST = CV_CALIB_ZERO_TANGENT_DIST,
+ CALIB_FIX_FOCAL_LENGTH = CV_CALIB_FIX_FOCAL_LENGTH,
+ CALIB_FIX_K1 = CV_CALIB_FIX_K1,
+ CALIB_FIX_K2 = CV_CALIB_FIX_K2,
+ CALIB_FIX_K3 = CV_CALIB_FIX_K3,
+ // only for stereo
+ CALIB_FIX_INTRINSIC = CV_CALIB_FIX_INTRINSIC,
+ CALIB_SAME_FOCAL_LENGTH = CV_CALIB_SAME_FOCAL_LENGTH,
+ // for stereo rectification
+ CALIB_ZERO_DISPARITY = CV_CALIB_ZERO_DISPARITY
+};
- CvImageGroup& operator=( const CvImageGroup& another )
- { return copy( another ); }
+CV_EXPORTS double calibrateCamera( const vector<vector<Point3f> >& objectPoints,
+ const vector<vector<Point2f> >& imagePoints,
+ Size imageSize,
+ Mat& cameraMatrix, Mat& distCoeffs,
+ vector<Mat>& rvecs, vector<Mat>& tvecs,
+ int flags=0 );
+
+CV_EXPORTS void calibrationMatrixValues( const Mat& cameraMatrix,
+ Size imageSize,
+ double apertureWidth,
+ double apertureHeight,
+ double& fovx,
+ double& fovy,
+ double& focalLength,
+ Point2d& principalPoint,
+ double& aspectRatio );
+
+CV_EXPORTS double stereoCalibrate( const vector<vector<Point3f> >& objectPoints,
+ const vector<vector<Point2f> >& imagePoints1,
+ const vector<vector<Point2f> >& imagePoints2,
+ Mat& cameraMatrix1, Mat& distCoeffs1,
+ Mat& cameraMatrix2, Mat& distCoeffs2,
+ Size imageSize, Mat& R, Mat& T,
+ Mat& E, Mat& F,
+ TermCriteria criteria = TermCriteria(TermCriteria::COUNT+
+ TermCriteria::EPS, 30, 1e-6),
+ int flags=CALIB_FIX_INTRINSIC );
+
+CV_EXPORTS void stereoRectify( const Mat& cameraMatrix1, const Mat& distCoeffs1,
+ const Mat& cameraMatrix2, const Mat& distCoeffs2,
+ Size imageSize, const Mat& R, const Mat& T,
+ Mat& R1, Mat& R2, Mat& P1, Mat& P2, Mat& Q,
+ int flags=CALIB_ZERO_DISPARITY );
+
+CV_EXPORTS void stereoRectify( const Mat& cameraMatrix1, const Mat& distCoeffs1,
+ const Mat& cameraMatrix2, const Mat& distCoeffs2,
+ Size imageSize, const Mat& R, const Mat& T,
+ Mat& R1, Mat& R2, Mat& P1, Mat& P2, Mat& Q,
+ double alpha, Size newImageSize=Size(),
+ Rect* validPixROI1=0, Rect* validPixROI2=0,
+ int flags=CALIB_ZERO_DISPARITY );
+
+CV_EXPORTS bool stereoRectifyUncalibrated( const Mat& points1,
+ const Mat& points2,
+ const Mat& F, Size imgSize,
+ Mat& H1, Mat& H2,
+ double threshold=5 );
+
+CV_EXPORTS void convertPointsHomogeneous( const Mat& src, vector<Point3f>& dst );
+CV_EXPORTS void convertPointsHomogeneous( const Mat& src, vector<Point2f>& dst );
+
+enum
+{
+ FM_7POINT = CV_FM_7POINT,
+ FM_8POINT = CV_FM_8POINT,
+ FM_LMEDS = CV_FM_LMEDS,
+ FM_RANSAC = CV_FM_RANSAC
+};
- CvImageGroup& operator=( const CvImage& another )
- { return copy( another ); }
+CV_EXPORTS Mat findFundamentalMat( const Mat& points1, const Mat& points2,
+ vector<uchar>& mask, int method=FM_RANSAC,
+ double param1=3., double param2=0.99 );
- CvImageGroup& copy( const CvImageGroup& another );
+CV_EXPORTS Mat findFundamentalMat( const Mat& points1, const Mat& points2,
+ int method=FM_RANSAC,
+ double param1=3., double param2=0.99 );
- CvImageGroup& copy( const CvImage& another );
- CvImageGroup& operator=( int _count );
+CV_EXPORTS void computeCorrespondEpilines( const Mat& points1,
+ int whichImage, const Mat& F,
+ vector<Vec3f>& lines );
- int get_count() const { return count; }
+template<> inline void Ptr<CvStereoBMState>::delete_obj()
+{ cvReleaseStereoBMState(&obj); }
- void destroy();
- void clear() { for( int i = 0; i < max_count; i++ ) image[i] = 0; }
- IplImage** get_group() { return &image[0]; };
+// Block matching stereo correspondence algorithm
+class CV_EXPORTS StereoBM
+{
+public:
+ enum { PREFILTER_NORMALIZED_RESPONSE = CV_STEREO_BM_NORMALIZED_RESPONSE,
+ PREFILTER_XSOBEL = CV_STEREO_BM_XSOBEL,
+ BASIC_PRESET=CV_STEREO_BM_BASIC,
+ FISH_EYE_PRESET=CV_STEREO_BM_FISH_EYE,
+ NARROW_PRESET=CV_STEREO_BM_NARROW };
+
+ StereoBM();
+ StereoBM(int preset, int ndisparities=0, int SADWindowSize=21);
+ void init(int preset, int ndisparities=0, int SADWindowSize=21);
+ void operator()( const Mat& left, const Mat& right, Mat& disparity, int disptype=CV_16S );
-protected:
- int count;
- IplImage* image[max_count];
+ Ptr<CvStereoBMState> state;
};
-class CV_DLL_ENTRY CvCamShiftTracker
+
+class CV_EXPORTS StereoSGBM
{
public:
+ enum { DISP_SHIFT=4, DISP_SCALE = (1<<DISP_SHIFT) };
- // constructor
- CvCamShiftTracker();
- // destructor
- virtual ~CvCamShiftTracker();
-
- // get- properties
-
- // Characteristics of the object,
- // which are calculated by track_object method
- float get_orientation() // orientation of the object in degrees
- { return orientation; }
- float get_length() // the larger linear size of the object
- { return length; }
- float get_width() // the smaller linear size of the object
- { return width; }
- CvRect get_window() // bounding rectangle for the object
- { return window; }
-
- // Tracking parameters
- int get_threshold() // thresholding value that applied to back project
- { return threshold; }
- int get_hist_dims( int* dims = 0 ); // returns number of histogram dimensions and sets
- // dims[0] to number of bins on 1st dimension,
- // dims[1] -||- on 2nd dimension etc.
- // (if dims pointer is not 0).
+ StereoSGBM();
+ StereoSGBM(int minDisparity, int numDisparities, int SADWindowSize,
+ int P1=0, int P2=0, int disp12MaxDiff=0,
+ int preFilterCap=0, int uniquenessRatio=0,
+ int speckleWindowSize=0, int speckleRange=0,
+ bool fullDP=false);
+ virtual ~StereoSGBM();
- int get_min_ch_val( int channel ) // Given channel index, returns
- { return min_ch_val[channel]; } // the minimum value of that channel,
- // starting from which the pixel
- // is counted during histogram calculation.
+ virtual void operator()(const Mat& left, const Mat& right, Mat& disp);
- int get_max_ch_val( int channel ) // Get maximum channel value.
- { return max_ch_val[channel]; }
+ int minDisparity;
+ int numberOfDisparities;
+ int SADWindowSize;
+ int preFilterCap;
+ int uniquenessRatio;
+ int P1, P2;
+ int speckleWindowSize;
+ int speckleRange;
+ int disp12MaxDiff;
+ bool fullDP;
+protected:
+ Mat buffer;
+};
+
- // Background differencing parameters
+CV_EXPORTS void filterSpeckles( Mat& img, double newVal, int maxSpeckleSize, double maxDiff, Mat& buf );
- // set- properties
- // Object characteristics
- bool set_window( CvRect _window) // set initial bounding rectangle for the object
- { window = _window; return true; }
+CV_EXPORTS Rect getValidDisparityROI( Rect roi1, Rect roi2,
+ int minDisparity, int numberOfDisparities,
+ int SADWindowSize );
- // Tracking parameters
- bool set_threshold( int _threshold ) // threshold level that applied
- { threshold = _threshold; return true; }
+CV_EXPORTS void validateDisparity( Mat& disparity, const Mat& cost,
+ int minDisparity, int numberOfDisparities,
+ int disp12MaxDisp=1 );
- // to back project.
- bool set_hist_dims( int c_dims, int* dims );// histogram dimensions.
-
- bool set_min_ch_val( int channel, int val ) // Given channel index, sets
- { min_ch_val[channel] = val; return true; } // the minimum value of that channel,
- // starting from which the pixel
- // is counted during histogram calculation.
-
- bool set_max_ch_val( int channel, int val ) // Set maximum value for the channel.
- { max_ch_val[channel] = val; return true; }
+CV_EXPORTS void reprojectImageTo3D( const Mat& disparity,
+ Mat& _3dImage, const Mat& Q,
+ bool handleMissingValues=false );
- bool set_thresh( int channel, int min, int max );
-
- bool set_hist_mapping( int* /*channels*/ )
- { return 0; }
- // selects the channels from
- // resulting image
- // (before histogram/back prj calculation)
- // for using them in histogram/back prj
- // calculation.
- // That is, channel #(channels[0]) is
- // corresponds to first histogram
- // dimension, channel #(channels[1])
- // to 2nd etc.
-
- // Backgournd differencing ...
-
- // can be used (and overrided) if histogram is built from several frames
- virtual void reset_histogram() { cvClearHist( hist ); }
-
- // main pipeline for object tracking
- virtual void track_object( CvImage* src_image )
- {
- trackobj_find( calc_back_project( trackobj_post_color(
- trackobj_color_transform( trackobj_pre_color( src_image )))));
- }
+class CV_EXPORTS KeyPoint
+{
+public:
+ KeyPoint() : pt(0,0), size(0), angle(-1), response(0), octave(0), class_id(-1) {}
+ KeyPoint(Point2f _pt, float _size, float _angle=-1,
+ float _response=0, int _octave=0, int _class_id=-1)
+ : pt(_pt), size(_size), angle(_angle),
+ response(_response), octave(_octave), class_id(_class_id) {}
+ KeyPoint(float x, float y, float _size, float _angle=-1,
+ float _response=0, int _octave=0, int _class_id=-1)
+ : pt(x, y), size(_size), angle(_angle),
+ response(_response), octave(_octave), class_id(_class_id) {}
- // main pipeline for histogram calculation
- virtual void update_histogram( CvImage* src_image )
- {
- calc_histogram( hist_post_color(
- hist_color_transform( hist_pre_color( src_image ))));
- }
-
+ Point2f pt;
+ float size;
+ float angle;
+ float response;
+ int octave;
+ int class_id;
+};
- virtual CvImage* get_back_project()
- { return &calc_back_project_image; }
+CV_EXPORTS void write(FileStorage& fs, const string& name, const vector<KeyPoint>& keypoints);
+CV_EXPORTS void read(const FileNode& node, vector<KeyPoint>& keypoints);
+class CV_EXPORTS SURF : public CvSURFParams
+{
+public:
+ SURF();
+ SURF(double _hessianThreshold, int _nOctaves=4,
+ int _nOctaveLayers=2, bool _extended=false);
+
+ int descriptorSize() const;
+ void operator()(const Mat& img, const Mat& mask,
+ vector<KeyPoint>& keypoints) const;
+ void operator()(const Mat& img, const Mat& mask,
+ vector<KeyPoint>& keypoints,
+ vector<float>& descriptors,
+ bool useProvidedKeypoints=false) const;
+};
- virtual int get_shift_parameter()
- { return shift; }
+class CV_EXPORTS MSER : public CvMSERParams
+{
+public:
+ MSER();
+ MSER( int _delta, int _min_area, int _max_area,
+ float _max_variation, float _min_diversity,
+ int _max_evolution, double _area_threshold,
+ double _min_margin, int _edge_blur_size );
+ void operator()(Mat& image, vector<vector<Point> >& msers, const Mat& mask) const;
+};
- virtual bool set_shift_parameter(int _shift)
- { shift = _shift; return true; }
+class CV_EXPORTS StarDetector : public CvStarDetectorParams
+{
+public:
+ StarDetector();
+ StarDetector(int _maxSize, int _responseThreshold,
+ int _lineThresholdProjected,
+ int _lineThresholdBinarized,
+ int _suppressNonmaxSize);
- virtual int query( int bin )
- { return cvRound(cvQueryHistValue_1D( hist, bin )); }
+ void operator()(const Mat& image, vector<KeyPoint>& keypoints) const;
+};
-protected:
- typedef CvHistogram hist_type;
+}
- hist_type* hist;
+//////////////////////////////////////////////////////////////////////////////////////////
- float orientation;
- float width;
- float length;
- CvRect window;
+class CV_EXPORTS CvLevMarq
+{
+public:
+ CvLevMarq();
+ CvLevMarq( int nparams, int nerrs, CvTermCriteria criteria=
+ cvTermCriteria(CV_TERMCRIT_EPS+CV_TERMCRIT_ITER,30,DBL_EPSILON),
+ bool completeSymmFlag=false );
+ ~CvLevMarq();
+ void init( int nparams, int nerrs, CvTermCriteria criteria=
+ cvTermCriteria(CV_TERMCRIT_EPS+CV_TERMCRIT_ITER,30,DBL_EPSILON),
+ bool completeSymmFlag=false );
+ bool update( const CvMat*& param, CvMat*& J, CvMat*& err );
+ bool updateAlt( const CvMat*& param, CvMat*& JtJ, CvMat*& JtErr, double*& errNorm );
+
+ void clear();
+ void step();
+ enum { DONE=0, STARTED=1, CALC_J=2, CHECK_ERR=3 };
+
+ cv::Ptr<CvMat> mask;
+ cv::Ptr<CvMat> prevParam;
+ cv::Ptr<CvMat> param;
+ cv::Ptr<CvMat> J;
+ cv::Ptr<CvMat> err;
+ cv::Ptr<CvMat> JtJ;
+ cv::Ptr<CvMat> JtJN;
+ cv::Ptr<CvMat> JtErr;
+ cv::Ptr<CvMat> JtJV;
+ cv::Ptr<CvMat> JtJW;
+ double prevErrNorm, errNorm;
+ int lambdaLg10;
+ CvTermCriteria criteria;
+ int state;
+ int iters;
+ bool completeSymmFlag;
+};
- int min_ch_val[6];
- int max_ch_val[6];
- int shift;
+// 2009-01-12, Xavier Delacour <xavier.delacour@gmail.com>
- float* thresh[CvImageGroup::max_count];
- float thresh_buf[CvImageGroup::max_count*2];
- int threshold;
+struct lsh_hash {
+ int h1, h2;
+};
- CvImageGroup color_transform_image_group;
- CvImage trackobj_pre_color_image;
- CvImage calc_back_project_image;
-
- // Internal pipeline functions
-
- // Common
-
- // common color transform
- virtual CvImageGroup* color_transform( CvImage* src_image );
-
- // Specific for object tracking
- // preprocessing before color transformation
- virtual CvImage* trackobj_pre_color( CvImage* src_image );
-
- // color transformation. do common transform by default
- virtual CvImageGroup* trackobj_color_transform( CvImage* src_image )
- { return color_transform( src_image ); }
-
- // postprocessing after color transformation before back project
- virtual CvImageGroup* trackobj_post_color( CvImageGroup* src_image );
-
- // calculation of back project
- virtual CvImage* calc_back_project( CvImageGroup* src_image );
-
- // apply camshift algorithm to calculate object parameters
- virtual void trackobj_find( CvImage* src_image );
-
-
- // Specific for histogram calculation
-
- // preprocessing before color transformation
- virtual CvImage* hist_pre_color( CvImage* src_image )
- { return trackobj_pre_color( src_image ); }
+struct CvLSHOperations
+{
+ virtual ~CvLSHOperations() {}
- // color transformation. do common transform by default
- virtual CvImageGroup* hist_color_transform( CvImage* src_image )
- { return color_transform( src_image ); }
-
- // postprocessing after color transformation before back project
- virtual CvImageGroup* hist_post_color( CvImageGroup* src_image )
- { return trackobj_post_color( src_image ); }
-
- // histogram calculation
- virtual void calc_histogram( CvImageGroup* src_image );
-
-
-};
+ virtual int vector_add(const void* data) = 0;
+ virtual void vector_remove(int i) = 0;
+ virtual const void* vector_lookup(int i) = 0;
+ virtual void vector_reserve(int n) = 0;
+ virtual unsigned int vector_count() = 0;
-#include "cvstorage.hpp"
+ virtual void hash_insert(lsh_hash h, int l, int i) = 0;
+ virtual void hash_remove(lsh_hash h, int l, int i) = 0;
+ virtual int hash_lookup(lsh_hash h, int l, int* ret_i, int ret_i_max) = 0;
+};
#endif /* __cplusplus */
-#endif /* _CV_HPP */
-
+#endif
/* End of file. */