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 OPENCV_HIGHGUI_H
43 #define OPENCV_HIGHGUI_H
44 
45 #include "opencv2/core/core_c.h"
46 #include "opencv2/imgproc/imgproc_c.h"
47 #ifdef HAVE_OPENCV_IMGCODECS
48 #include "opencv2/imgcodecs/imgcodecs_c.h"
49 #endif
50 #ifdef HAVE_OPENCV_VIDEOIO
51 #include "opencv2/videoio/videoio_c.h"
52 #endif
53 
54 #ifdef __cplusplus
55 extern "C" {
56 #endif /* __cplusplus */
57 
58 /** @addtogroup highgui_c
59   @{
60   */
61 
62 /****************************************************************************************\
63 *                                  Basic GUI functions                                   *
64 \****************************************************************************************/
65 //YV
66 //-----------New for Qt
67 /* For font */
68 enum {  CV_FONT_LIGHT           = 25,//QFont::Light,
69         CV_FONT_NORMAL          = 50,//QFont::Normal,
70         CV_FONT_DEMIBOLD        = 63,//QFont::DemiBold,
71         CV_FONT_BOLD            = 75,//QFont::Bold,
72         CV_FONT_BLACK           = 87 //QFont::Black
73 };
74 
75 enum {  CV_STYLE_NORMAL         = 0,//QFont::StyleNormal,
76         CV_STYLE_ITALIC         = 1,//QFont::StyleItalic,
77         CV_STYLE_OBLIQUE        = 2 //QFont::StyleOblique
78 };
79 /* ---------*/
80 
81 //for color cvScalar(blue_component, green_component, red_component[, alpha_component])
82 //and alpha= 0 <-> 0xFF (not transparent <-> transparent)
83 CVAPI(CvFont) cvFontQt(const char* nameFont, int pointSize CV_DEFAULT(-1), CvScalar color CV_DEFAULT(cvScalarAll(0)), int weight CV_DEFAULT(CV_FONT_NORMAL),  int style CV_DEFAULT(CV_STYLE_NORMAL), int spacing CV_DEFAULT(0));
84 
85 CVAPI(void) cvAddText(const CvArr* img, const char* text, CvPoint org, CvFont *arg2);
86 
87 CVAPI(void) cvDisplayOverlay(const char* name, const char* text, int delayms CV_DEFAULT(0));
88 CVAPI(void) cvDisplayStatusBar(const char* name, const char* text, int delayms CV_DEFAULT(0));
89 
90 CVAPI(void) cvSaveWindowParameters(const char* name);
91 CVAPI(void) cvLoadWindowParameters(const char* name);
92 CVAPI(int) cvStartLoop(int (*pt2Func)(int argc, char *argv[]), int argc, char* argv[]);
93 CVAPI(void) cvStopLoop( void );
94 
95 typedef void (CV_CDECL *CvButtonCallback)(int state, void* userdata);
96 enum {CV_PUSH_BUTTON = 0, CV_CHECKBOX = 1, CV_RADIOBOX = 2};
97 CVAPI(int) cvCreateButton( const char* button_name CV_DEFAULT(NULL),CvButtonCallback on_change CV_DEFAULT(NULL), void* userdata CV_DEFAULT(NULL) , int button_type CV_DEFAULT(CV_PUSH_BUTTON), int initial_button_state CV_DEFAULT(0));
98 //----------------------
99 
100 
101 /* this function is used to set some external parameters in case of X Window */
102 CVAPI(int) cvInitSystem( int argc, char** argv );
103 
104 CVAPI(int) cvStartWindowThread( void );
105 
106 // ---------  YV ---------
107 enum
108 {
109     //These 3 flags are used by cvSet/GetWindowProperty
110     CV_WND_PROP_FULLSCREEN = 0, //to change/get window's fullscreen property
111     CV_WND_PROP_AUTOSIZE   = 1, //to change/get window's autosize property
112     CV_WND_PROP_ASPECTRATIO= 2, //to change/get window's aspectratio property
113     CV_WND_PROP_OPENGL     = 3, //to change/get window's opengl support
114     CV_WND_PROP_VISIBLE    = 4,
115 
116     //These 2 flags are used by cvNamedWindow and cvSet/GetWindowProperty
117     CV_WINDOW_NORMAL       = 0x00000000, //the user can resize the window (no constraint)  / also use to switch a fullscreen window to a normal size
118     CV_WINDOW_AUTOSIZE     = 0x00000001, //the user cannot resize the window, the size is constrainted by the image displayed
119     CV_WINDOW_OPENGL       = 0x00001000, //window with opengl support
120 
121     //Those flags are only for Qt
122     CV_GUI_EXPANDED         = 0x00000000, //status bar and tool bar
123     CV_GUI_NORMAL           = 0x00000010, //old fashious way
124 
125     //These 3 flags are used by cvNamedWindow and cvSet/GetWindowProperty
126     CV_WINDOW_FULLSCREEN   = 1,//change the window to fullscreen
127     CV_WINDOW_FREERATIO    = 0x00000100,//the image expends as much as it can (no ratio constraint)
128     CV_WINDOW_KEEPRATIO    = 0x00000000//the ration image is respected.
129 };
130 
131 /* create window */
132 CVAPI(int) cvNamedWindow( const char* name, int flags CV_DEFAULT(CV_WINDOW_AUTOSIZE) );
133 
134 /* Set and Get Property of the window */
135 CVAPI(void) cvSetWindowProperty(const char* name, int prop_id, double prop_value);
136 CVAPI(double) cvGetWindowProperty(const char* name, int prop_id);
137 
138 /* Get window image rectangle coordinates, width and height */
139 CVAPI(cv::Rect)cvGetWindowImageRect(const char* name);
140 
141 /* display image within window (highgui windows remember their content) */
142 CVAPI(void) cvShowImage( const char* name, const CvArr* image );
143 
144 /* resize/move window */
145 CVAPI(void) cvResizeWindow( const char* name, int width, int height );
146 CVAPI(void) cvMoveWindow( const char* name, int x, int y );
147 
148 
149 /* destroy window and all the trackers associated with it */
150 CVAPI(void) cvDestroyWindow( const char* name );
151 
152 CVAPI(void) cvDestroyAllWindows(void);
153 
154 /* get native window handle (HWND in case of Win32 and Widget in case of X Window) */
155 CVAPI(void*) cvGetWindowHandle( const char* name );
156 
157 /* get name of highgui window given its native handle */
158 CVAPI(const char*) cvGetWindowName( void* window_handle );
159 
160 
161 typedef void (CV_CDECL *CvTrackbarCallback)(int pos);
162 
163 /* create trackbar and display it on top of given window, set callback */
164 CVAPI(int) cvCreateTrackbar( const char* trackbar_name, const char* window_name,
165                              int* value, int count, CvTrackbarCallback on_change CV_DEFAULT(NULL));
166 
167 typedef void (CV_CDECL *CvTrackbarCallback2)(int pos, void* userdata);
168 
169 CVAPI(int) cvCreateTrackbar2( const char* trackbar_name, const char* window_name,
170                               int* value, int count, CvTrackbarCallback2 on_change,
171                               void* userdata CV_DEFAULT(0));
172 
173 /* retrieve or set trackbar position */
174 CVAPI(int) cvGetTrackbarPos( const char* trackbar_name, const char* window_name );
175 CVAPI(void) cvSetTrackbarPos( const char* trackbar_name, const char* window_name, int pos );
176 CVAPI(void) cvSetTrackbarMax(const char* trackbar_name, const char* window_name, int maxval);
177 CVAPI(void) cvSetTrackbarMin(const char* trackbar_name, const char* window_name, int minval);
178 
179 enum
180 {
181     CV_EVENT_MOUSEMOVE      =0,
182     CV_EVENT_LBUTTONDOWN    =1,
183     CV_EVENT_RBUTTONDOWN    =2,
184     CV_EVENT_MBUTTONDOWN    =3,
185     CV_EVENT_LBUTTONUP      =4,
186     CV_EVENT_RBUTTONUP      =5,
187     CV_EVENT_MBUTTONUP      =6,
188     CV_EVENT_LBUTTONDBLCLK  =7,
189     CV_EVENT_RBUTTONDBLCLK  =8,
190     CV_EVENT_MBUTTONDBLCLK  =9,
191     CV_EVENT_MOUSEWHEEL     =10,
192     CV_EVENT_MOUSEHWHEEL    =11
193 };
194 
195 enum
196 {
197     CV_EVENT_FLAG_LBUTTON   =1,
198     CV_EVENT_FLAG_RBUTTON   =2,
199     CV_EVENT_FLAG_MBUTTON   =4,
200     CV_EVENT_FLAG_CTRLKEY   =8,
201     CV_EVENT_FLAG_SHIFTKEY  =16,
202     CV_EVENT_FLAG_ALTKEY    =32
203 };
204 
205 
206 #define CV_GET_WHEEL_DELTA(flags) ((short)((flags >> 16) & 0xffff)) // upper 16 bits
207 
208 typedef void (CV_CDECL *CvMouseCallback )(int event, int x, int y, int flags, void* param);
209 
210 /* assign callback for mouse events */
211 CVAPI(void) cvSetMouseCallback( const char* window_name, CvMouseCallback on_mouse,
212                                 void* param CV_DEFAULT(NULL));
213 
214 /* wait for key event infinitely (delay<=0) or for "delay" milliseconds */
215 CVAPI(int) cvWaitKey(int delay CV_DEFAULT(0));
216 
217 // OpenGL support
218 
219 typedef void (CV_CDECL *CvOpenGlDrawCallback)(void* userdata);
220 CVAPI(void) cvSetOpenGlDrawCallback(const char* window_name, CvOpenGlDrawCallback callback, void* userdata CV_DEFAULT(NULL));
221 
222 CVAPI(void) cvSetOpenGlContext(const char* window_name);
223 CVAPI(void) cvUpdateWindow(const char* window_name);
224 
225 
226 /****************************************************************************************\
227 
228 *                              Obsolete functions/synonyms                               *
229 \****************************************************************************************/
230 
231 #define cvAddSearchPath(path)
232 #define cvvInitSystem cvInitSystem
233 #define cvvNamedWindow cvNamedWindow
234 #define cvvShowImage cvShowImage
235 #define cvvResizeWindow cvResizeWindow
236 #define cvvDestroyWindow cvDestroyWindow
237 #define cvvCreateTrackbar cvCreateTrackbar
238 #define cvvAddSearchPath cvAddSearchPath
239 #define cvvWaitKey(name) cvWaitKey(0)
240 #define cvvWaitKeyEx(name,delay) cvWaitKey(delay)
241 #define HG_AUTOSIZE CV_WINDOW_AUTOSIZE
242 #define set_preprocess_func cvSetPreprocessFuncWin32
243 #define set_postprocess_func cvSetPostprocessFuncWin32
244 
245 #if defined _WIN32
246 
247 CVAPI(void) cvSetPreprocessFuncWin32_(const void* callback);
248 CVAPI(void) cvSetPostprocessFuncWin32_(const void* callback);
249 #define cvSetPreprocessFuncWin32(callback) cvSetPreprocessFuncWin32_((const void*)(callback))
250 #define cvSetPostprocessFuncWin32(callback) cvSetPostprocessFuncWin32_((const void*)(callback))
251 
252 #endif
253 
254 /** @} highgui_c */
255 
256 #ifdef __cplusplus
257 }
258 #endif
259 
260 #endif
261