opencv/include/opencv/cv.hpp

   1 /*M///////////////////////////////////////////////////////////////////////////////////////
   2 //
   3 //  IMPORTANT: READ BEFORE DOWNLOADING, COPYING, INSTALLING OR USING.
   4 //
   5 //  By downloading, copying, installing or using the software you agree to this license.
   6 //  If you do not agree to this license, do not download, install,
   7 //  copy or use the software.
   8 //
   9 //
  10 //                        Intel License Agreement
  11 //                For Open Source Computer Vision Library
  12 //
  13 // Copyright (C) 2000, Intel Corporation, all rights reserved.
  14 // Third party copyrights are property of their respective owners.
  15 //
  16 // Redistribution and use in source and binary forms, with or without modification,
  17 // are permitted provided that the following conditions are met:
  18 //
  19 //   * Redistribution's of source code must retain the above copyright notice,
  20 //     this list of conditions and the following disclaimer.
  21 //
  22 //   * Redistribution's in binary form must reproduce the above copyright notice,
  23 //     this list of conditions and the following disclaimer in the documentation
  24 //     and/or other materials provided with the distribution.
  25 //
  26 //   * The name of Intel Corporation may not be used to endorse or promote products
  27 //     derived from this software without specific prior written permission.
  28 //
  29 // This software is provided by the copyright holders and contributors "as is" and
  30 // any express or implied warranties, including, but not limited to, the implied
  31 // warranties of merchantability and fitness for a particular purpose are disclaimed.
  32 // In no event shall the Intel Corporation or contributors be liable for any direct,
  33 // indirect, incidental, special, exemplary, or consequential damages
  34 // (including, but not limited to, procurement of substitute goods or services;
  35 // loss of use, data, or profits; or business interruption) however caused
  36 // and on any theory of liability, whether in contract, strict liability,
  37 // or tort (including negligence or otherwise) arising in any way out of
  38 // the use of this software, even if advised of the possibility of such damage.
  39 //
  40 //M*/
  41
  42 #ifndef _CV_HPP_
  43 #define _CV_HPP_
  44
  45 #include "cv.h"
  46
  47 #ifdef __cplusplus
  48
  49 /****************************************************************************************\
  50 *                                      Image class                                       *
  51 \****************************************************************************************/
  52
  53 struct CV_DLL_ENTRY CvImage : public IplImage
  54 {
  55     CvImage();
  56     CvImage( CvSize size, int depth, int channels );
  57     ~CvImage();
  58
  59     uchar* image_data();
  60     const uchar* image_data() const;
  61
  62     CvSize image_roi_size() const;
  63     int    byte_per_pixel() const;
  64
  65     CvImage& operator = ( const CvImage& another )
  66     { return copy( another ); }
  67
  68     CvImage& copy( const CvImage& another );
  69 };
  70
  71 class CV_DLL_ENTRY CvCamShiftTracker
  72 {
  73 public:
  74
  75     CvCamShiftTracker();
  76     virtual ~CvCamShiftTracker();
  77
  78     /**** Characteristics of the object that are calculated by track_object method *****/
  79     float   get_orientation() const // orientation of the object in degrees
  80     { return m_box.angle; }
  81     float   get_length() const // the larger linear size of the object
  82     { return m_box.size.width; }
  83     float   get_width() const // the smaller linear size of the object
  84     { return m_box.size.height; }
  85     CvPoint2D32f get_center() const // center of the object
  86     { return m_box.center; }
  87     CvRect get_window() const // bounding rectangle for the object
  88     { return m_comp.rect; }
  89
  90     /*********************** Tracking parameters ************************/
  91     int     get_threshold() const // thresholding value that applied to back project
  92     { return m_threshold; }
  93
  94     int     get_hist_dims( int* dims = 0 ) const // returns number of histogram dimensions and sets
  95     { return m_hist ? cvGetDims( m_hist->bins, dims ) : 0; }
  96
  97     int     get_min_ch_val( int channel ) const // get the minimum allowed value of the specified channel
  98     { return m_min_ch_val[channel]; }
  99
 100     int     get_max_ch_val( int channel ) const // get the maximum allowed value of the specified channel
 101     { return m_max_ch_val[channel]; }
 102
 103     // set initial object rectangle (must be called before initial calculation of the histogram)
 104     bool    set_window( CvRect window)
 105     { m_comp.rect = window; return true; }
 106
 107     bool    set_threshold( int threshold ) // threshold applied to the histogram bins
 108     { m_threshold = threshold; return true; }
 109
 110     bool    set_hist_bin_range( int dim, int min_val, int max_val );
 111
 112     bool    set_hist_dims( int c_dims, int* dims );// set the histogram parameters
 113
 114     bool    set_min_ch_val( int channel, int val ) // set the minimum allowed value of the specified channel
 115     { m_min_ch_val[channel] = val; return true; }
 116     bool    set_max_ch_val( int channel, int val ) // set the maximum allowed value of the specified channel
 117     { m_max_ch_val[channel] = val; return true; }
 118
 119     /************************ The processing methods *********************************/
 120     // update object position
 121     virtual bool  track_object( const IplImage* cur_frame );
 122
 123     // update object histogram
 124     virtual bool  update_histogram( const IplImage* cur_frame );
 125
 126     // reset histogram
 127     virtual void  reset_histogram();
 128
 129     /************************ Retrieving internal data *******************************/
 130     // get back project image
 131     virtual IplImage* get_back_project()
 132     { return m_back_project; }
 133
 134     float query( int* bin ) const
 135     { return m_hist ? cvQueryHistValue_nD( m_hist, bin ) : 0.f; }
 136
 137 protected:
 138
 139     // internal method for color conversion: fills m_color_planes group
 140     virtual void color_transform( const IplImage* img );
 141
 142     CvHistogram* m_hist;
 143
 144     CvBox2D    m_box;
 145     CvConnectedComp m_comp;
 146
 147     float      m_hist_ranges_data[CV_MAX_DIM][2];
 148     float*     m_hist_ranges[CV_MAX_DIM];
 149
 150     int        m_min_ch_val[CV_MAX_DIM];
 151     int        m_max_ch_val[CV_MAX_DIM];
 152     int        m_threshold;
 153
 154     IplImage*  m_color_planes[CV_MAX_DIM];
 155     IplImage*  m_back_project;
 156     IplImage*  m_temp;
 157     IplImage*  m_mask;
 158 };
 159
 160 #endif /* __cplusplus */
 161 #endif /* _CV_HPP_ */
 162
 163 /* End of file. */