• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
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 __CREATESAMPLES_UTILITY_HPP__
43 #define __CREATESAMPLES_UTILITY_HPP__
44 
45 #define CV_VERBOSE  1
46 
47 /*
48  * cvCreateTrainingSamples
49  *
50  * Create training samples applying random distortions to sample image and
51  * store them in .vec file
52  *
53  * filename        - .vec file name
54  * imgfilename     - sample image file name
55  * bgcolor         - background color for sample image
56  * bgthreshold     - background color threshold. Pixels those colors are in range
57  *   [bgcolor-bgthreshold, bgcolor+bgthreshold] are considered as transparent
58  * bgfilename      - background description file name. If not NULL samples
59  *   will be put on arbitrary background
60  * count           - desired number of samples
61  * invert          - if not 0 sample foreground pixels will be inverted
62  *   if invert == CV_RANDOM_INVERT then samples will be inverted randomly
63  * maxintensitydev - desired max intensity deviation of foreground samples pixels
64  * maxxangle       - max rotation angles
65  * maxyangle
66  * maxzangle
67  * showsamples     - if not 0 samples will be shown
68  * winwidth        - desired samples width
69  * winheight       - desired samples height
70  */
71 #define CV_RANDOM_INVERT 0x7FFFFFFF
72 
73 void cvCreateTrainingSamples( const char* filename,
74                               const char* imgfilename, int bgcolor, int bgthreshold,
75                               const char* bgfilename, int count,
76                               int invert = 0, int maxintensitydev = 40,
77                               double maxxangle = 1.1,
78                               double maxyangle = 1.1,
79                               double maxzangle = 0.5,
80                               int showsamples = 0,
81                               int winwidth = 24, int winheight = 24 );
82 
83 void cvCreateTestSamples( const char* infoname,
84                           const char* imgfilename, int bgcolor, int bgthreshold,
85                           const char* bgfilename, int count,
86                           int invert, int maxintensitydev,
87                           double maxxangle, double maxyangle, double maxzangle,
88                           int showsamples,
89                           int winwidth, int winheight );
90 
91 /*
92  * cvCreateTrainingSamplesFromInfo
93  *
94  * Create training samples from a set of marked up images and store them into .vec file
95  * infoname    - file in which marked up image descriptions are stored
96  * num         - desired number of samples
97  * showsamples - if not 0 samples will be shown
98  * winwidth    - sample width
99  * winheight   - sample height
100  *
101  * Return number of successfully created samples
102  */
103 int cvCreateTrainingSamplesFromInfo( const char* infoname, const char* vecfilename,
104                                      int num,
105                                      int showsamples,
106                                      int winwidth, int winheight );
107 
108 /*
109  * cvShowVecSamples
110  *
111  * Shows samples stored in .vec file
112  *
113  * filename
114  *   .vec file name
115  * winwidth
116  *   sample width
117  * winheight
118  *   sample height
119  * scale
120  *   the scale each sample is adjusted to
121  */
122 void cvShowVecSamples( const char* filename, int winwidth, int winheight, double scale );
123 
124 #endif //__CREATESAMPLES_UTILITY_HPP__
125