OpenCV 2.4.8 components for OpenCVgrabber.
[mmanager-3rdparty.git] / OpenCV2.4.8 / build / include / opencv2 / highgui / highgui_c.h
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
47 #ifdef __cplusplus
48 extern "C" {
49 #endif /* __cplusplus */
50
51 /****************************************************************************************\
52 *                                  Basic GUI functions                                   *
53 \****************************************************************************************/
54 //YV
55 //-----------New for Qt
56 /* For font */
57 enum {  CV_FONT_LIGHT           = 25,//QFont::Light,
58         CV_FONT_NORMAL          = 50,//QFont::Normal,
59         CV_FONT_DEMIBOLD        = 63,//QFont::DemiBold,
60         CV_FONT_BOLD            = 75,//QFont::Bold,
61         CV_FONT_BLACK           = 87 //QFont::Black
62 };
63
64 enum {  CV_STYLE_NORMAL         = 0,//QFont::StyleNormal,
65         CV_STYLE_ITALIC         = 1,//QFont::StyleItalic,
66         CV_STYLE_OBLIQUE        = 2 //QFont::StyleOblique
67 };
68 /* ---------*/
69
70 //for color cvScalar(blue_component, green_component, red\_component[, alpha_component])
71 //and alpha= 0 <-> 0xFF (not transparent <-> transparent)
72 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));
73
74 CVAPI(void) cvAddText(const CvArr* img, const char* text, CvPoint org, CvFont *arg2);
75
76 CVAPI(void) cvDisplayOverlay(const char* name, const char* text, int delayms CV_DEFAULT(0));
77 CVAPI(void) cvDisplayStatusBar(const char* name, const char* text, int delayms CV_DEFAULT(0));
78
79 CVAPI(void) cvSaveWindowParameters(const char* name);
80 CVAPI(void) cvLoadWindowParameters(const char* name);
81 CVAPI(int) cvStartLoop(int (*pt2Func)(int argc, char *argv[]), int argc, char* argv[]);
82 CVAPI(void) cvStopLoop( void );
83
84 typedef void (CV_CDECL *CvButtonCallback)(int state, void* userdata);
85 enum {CV_PUSH_BUTTON = 0, CV_CHECKBOX = 1, CV_RADIOBOX = 2};
86 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));
87 //----------------------
88
89
90 /* this function is used to set some external parameters in case of X Window */
91 CVAPI(int) cvInitSystem( int argc, char** argv );
92
93 CVAPI(int) cvStartWindowThread( void );
94
95 // ---------  YV ---------
96 enum
97 {
98     //These 3 flags are used by cvSet/GetWindowProperty
99     CV_WND_PROP_FULLSCREEN = 0, //to change/get window's fullscreen property
100     CV_WND_PROP_AUTOSIZE   = 1, //to change/get window's autosize property
101     CV_WND_PROP_ASPECTRATIO= 2, //to change/get window's aspectratio property
102     CV_WND_PROP_OPENGL     = 3, //to change/get window's opengl support
103
104     //These 2 flags are used by cvNamedWindow and cvSet/GetWindowProperty
105     CV_WINDOW_NORMAL       = 0x00000000, //the user can resize the window (no constraint)  / also use to switch a fullscreen window to a normal size
106     CV_WINDOW_AUTOSIZE     = 0x00000001, //the user cannot resize the window, the size is constrainted by the image displayed
107     CV_WINDOW_OPENGL       = 0x00001000, //window with opengl support
108
109     //Those flags are only for Qt
110     CV_GUI_EXPANDED         = 0x00000000, //status bar and tool bar
111     CV_GUI_NORMAL           = 0x00000010, //old fashious way
112
113     //These 3 flags are used by cvNamedWindow and cvSet/GetWindowProperty
114     CV_WINDOW_FULLSCREEN   = 1,//change the window to fullscreen
115     CV_WINDOW_FREERATIO    = 0x00000100,//the image expends as much as it can (no ratio constraint)
116     CV_WINDOW_KEEPRATIO    = 0x00000000//the ration image is respected.
117 };
118
119 /* create window */
120 CVAPI(int) cvNamedWindow( const char* name, int flags CV_DEFAULT(CV_WINDOW_AUTOSIZE) );
121
122 /* Set and Get Property of the window */
123 CVAPI(void) cvSetWindowProperty(const char* name, int prop_id, double prop_value);
124 CVAPI(double) cvGetWindowProperty(const char* name, int prop_id);
125
126 /* display image within window (highgui windows remember their content) */
127 CVAPI(void) cvShowImage( const char* name, const CvArr* image );
128
129 /* resize/move window */
130 CVAPI(void) cvResizeWindow( const char* name, int width, int height );
131 CVAPI(void) cvMoveWindow( const char* name, int x, int y );
132
133
134 /* destroy window and all the trackers associated with it */
135 CVAPI(void) cvDestroyWindow( const char* name );
136
137 CVAPI(void) cvDestroyAllWindows(void);
138
139 /* get native window handle (HWND in case of Win32 and Widget in case of X Window) */
140 CVAPI(void*) cvGetWindowHandle( const char* name );
141
142 /* get name of highgui window given its native handle */
143 CVAPI(const char*) cvGetWindowName( void* window_handle );
144
145
146 typedef void (CV_CDECL *CvTrackbarCallback)(int pos);
147
148 /* create trackbar and display it on top of given window, set callback */
149 CVAPI(int) cvCreateTrackbar( const char* trackbar_name, const char* window_name,
150                              int* value, int count, CvTrackbarCallback on_change CV_DEFAULT(NULL));
151
152 typedef void (CV_CDECL *CvTrackbarCallback2)(int pos, void* userdata);
153
154 CVAPI(int) cvCreateTrackbar2( const char* trackbar_name, const char* window_name,
155                               int* value, int count, CvTrackbarCallback2 on_change,
156                               void* userdata CV_DEFAULT(0));
157
158 /* retrieve or set trackbar position */
159 CVAPI(int) cvGetTrackbarPos( const char* trackbar_name, const char* window_name );
160 CVAPI(void) cvSetTrackbarPos( const char* trackbar_name, const char* window_name, int pos );
161
162 enum
163 {
164     CV_EVENT_MOUSEMOVE      =0,
165     CV_EVENT_LBUTTONDOWN    =1,
166     CV_EVENT_RBUTTONDOWN    =2,
167     CV_EVENT_MBUTTONDOWN    =3,
168     CV_EVENT_LBUTTONUP      =4,
169     CV_EVENT_RBUTTONUP      =5,
170     CV_EVENT_MBUTTONUP      =6,
171     CV_EVENT_LBUTTONDBLCLK  =7,
172     CV_EVENT_RBUTTONDBLCLK  =8,
173     CV_EVENT_MBUTTONDBLCLK  =9
174 };
175
176 enum
177 {
178     CV_EVENT_FLAG_LBUTTON   =1,
179     CV_EVENT_FLAG_RBUTTON   =2,
180     CV_EVENT_FLAG_MBUTTON   =4,
181     CV_EVENT_FLAG_CTRLKEY   =8,
182     CV_EVENT_FLAG_SHIFTKEY  =16,
183     CV_EVENT_FLAG_ALTKEY    =32
184 };
185
186 typedef void (CV_CDECL *CvMouseCallback )(int event, int x, int y, int flags, void* param);
187
188 /* assign callback for mouse events */
189 CVAPI(void) cvSetMouseCallback( const char* window_name, CvMouseCallback on_mouse,
190                                 void* param CV_DEFAULT(NULL));
191
192 enum
193 {
194 /* 8bit, color or not */
195     CV_LOAD_IMAGE_UNCHANGED  =-1,
196 /* 8bit, gray */
197     CV_LOAD_IMAGE_GRAYSCALE  =0,
198 /* ?, color */
199     CV_LOAD_IMAGE_COLOR      =1,
200 /* any depth, ? */
201     CV_LOAD_IMAGE_ANYDEPTH   =2,
202 /* ?, any color */
203     CV_LOAD_IMAGE_ANYCOLOR   =4
204 };
205
206 /* load image from file
207   iscolor can be a combination of above flags where CV_LOAD_IMAGE_UNCHANGED
208   overrides the other flags
209   using CV_LOAD_IMAGE_ANYCOLOR alone is equivalent to CV_LOAD_IMAGE_UNCHANGED
210   unless CV_LOAD_IMAGE_ANYDEPTH is specified images are converted to 8bit
211 */
212 CVAPI(IplImage*) cvLoadImage( const char* filename, int iscolor CV_DEFAULT(CV_LOAD_IMAGE_COLOR));
213 CVAPI(CvMat*) cvLoadImageM( const char* filename, int iscolor CV_DEFAULT(CV_LOAD_IMAGE_COLOR));
214
215 enum
216 {
217     CV_IMWRITE_JPEG_QUALITY =1,
218     CV_IMWRITE_PNG_COMPRESSION =16,
219     CV_IMWRITE_PNG_STRATEGY =17,
220     CV_IMWRITE_PNG_BILEVEL =18,
221     CV_IMWRITE_PNG_STRATEGY_DEFAULT =0,
222     CV_IMWRITE_PNG_STRATEGY_FILTERED =1,
223     CV_IMWRITE_PNG_STRATEGY_HUFFMAN_ONLY =2,
224     CV_IMWRITE_PNG_STRATEGY_RLE =3,
225     CV_IMWRITE_PNG_STRATEGY_FIXED =4,
226     CV_IMWRITE_PXM_BINARY =32
227 };
228
229 /* save image to file */
230 CVAPI(int) cvSaveImage( const char* filename, const CvArr* image,
231                         const int* params CV_DEFAULT(0) );
232
233 /* decode image stored in the buffer */
234 CVAPI(IplImage*) cvDecodeImage( const CvMat* buf, int iscolor CV_DEFAULT(CV_LOAD_IMAGE_COLOR));
235 CVAPI(CvMat*) cvDecodeImageM( const CvMat* buf, int iscolor CV_DEFAULT(CV_LOAD_IMAGE_COLOR));
236
237 /* encode image and store the result as a byte vector (single-row 8uC1 matrix) */
238 CVAPI(CvMat*) cvEncodeImage( const char* ext, const CvArr* image,
239                              const int* params CV_DEFAULT(0) );
240
241 enum
242 {
243     CV_CVTIMG_FLIP      =1,
244     CV_CVTIMG_SWAP_RB   =2
245 };
246
247 /* utility function: convert one image to another with optional vertical flip */
248 CVAPI(void) cvConvertImage( const CvArr* src, CvArr* dst, int flags CV_DEFAULT(0));
249
250 /* wait for key event infinitely (delay<=0) or for "delay" milliseconds */
251 CVAPI(int) cvWaitKey(int delay CV_DEFAULT(0));
252
253 // OpenGL support
254
255 typedef void (CV_CDECL *CvOpenGlDrawCallback)(void* userdata);
256 CVAPI(void) cvSetOpenGlDrawCallback(const char* window_name, CvOpenGlDrawCallback callback, void* userdata CV_DEFAULT(NULL));
257
258 CVAPI(void) cvSetOpenGlContext(const char* window_name);
259 CVAPI(void) cvUpdateWindow(const char* window_name);
260
261
262 /****************************************************************************************\
263 *                         Working with Video Files and Cameras                           *
264 \****************************************************************************************/
265
266 /* "black box" capture structure */
267 typedef struct CvCapture CvCapture;
268
269 /* start capturing frames from video file */
270 CVAPI(CvCapture*) cvCreateFileCapture( const char* filename );
271
272 enum
273 {
274     CV_CAP_ANY      =0,     // autodetect
275
276     CV_CAP_MIL      =100,   // MIL proprietary drivers
277
278     CV_CAP_VFW      =200,   // platform native
279     CV_CAP_V4L      =200,
280     CV_CAP_V4L2     =200,
281
282     CV_CAP_FIREWARE =300,   // IEEE 1394 drivers
283     CV_CAP_FIREWIRE =300,
284     CV_CAP_IEEE1394 =300,
285     CV_CAP_DC1394   =300,
286     CV_CAP_CMU1394  =300,
287
288     CV_CAP_STEREO   =400,   // TYZX proprietary drivers
289     CV_CAP_TYZX     =400,
290     CV_TYZX_LEFT    =400,
291     CV_TYZX_RIGHT   =401,
292     CV_TYZX_COLOR   =402,
293     CV_TYZX_Z       =403,
294
295     CV_CAP_QT       =500,   // QuickTime
296
297     CV_CAP_UNICAP   =600,   // Unicap drivers
298
299     CV_CAP_DSHOW    =700,   // DirectShow (via videoInput)
300     CV_CAP_MSMF     =1400,  // Microsoft Media Foundation (via videoInput)
301
302     CV_CAP_PVAPI    =800,   // PvAPI, Prosilica GigE SDK
303
304     CV_CAP_OPENNI   =900,   // OpenNI (for Kinect)
305     CV_CAP_OPENNI_ASUS =910,   // OpenNI (for Asus Xtion)
306
307     CV_CAP_ANDROID  =1000,  // Android
308     CV_CAP_ANDROID_BACK =CV_CAP_ANDROID+99, // Android back camera
309     CV_CAP_ANDROID_FRONT =CV_CAP_ANDROID+98, // Android front camera
310
311     CV_CAP_XIAPI    =1100,   // XIMEA Camera API
312
313     CV_CAP_AVFOUNDATION = 1200,  // AVFoundation framework for iOS (OS X Lion will have the same API)
314
315     CV_CAP_GIGANETIX = 1300,  // Smartek Giganetix GigEVisionSDK
316
317     CV_CAP_INTELPERC = 1500 // Intel Perceptual Computing SDK
318 };
319
320 /* start capturing frames from camera: index = camera_index + domain_offset (CV_CAP_*) */
321 CVAPI(CvCapture*) cvCreateCameraCapture( int index );
322
323 /* grab a frame, return 1 on success, 0 on fail.
324   this function is thought to be fast               */
325 CVAPI(int) cvGrabFrame( CvCapture* capture );
326
327 /* get the frame grabbed with cvGrabFrame(..)
328   This function may apply some frame processing like
329   frame decompression, flipping etc.
330   !!!DO NOT RELEASE or MODIFY the retrieved frame!!! */
331 CVAPI(IplImage*) cvRetrieveFrame( CvCapture* capture, int streamIdx CV_DEFAULT(0) );
332
333 /* Just a combination of cvGrabFrame and cvRetrieveFrame
334    !!!DO NOT RELEASE or MODIFY the retrieved frame!!!      */
335 CVAPI(IplImage*) cvQueryFrame( CvCapture* capture );
336
337 /* stop capturing/reading and free resources */
338 CVAPI(void) cvReleaseCapture( CvCapture** capture );
339
340 enum
341 {
342     // modes of the controlling registers (can be: auto, manual, auto single push, absolute Latter allowed with any other mode)
343     // every feature can have only one mode turned on at a time
344     CV_CAP_PROP_DC1394_OFF         = -4,  //turn the feature off (not controlled manually nor automatically)
345     CV_CAP_PROP_DC1394_MODE_MANUAL = -3, //set automatically when a value of the feature is set by the user
346     CV_CAP_PROP_DC1394_MODE_AUTO = -2,
347     CV_CAP_PROP_DC1394_MODE_ONE_PUSH_AUTO = -1,
348     CV_CAP_PROP_POS_MSEC       =0,
349     CV_CAP_PROP_POS_FRAMES     =1,
350     CV_CAP_PROP_POS_AVI_RATIO  =2,
351     CV_CAP_PROP_FRAME_WIDTH    =3,
352     CV_CAP_PROP_FRAME_HEIGHT   =4,
353     CV_CAP_PROP_FPS            =5,
354     CV_CAP_PROP_FOURCC         =6,
355     CV_CAP_PROP_FRAME_COUNT    =7,
356     CV_CAP_PROP_FORMAT         =8,
357     CV_CAP_PROP_MODE           =9,
358     CV_CAP_PROP_BRIGHTNESS    =10,
359     CV_CAP_PROP_CONTRAST      =11,
360     CV_CAP_PROP_SATURATION    =12,
361     CV_CAP_PROP_HUE           =13,
362     CV_CAP_PROP_GAIN          =14,
363     CV_CAP_PROP_EXPOSURE      =15,
364     CV_CAP_PROP_CONVERT_RGB   =16,
365     CV_CAP_PROP_WHITE_BALANCE_BLUE_U =17,
366     CV_CAP_PROP_RECTIFICATION =18,
367     CV_CAP_PROP_MONOCROME     =19,
368     CV_CAP_PROP_SHARPNESS     =20,
369     CV_CAP_PROP_AUTO_EXPOSURE =21, // exposure control done by camera,
370                                    // user can adjust refernce level
371                                    // using this feature
372     CV_CAP_PROP_GAMMA         =22,
373     CV_CAP_PROP_TEMPERATURE   =23,
374     CV_CAP_PROP_TRIGGER       =24,
375     CV_CAP_PROP_TRIGGER_DELAY =25,
376     CV_CAP_PROP_WHITE_BALANCE_RED_V =26,
377     CV_CAP_PROP_ZOOM          =27,
378     CV_CAP_PROP_FOCUS         =28,
379     CV_CAP_PROP_GUID          =29,
380     CV_CAP_PROP_ISO_SPEED     =30,
381     CV_CAP_PROP_MAX_DC1394    =31,
382     CV_CAP_PROP_BACKLIGHT     =32,
383     CV_CAP_PROP_PAN           =33,
384     CV_CAP_PROP_TILT          =34,
385     CV_CAP_PROP_ROLL          =35,
386     CV_CAP_PROP_IRIS          =36,
387     CV_CAP_PROP_SETTINGS      =37,
388
389     CV_CAP_PROP_AUTOGRAB      =1024, // property for highgui class CvCapture_Android only
390     CV_CAP_PROP_SUPPORTED_PREVIEW_SIZES_STRING=1025, // readonly, tricky property, returns cpnst char* indeed
391     CV_CAP_PROP_PREVIEW_FORMAT=1026, // readonly, tricky property, returns cpnst char* indeed
392
393     // OpenNI map generators
394     CV_CAP_OPENNI_DEPTH_GENERATOR = 1 << 31,
395     CV_CAP_OPENNI_IMAGE_GENERATOR = 1 << 30,
396     CV_CAP_OPENNI_GENERATORS_MASK = CV_CAP_OPENNI_DEPTH_GENERATOR + CV_CAP_OPENNI_IMAGE_GENERATOR,
397
398     // Properties of cameras available through OpenNI interfaces
399     CV_CAP_PROP_OPENNI_OUTPUT_MODE     = 100,
400     CV_CAP_PROP_OPENNI_FRAME_MAX_DEPTH = 101, // in mm
401     CV_CAP_PROP_OPENNI_BASELINE        = 102, // in mm
402     CV_CAP_PROP_OPENNI_FOCAL_LENGTH    = 103, // in pixels
403     CV_CAP_PROP_OPENNI_REGISTRATION    = 104, // flag
404     CV_CAP_PROP_OPENNI_REGISTRATION_ON = CV_CAP_PROP_OPENNI_REGISTRATION, // flag that synchronizes the remapping depth map to image map
405                                                                           // by changing depth generator's view point (if the flag is "on") or
406                                                                           // sets this view point to its normal one (if the flag is "off").
407     CV_CAP_PROP_OPENNI_APPROX_FRAME_SYNC = 105,
408     CV_CAP_PROP_OPENNI_MAX_BUFFER_SIZE   = 106,
409     CV_CAP_PROP_OPENNI_CIRCLE_BUFFER     = 107,
410     CV_CAP_PROP_OPENNI_MAX_TIME_DURATION = 108,
411
412     CV_CAP_PROP_OPENNI_GENERATOR_PRESENT = 109,
413
414     CV_CAP_OPENNI_IMAGE_GENERATOR_PRESENT         = CV_CAP_OPENNI_IMAGE_GENERATOR + CV_CAP_PROP_OPENNI_GENERATOR_PRESENT,
415     CV_CAP_OPENNI_IMAGE_GENERATOR_OUTPUT_MODE     = CV_CAP_OPENNI_IMAGE_GENERATOR + CV_CAP_PROP_OPENNI_OUTPUT_MODE,
416     CV_CAP_OPENNI_DEPTH_GENERATOR_BASELINE        = CV_CAP_OPENNI_DEPTH_GENERATOR + CV_CAP_PROP_OPENNI_BASELINE,
417     CV_CAP_OPENNI_DEPTH_GENERATOR_FOCAL_LENGTH    = CV_CAP_OPENNI_DEPTH_GENERATOR + CV_CAP_PROP_OPENNI_FOCAL_LENGTH,
418     CV_CAP_OPENNI_DEPTH_GENERATOR_REGISTRATION    = CV_CAP_OPENNI_DEPTH_GENERATOR + CV_CAP_PROP_OPENNI_REGISTRATION,
419     CV_CAP_OPENNI_DEPTH_GENERATOR_REGISTRATION_ON = CV_CAP_OPENNI_DEPTH_GENERATOR_REGISTRATION,
420
421     // Properties of cameras available through GStreamer interface
422     CV_CAP_GSTREAMER_QUEUE_LENGTH   = 200, // default is 1
423     CV_CAP_PROP_PVAPI_MULTICASTIP   = 300, // ip for anable multicast master mode. 0 for disable multicast
424
425     // Properties of cameras available through XIMEA SDK interface
426     CV_CAP_PROP_XI_DOWNSAMPLING  = 400,      // Change image resolution by binning or skipping.
427     CV_CAP_PROP_XI_DATA_FORMAT   = 401,       // Output data format.
428     CV_CAP_PROP_XI_OFFSET_X      = 402,      // Horizontal offset from the origin to the area of interest (in pixels).
429     CV_CAP_PROP_XI_OFFSET_Y      = 403,      // Vertical offset from the origin to the area of interest (in pixels).
430     CV_CAP_PROP_XI_TRG_SOURCE    = 404,      // Defines source of trigger.
431     CV_CAP_PROP_XI_TRG_SOFTWARE  = 405,      // Generates an internal trigger. PRM_TRG_SOURCE must be set to TRG_SOFTWARE.
432     CV_CAP_PROP_XI_GPI_SELECTOR  = 406,      // Selects general purpose input
433     CV_CAP_PROP_XI_GPI_MODE      = 407,      // Set general purpose input mode
434     CV_CAP_PROP_XI_GPI_LEVEL     = 408,      // Get general purpose level
435     CV_CAP_PROP_XI_GPO_SELECTOR  = 409,      // Selects general purpose output
436     CV_CAP_PROP_XI_GPO_MODE      = 410,      // Set general purpose output mode
437     CV_CAP_PROP_XI_LED_SELECTOR  = 411,      // Selects camera signalling LED
438     CV_CAP_PROP_XI_LED_MODE      = 412,      // Define camera signalling LED functionality
439     CV_CAP_PROP_XI_MANUAL_WB     = 413,      // Calculates White Balance(must be called during acquisition)
440     CV_CAP_PROP_XI_AUTO_WB       = 414,      // Automatic white balance
441     CV_CAP_PROP_XI_AEAG          = 415,      // Automatic exposure/gain
442     CV_CAP_PROP_XI_EXP_PRIORITY  = 416,      // Exposure priority (0.5 - exposure 50%, gain 50%).
443     CV_CAP_PROP_XI_AE_MAX_LIMIT  = 417,      // Maximum limit of exposure in AEAG procedure
444     CV_CAP_PROP_XI_AG_MAX_LIMIT  = 418,      // Maximum limit of gain in AEAG procedure
445     CV_CAP_PROP_XI_AEAG_LEVEL    = 419,       // Average intensity of output signal AEAG should achieve(in %)
446     CV_CAP_PROP_XI_TIMEOUT       = 420,       // Image capture timeout in milliseconds
447
448     // Properties for Android cameras
449     CV_CAP_PROP_ANDROID_FLASH_MODE = 8001,
450     CV_CAP_PROP_ANDROID_FOCUS_MODE = 8002,
451     CV_CAP_PROP_ANDROID_WHITE_BALANCE = 8003,
452     CV_CAP_PROP_ANDROID_ANTIBANDING = 8004,
453     CV_CAP_PROP_ANDROID_FOCAL_LENGTH = 8005,
454     CV_CAP_PROP_ANDROID_FOCUS_DISTANCE_NEAR = 8006,
455     CV_CAP_PROP_ANDROID_FOCUS_DISTANCE_OPTIMAL = 8007,
456     CV_CAP_PROP_ANDROID_FOCUS_DISTANCE_FAR = 8008,
457
458     // Properties of cameras available through AVFOUNDATION interface
459     CV_CAP_PROP_IOS_DEVICE_FOCUS = 9001,
460     CV_CAP_PROP_IOS_DEVICE_EXPOSURE = 9002,
461     CV_CAP_PROP_IOS_DEVICE_FLASH = 9003,
462     CV_CAP_PROP_IOS_DEVICE_WHITEBALANCE = 9004,
463     CV_CAP_PROP_IOS_DEVICE_TORCH = 9005,
464
465     // Properties of cameras available through Smartek Giganetix Ethernet Vision interface
466     /* --- Vladimir Litvinenko (litvinenko.vladimir@gmail.com) --- */
467     CV_CAP_PROP_GIGA_FRAME_OFFSET_X = 10001,
468     CV_CAP_PROP_GIGA_FRAME_OFFSET_Y = 10002,
469     CV_CAP_PROP_GIGA_FRAME_WIDTH_MAX = 10003,
470     CV_CAP_PROP_GIGA_FRAME_HEIGH_MAX = 10004,
471     CV_CAP_PROP_GIGA_FRAME_SENS_WIDTH = 10005,
472     CV_CAP_PROP_GIGA_FRAME_SENS_HEIGH = 10006,
473
474     CV_CAP_PROP_INTELPERC_PROFILE_COUNT               = 11001,
475     CV_CAP_PROP_INTELPERC_PROFILE_IDX                 = 11002,
476     CV_CAP_PROP_INTELPERC_DEPTH_LOW_CONFIDENCE_VALUE  = 11003,
477     CV_CAP_PROP_INTELPERC_DEPTH_SATURATION_VALUE      = 11004,
478     CV_CAP_PROP_INTELPERC_DEPTH_CONFIDENCE_THRESHOLD  = 11005,
479     CV_CAP_PROP_INTELPERC_DEPTH_FOCAL_LENGTH_HORZ     = 11006,
480     CV_CAP_PROP_INTELPERC_DEPTH_FOCAL_LENGTH_VERT     = 11007,
481
482     // Intel PerC streams
483     CV_CAP_INTELPERC_DEPTH_GENERATOR = 1 << 29,
484     CV_CAP_INTELPERC_IMAGE_GENERATOR = 1 << 28,
485     CV_CAP_INTELPERC_GENERATORS_MASK = CV_CAP_INTELPERC_DEPTH_GENERATOR + CV_CAP_INTELPERC_IMAGE_GENERATOR
486 };
487
488 enum
489 {
490     // Data given from depth generator.
491     CV_CAP_OPENNI_DEPTH_MAP                 = 0, // Depth values in mm (CV_16UC1)
492     CV_CAP_OPENNI_POINT_CLOUD_MAP           = 1, // XYZ in meters (CV_32FC3)
493     CV_CAP_OPENNI_DISPARITY_MAP             = 2, // Disparity in pixels (CV_8UC1)
494     CV_CAP_OPENNI_DISPARITY_MAP_32F         = 3, // Disparity in pixels (CV_32FC1)
495     CV_CAP_OPENNI_VALID_DEPTH_MASK          = 4, // CV_8UC1
496
497     // Data given from RGB image generator.
498     CV_CAP_OPENNI_BGR_IMAGE                 = 5,
499     CV_CAP_OPENNI_GRAY_IMAGE                = 6
500 };
501
502 // Supported output modes of OpenNI image generator
503 enum
504 {
505     CV_CAP_OPENNI_VGA_30HZ     = 0,
506     CV_CAP_OPENNI_SXGA_15HZ    = 1,
507     CV_CAP_OPENNI_SXGA_30HZ    = 2,
508     CV_CAP_OPENNI_QVGA_30HZ    = 3,
509     CV_CAP_OPENNI_QVGA_60HZ    = 4
510 };
511
512 //supported by Android camera output formats
513 enum
514 {
515     CV_CAP_ANDROID_COLOR_FRAME_BGR = 0, //BGR
516     CV_CAP_ANDROID_COLOR_FRAME = CV_CAP_ANDROID_COLOR_FRAME_BGR,
517     CV_CAP_ANDROID_GREY_FRAME  = 1,  //Y
518     CV_CAP_ANDROID_COLOR_FRAME_RGB = 2,
519     CV_CAP_ANDROID_COLOR_FRAME_BGRA = 3,
520     CV_CAP_ANDROID_COLOR_FRAME_RGBA = 4
521 };
522
523 // supported Android camera flash modes
524 enum
525 {
526     CV_CAP_ANDROID_FLASH_MODE_AUTO = 0,
527     CV_CAP_ANDROID_FLASH_MODE_OFF,
528     CV_CAP_ANDROID_FLASH_MODE_ON,
529     CV_CAP_ANDROID_FLASH_MODE_RED_EYE,
530     CV_CAP_ANDROID_FLASH_MODE_TORCH
531 };
532
533 // supported Android camera focus modes
534 enum
535 {
536     CV_CAP_ANDROID_FOCUS_MODE_AUTO = 0,
537     CV_CAP_ANDROID_FOCUS_MODE_CONTINUOUS_VIDEO,
538     CV_CAP_ANDROID_FOCUS_MODE_EDOF,
539     CV_CAP_ANDROID_FOCUS_MODE_FIXED,
540     CV_CAP_ANDROID_FOCUS_MODE_INFINITY,
541     CV_CAP_ANDROID_FOCUS_MODE_MACRO
542 };
543
544 // supported Android camera white balance modes
545 enum
546 {
547     CV_CAP_ANDROID_WHITE_BALANCE_AUTO = 0,
548     CV_CAP_ANDROID_WHITE_BALANCE_CLOUDY_DAYLIGHT,
549     CV_CAP_ANDROID_WHITE_BALANCE_DAYLIGHT,
550     CV_CAP_ANDROID_WHITE_BALANCE_FLUORESCENT,
551     CV_CAP_ANDROID_WHITE_BALANCE_INCANDESCENT,
552     CV_CAP_ANDROID_WHITE_BALANCE_SHADE,
553     CV_CAP_ANDROID_WHITE_BALANCE_TWILIGHT,
554     CV_CAP_ANDROID_WHITE_BALANCE_WARM_FLUORESCENT
555 };
556
557 // supported Android camera antibanding modes
558 enum
559 {
560     CV_CAP_ANDROID_ANTIBANDING_50HZ = 0,
561     CV_CAP_ANDROID_ANTIBANDING_60HZ,
562     CV_CAP_ANDROID_ANTIBANDING_AUTO,
563     CV_CAP_ANDROID_ANTIBANDING_OFF
564 };
565
566 enum
567 {
568     CV_CAP_INTELPERC_DEPTH_MAP              = 0, // Each pixel is a 16-bit integer. The value indicates the distance from an object to the camera's XY plane or the Cartesian depth.
569     CV_CAP_INTELPERC_UVDEPTH_MAP            = 1, // Each pixel contains two 32-bit floating point values in the range of 0-1, representing the mapping of depth coordinates to the color coordinates.
570     CV_CAP_INTELPERC_IR_MAP                 = 2, // Each pixel is a 16-bit integer. The value indicates the intensity of the reflected laser beam.
571     CV_CAP_INTELPERC_IMAGE                  = 3
572 };
573
574 /* retrieve or set capture properties */
575 CVAPI(double) cvGetCaptureProperty( CvCapture* capture, int property_id );
576 CVAPI(int)    cvSetCaptureProperty( CvCapture* capture, int property_id, double value );
577
578 // Return the type of the capturer (eg, CV_CAP_V4W, CV_CAP_UNICAP), which is unknown if created with CV_CAP_ANY
579 CVAPI(int)    cvGetCaptureDomain( CvCapture* capture);
580
581 /* "black box" video file writer structure */
582 typedef struct CvVideoWriter CvVideoWriter;
583
584 #define CV_FOURCC_MACRO(c1, c2, c3, c4) (((c1) & 255) + (((c2) & 255) << 8) + (((c3) & 255) << 16) + (((c4) & 255) << 24))
585
586 CV_INLINE int CV_FOURCC(char c1, char c2, char c3, char c4)
587 {
588     return CV_FOURCC_MACRO(c1, c2, c3, c4);
589 }
590
591 #define CV_FOURCC_PROMPT -1  /* Open Codec Selection Dialog (Windows only) */
592 #define CV_FOURCC_DEFAULT CV_FOURCC('I', 'Y', 'U', 'V') /* Use default codec for specified filename (Linux only) */
593
594 /* initialize video file writer */
595 CVAPI(CvVideoWriter*) cvCreateVideoWriter( const char* filename, int fourcc,
596                                            double fps, CvSize frame_size,
597                                            int is_color CV_DEFAULT(1));
598
599 //CVAPI(CvVideoWriter*) cvCreateImageSequenceWriter( const char* filename,
600 //                                                   int is_color CV_DEFAULT(1));
601
602 /* write frame to video file */
603 CVAPI(int) cvWriteFrame( CvVideoWriter* writer, const IplImage* image );
604
605 /* close video file writer */
606 CVAPI(void) cvReleaseVideoWriter( CvVideoWriter** writer );
607
608 /****************************************************************************************\
609 *                              Obsolete functions/synonyms                               *
610 \****************************************************************************************/
611
612 #define cvCaptureFromFile cvCreateFileCapture
613 #define cvCaptureFromCAM cvCreateCameraCapture
614 #define cvCaptureFromAVI cvCaptureFromFile
615 #define cvCreateAVIWriter cvCreateVideoWriter
616 #define cvWriteToAVI cvWriteFrame
617 #define cvAddSearchPath(path)
618 #define cvvInitSystem cvInitSystem
619 #define cvvNamedWindow cvNamedWindow
620 #define cvvShowImage cvShowImage
621 #define cvvResizeWindow cvResizeWindow
622 #define cvvDestroyWindow cvDestroyWindow
623 #define cvvCreateTrackbar cvCreateTrackbar
624 #define cvvLoadImage(name) cvLoadImage((name),1)
625 #define cvvSaveImage cvSaveImage
626 #define cvvAddSearchPath cvAddSearchPath
627 #define cvvWaitKey(name) cvWaitKey(0)
628 #define cvvWaitKeyEx(name,delay) cvWaitKey(delay)
629 #define cvvConvertImage cvConvertImage
630 #define HG_AUTOSIZE CV_WINDOW_AUTOSIZE
631 #define set_preprocess_func cvSetPreprocessFuncWin32
632 #define set_postprocess_func cvSetPostprocessFuncWin32
633
634 #if defined WIN32 || defined _WIN32
635
636 CVAPI(void) cvSetPreprocessFuncWin32_(const void* callback);
637 CVAPI(void) cvSetPostprocessFuncWin32_(const void* callback);
638 #define cvSetPreprocessFuncWin32(callback) cvSetPreprocessFuncWin32_((const void*)(callback))
639 #define cvSetPostprocessFuncWin32(callback) cvSetPostprocessFuncWin32_((const void*)(callback))
640
641 #endif
642
643 #ifdef __cplusplus
644 }
645 #endif
646
647 #endif