/*M/////////////////////////////////////////////////////////////////////////////////////// // // IMPORTANT: READ BEFORE DOWNLOADING, COPYING, INSTALLING OR USING. // // By downloading, copying, installing or using the software you agree to this license. // If you do not agree to this license, do not download, install, // copy or use the software. // // // Intel License Agreement // For Open Source Computer Vision Library // // Copyright (C) 2000, Intel Corporation, all rights reserved. // Third party copyrights are property of their respective owners. // // Redistribution and use in source and binary forms, with or without modification, // are permitted provided that the following conditions are met: // // * Redistribution's of source code must retain the above copyright notice, // this list of conditions and the following disclaimer. // // * Redistribution's in binary form must reproduce the above copyright notice, // 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 // derived from this software without specific prior written permission. // // This software is provided by the copyright holders and contributors "as is" and // any express or implied warranties, including, but not limited to, the implied // warranties of merchantability and fitness for a particular purpose are disclaimed. // In no event shall the Intel Corporation or contributors be liable for any direct, // indirect, incidental, special, exemplary, or consequential damages // (including, but not limited to, procurement of substitute goods or services; // loss of use, data, or profits; or business interruption) however caused // and on any theory of liability, whether in contract, strict liability, // or tort (including negligence or otherwise) arising in any way out of // the use of this software, even if advised of the possibility of such damage. // //M*/ #ifndef __OPENCV_HIGHGUI_H__ #define __OPENCV_HIGHGUI_H__ #include "opencv2/core/core_c.h" #ifdef __cplusplus extern "C" { #endif /* __cplusplus */ /**************************************************************************************** * Basic GUI functions * ****************************************************************************************/ //YV //-----------New for Qt /* For font */ enum { CV_FONT_LIGHT = 25, //QFont::Light, CV_FONT_NORMAL = 50, //QFont::Normal, CV_FONT_DEMIBOLD = 63, //QFont::DemiBold, CV_FONT_BOLD = 75, //QFont::Bold, CV_FONT_BLACK = 87 //QFont::Black }; enum { CV_STYLE_NORMAL = 0,//QFont::StyleNormal, CV_STYLE_ITALIC = 1, //QFont::StyleItalic, CV_STYLE_OBLIQUE = 2 //QFont::StyleOblique }; /* ---------*/ //for color cvScalar(blue_component, green_component, red\_component[, alpha_component]) //and alpha= 0 <-> 0xFF (not transparent <-> transparent) 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)); CVAPI(void) cvAddText( const CvArr* img, const char* text, CvPoint org, CvFont *arg2); CVAPI(void) cvDisplayOverlay( const char * name, const char* text, int delayms); CVAPI(void) cvDisplayStatusBar( const char * name, const char* text, int delayms); typedef void (CV_CDECL *CvOpenGLCallback)(void* userdata); CVAPI(void) cvCreateOpenGLCallback( const char * window_name, CvOpenGLCallback callbackOpenGL, void* userdata CV_DEFAULT(NULL), double angle CV_DEFAULT(-1), double zmin CV_DEFAULT(-1), double zmax CV_DEFAULT(-1)); CVAPI(void) cvSaveWindowParameters( const char * name); CVAPI(void) cvLoadWindowParameters( const char * name); CVAPI(int) cvStartLoop( int (*pt2Func)(int argc, char *argv[]), int argc, char * argv[]); CVAPI(void) cvStopLoop(); typedef void (CV_CDECL *CvButtonCallback)(int state, void* userdata); enum {CV_PUSH_BUTTON = 0, CV_CHECKBOX = 1, CV_RADIOBOX = 2}; 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)); //---------------------- /* this function is used to set some external parameters in case of X Window */ CVAPI(int) cvInitSystem( int argc, char ** argv ); CVAPI(int) cvStartWindowThread(); // --------- YV --------- enum { //These 3 flags are used by cvSet/GetWindowProperty CV_WND_PROP_FULLSCREEN = 0, //to change/get window's fullscreen property CV_WND_PROP_AUTOSIZE = 1, //to change/get window's autosize property CV_WND_PROP_ASPECTRATIO= 2, //to change/get window's aspectratio property // //These 2 flags are used by cvNamedWindow and cvSet/GetWindowProperty CV_WINDOW_NORMAL = 0x00000000, //the user can resize the window (no constraint) / also use to switch a fullscreen window to a normal size CV_WINDOW_AUTOSIZE = 0x00000001, //the user cannot resize the window, the size is constrainted by the image displayed // //Those flags are only for Qt CV_GUI_EXPANDED = 0x00000000, //status bar and tool bar CV_GUI_NORMAL = 0x00000010, //old fashious way // //These 3 flags are used by cvNamedWindow and cvSet/GetWindowProperty CV_WINDOW_FULLSCREEN = 1, //change the window to fullscreen CV_WINDOW_FREERATIO = 0x00000100, //the image expends as much as it can (no ratio constraint) CV_WINDOW_KEEPRATIO = 0x00000000 //the ration image is respected. }; /* create window */ CVAPI(int) cvNamedWindow( const char * name, int flags CV_DEFAULT(CV_WINDOW_AUTOSIZE) ); /* Set and Get Property of the window */ CVAPI(void) cvSetWindowProperty( const char * name, int prop_id, double prop_value); CVAPI(double) cvGetWindowProperty( const char * name, int prop_id); /* display image within window (highgui windows remember their content) */ CVAPI(void) cvShowImage( const char * name, const CvArr* image ); /* resize/move window */ CVAPI(void) cvResizeWindow( const char * name, int width, int height ); CVAPI(void) cvMoveWindow( const char * name, int x, int y ); /* destroy window and all the trackers associated with it */ CVAPI(void) cvDestroyWindow( const char * name ); CVAPI(void) cvDestroyAllWindows( void); /* get native window handle (HWND in case of Win32 and Widget in case of X Window) */ CVAPI(void*) cvGetWindowHandle( const char * name ); /* get name of highgui window given its native handle */ CVAPI(const char*) cvGetWindowName( void * window_handle ); typedef void (CV_CDECL *CvTrackbarCallback)(int pos); /* create trackbar and display it on top of given window, set callback */ CVAPI(int) cvCreateTrackbar( const char * trackbar_name, const char* window_name, int* value, int count, CvTrackbarCallback on_change CV_DEFAULT(NULL)); typedef void (CV_CDECL *CvTrackbarCallback2)(int pos, void* userdata); CVAPI(int) cvCreateTrackbar2( const char * trackbar_name, const char* window_name, int* value, int count, CvTrackbarCallback2 on_change, void* userdata CV_DEFAULT(0)); /* retrieve or set trackbar position */ CVAPI(int) cvGetTrackbarPos( const char * trackbar_name, const char* window_name ); CVAPI(void) cvSetTrackbarPos( const char * trackbar_name, const char* window_name, int pos ); enum { CV_EVENT_MOUSEMOVE =0, CV_EVENT_LBUTTONDOWN =1, CV_EVENT_RBUTTONDOWN =2, CV_EVENT_MBUTTONDOWN =3, CV_EVENT_LBUTTONUP =4, CV_EVENT_RBUTTONUP =5, CV_EVENT_MBUTTONUP =6, CV_EVENT_LBUTTONDBLCLK =7, CV_EVENT_RBUTTONDBLCLK =8, CV_EVENT_MBUTTONDBLCLK =9 }; enum { CV_EVENT_FLAG_LBUTTON =1, CV_EVENT_FLAG_RBUTTON =2, CV_EVENT_FLAG_MBUTTON =4, CV_EVENT_FLAG_CTRLKEY =8, CV_EVENT_FLAG_SHIFTKEY =16, CV_EVENT_FLAG_ALTKEY =32 }; typedef void (CV_CDECL *CvMouseCallback )(int event, int x, int y, int flags, void * param); /* assign callback for mouse events */ CVAPI(void) cvSetMouseCallback( const char * window_name, CvMouseCallback on_mouse, void* param CV_DEFAULT(NULL)); enum { /* 8bit, color or not */ CV_LOAD_IMAGE_UNCHANGED =-1, /* 8bit, gray */ CV_LOAD_IMAGE_GRAYSCALE =0, /* ?, color */ CV_LOAD_IMAGE_COLOR =1, /* any depth, ? */ CV_LOAD_IMAGE_ANYDEPTH =2, /* ?, any color */ CV_LOAD_IMAGE_ANYCOLOR =4 }; /* load image from file iscolor can be a combination of above flags where CV_LOAD_IMAGE_UNCHANGED overrides the other flags using CV_LOAD_IMAGE_ANYCOLOR alone is equivalent to CV_LOAD_IMAGE_UNCHANGED unless CV_LOAD_IMAGE_ANYDEPTH is specified images are converted to 8bit */ CVAPI(IplImage*) cvLoadImage( const char * filename, int iscolor CV_DEFAULT(CV_LOAD_IMAGE_COLOR)); CVAPI(CvMat*) cvLoadImageM( const char * filename, int iscolor CV_DEFAULT(CV_LOAD_IMAGE_COLOR)); enum { CV_IMWRITE_JPEG_QUALITY =1, CV_IMWRITE_PNG_COMPRESSION =16, CV_IMWRITE_PXM_BINARY =32 }; /* save image to file */ CVAPI(int) cvSaveImage( const char * filename, const CvArr* image, const int * params CV_DEFAULT(0) ); /* decode image stored in the buffer */ CVAPI(IplImage*) cvDecodeImage( const CvMat* buf, int iscolor CV_DEFAULT(CV_LOAD_IMAGE_COLOR)); CVAPI(CvMat*) cvDecodeImageM( const CvMat* buf, int iscolor CV_DEFAULT(CV_LOAD_IMAGE_COLOR)); /* encode image and store the result as a byte vector (single-row 8uC1 matrix) */ CVAPI(CvMat*) cvEncodeImage( const char * ext, const CvArr* image, const int * params CV_DEFAULT(0) ); enum { CV_CVTIMG_FLIP =1, CV_CVTIMG_SWAP_RB =2 }; /* utility function: convert one image to another with optional vertical flip */ CVAPI(void) cvConvertImage( const CvArr* src, CvArr* dst, int flags CV_DEFAULT(0)); /* wait for key event infinitely (delay<=0) or for "delay" milliseconds */ CVAPI(int) cvWaitKey( int delay CV_DEFAULT(0)); /**************************************************************************************** * Working with Video Files and Cameras * ****************************************************************************************/ /* "black box" capture structure */ typedef struct CvCapture CvCapture; /* start capturing frames from video file */ CVAPI(CvCapture*) cvCreateFileCapture( const char * filename ); enum { CV_CAP_ANY =0, // autodetect CV_CAP_MIL =100, // MIL proprietary drivers CV_CAP_VFW =200, // platform native CV_CAP_V4L =200, CV_CAP_V4L2 =200, CV_CAP_FIREWARE =300, // IEEE 1394 drivers CV_CAP_FIREWIRE =300, CV_CAP_IEEE1394 =300, CV_CAP_DC1394 =300, CV_CAP_CMU1394 =300, CV_CAP_STEREO =400, // TYZX proprietary drivers CV_CAP_TYZX =400, CV_TYZX_LEFT =400, CV_TYZX_RIGHT =401, CV_TYZX_COLOR =402, CV_TYZX_Z =403, CV_CAP_QT =500, // QuickTime CV_CAP_UNICAP =600, // Unicap drivers CV_CAP_DSHOW =700, // DirectShow (via videoInput) CV_CAP_PVAPI =800, // PvAPI, Prosilica GigE SDK CV_CAP_OPENNI =900, // OpenNI (for Kinect) CV_CAP_ANDROID =1000, // Android CV_CAP_XIAPI =1100 // XIMEA Camera API }; /* start capturing frames from camera: index = camera_index + domain_offset (CV_CAP_*) */ CVAPI(CvCapture*) cvCreateCameraCapture( int index ); /* grab a frame, return 1 on success, 0 on fail. this function is thought to be fast */ CVAPI(int) cvGrabFrame( CvCapture* capture ); /* get the frame grabbed with cvGrabFrame(..) This function may apply some frame processing like frame decompression, flipping etc. !!!DO NOT RELEASE or MODIFY the retrieved frame!!! */ CVAPI(IplImage*) cvRetrieveFrame( CvCapture* capture, int streamIdx CV_DEFAULT(0) ); /* Just a combination of cvGrabFrame and cvRetrieveFrame !!!DO NOT RELEASE or MODIFY the retrieved frame!!! */ CVAPI(IplImage*) cvQueryFrame( CvCapture* capture ); /* stop capturing/reading and free resources */ CVAPI(void) cvReleaseCapture( CvCapture** capture ); enum { // modes of the controlling registers (can be: auto, manual, auto single push, absolute Latter allowed with any other mode) // every feature can have only one mode turned on at a time CV_CAP_PROP_DC1394_OFF = -4, //turn the feature off (not controlled manually nor automatically) CV_CAP_PROP_DC1394_MODE_MANUAL = -3, //set automatically when a value of the feature is set by the user CV_CAP_PROP_DC1394_MODE_AUTO = -2, CV_CAP_PROP_DC1394_MODE_ONE_PUSH_AUTO = -1, CV_CAP_PROP_POS_MSEC =0, CV_CAP_PROP_POS_FRAMES =1, CV_CAP_PROP_POS_AVI_RATIO =2, CV_CAP_PROP_FRAME_WIDTH =3, CV_CAP_PROP_FRAME_HEIGHT =4, CV_CAP_PROP_FPS =5, CV_CAP_PROP_FOURCC =6, CV_CAP_PROP_FRAME_COUNT =7, CV_CAP_PROP_FORMAT =8, CV_CAP_PROP_MODE =9, CV_CAP_PROP_BRIGHTNESS =10, CV_CAP_PROP_CONTRAST =11, CV_CAP_PROP_SATURATION =12, CV_CAP_PROP_HUE =13, CV_CAP_PROP_GAIN =14, CV_CAP_PROP_EXPOSURE =15, CV_CAP_PROP_CONVERT_RGB =16, CV_CAP_PROP_WHITE_BALANCE_BLUE_U =17, CV_CAP_PROP_RECTIFICATION =18, CV_CAP_PROP_MONOCROME =19, CV_CAP_PROP_SHARPNESS =20, CV_CAP_PROP_AUTO_EXPOSURE =21, // exposure control done by camera, // user can adjust refernce level // using this feature CV_CAP_PROP_GAMMA =22, CV_CAP_PROP_TEMPERATURE =23, CV_CAP_PROP_TRIGGER =24, CV_CAP_PROP_TRIGGER_DELAY =25, CV_CAP_PROP_WHITE_BALANCE_RED_V =26, CV_CAP_PROP_MAX_DC1394 =27, CV_CAP_PROP_AUTOGRAB =1024, // property for highgui class CvCapture_Android only CV_CAP_PROP_SUPPORTED_PREVIEW_SIZES_STRING=1025, // readonly, tricky property, returns cpnst char* indeed CV_CAP_PROP_PREVIEW_FORMAT=1026, // readonly, tricky property, returns cpnst char* indeed // OpenNI map generators CV_CAP_OPENNI_DEPTH_GENERATOR = 0, CV_CAP_OPENNI_IMAGE_GENERATOR = 1 << 31, CV_CAP_OPENNI_GENERATORS_MASK = 1 << 31, // Properties of cameras available through OpenNI interfaces CV_CAP_PROP_OPENNI_OUTPUT_MODE = 100, CV_CAP_PROP_OPENNI_FRAME_MAX_DEPTH = 101, // in mm CV_CAP_PROP_OPENNI_BASELINE = 102, // in mm CV_CAP_PROP_OPENNI_FOCAL_LENGTH = 103, // in pixels CV_CAP_PROP_OPENNI_REGISTRATION_ON = 104, // flag CV_CAP_PROP_OPENNI_REGISTRATION = CV_CAP_PROP_OPENNI_REGISTRATION_ON, // flag that synchronizes the remapping depth map to image map // by changing depth generator's view point (if the flag is "on") or // sets this view point to its normal one (if the flag is "off"). CV_CAP_OPENNI_IMAGE_GENERATOR_OUTPUT_MODE = CV_CAP_OPENNI_IMAGE_GENERATOR + CV_CAP_PROP_OPENNI_OUTPUT_MODE, CV_CAP_OPENNI_DEPTH_GENERATOR_BASELINE = CV_CAP_OPENNI_DEPTH_GENERATOR + CV_CAP_PROP_OPENNI_BASELINE, CV_CAP_OPENNI_DEPTH_GENERATOR_FOCAL_LENGTH = CV_CAP_OPENNI_DEPTH_GENERATOR + CV_CAP_PROP_OPENNI_FOCAL_LENGTH, CV_CAP_OPENNI_DEPTH_GENERATOR_REGISTRATION_ON = CV_CAP_OPENNI_DEPTH_GENERATOR + CV_CAP_PROP_OPENNI_REGISTRATION_ON, // Properties of cameras available through GStreamer interface CV_CAP_GSTREAMER_QUEUE_LENGTH = 200, // default is 1 CV_CAP_PROP_PVAPI_MULTICASTIP = 300, // ip for anable multicast master mode. 0 for disable multicast // Properties of cameras available through XIMEA SDK interface CV_CAP_PROP_XI_DOWNSAMPLING = 400, // Change image resolution by binning or skipping. CV_CAP_PROP_XI_DATA_FORMAT = 401, // Output data format. CV_CAP_PROP_XI_OFFSET_X = 402, // Horizontal offset from the origin to the area of interest (in pixels). CV_CAP_PROP_XI_OFFSET_Y = 403, // Vertical offset from the origin to the area of interest (in pixels). CV_CAP_PROP_XI_TRG_SOURCE = 404, // Defines source of trigger. CV_CAP_PROP_XI_TRG_SOFTWARE = 405, // Generates an internal trigger. PRM_TRG_SOURCE must be set to TRG_SOFTWARE. CV_CAP_PROP_XI_GPI_SELECTOR = 406, // Selects general purpose input CV_CAP_PROP_XI_GPI_MODE = 407, // Set general purpose input mode CV_CAP_PROP_XI_GPI_LEVEL = 408, // Get general purpose level CV_CAP_PROP_XI_GPO_SELECTOR = 409, // Selects general purpose output CV_CAP_PROP_XI_GPO_MODE = 410, // Set general purpose output mode CV_CAP_PROP_XI_LED_SELECTOR = 411, // Selects camera signalling LED CV_CAP_PROP_XI_LED_MODE = 412, // Define camera signalling LED functionality CV_CAP_PROP_XI_MANUAL_WB = 413, // Calculates White Balance(must be called during acquisition) CV_CAP_PROP_XI_AUTO_WB = 414, // Automatic white balance CV_CAP_PROP_XI_AEAG = 415, // Automatic exposure/gain CV_CAP_PROP_XI_EXP_PRIORITY = 416, // Exposure priority (0.5 - exposure 50%, gain 50%). CV_CAP_PROP_XI_AE_MAX_LIMIT = 417, // Maximum limit of exposure in AEAG procedure CV_CAP_PROP_XI_AG_MAX_LIMIT = 418, // Maximum limit of gain in AEAG procedure CV_CAP_PROP_XI_AEAG_LEVEL = 419, // Average intensity of output signal AEAG should achieve(in %) CV_CAP_PROP_XI_TIMEOUT = 420 // Image capture timeout in milliseconds }; enum { // Data given from depth generator. CV_CAP_OPENNI_DEPTH_MAP = 0, // Depth values in mm (CV_16UC1) CV_CAP_OPENNI_POINT_CLOUD_MAP = 1, // XYZ in meters (CV_32FC3) CV_CAP_OPENNI_DISPARITY_MAP = 2, // Disparity in pixels (CV_8UC1) CV_CAP_OPENNI_DISPARITY_MAP_32F = 3, // Disparity in pixels (CV_32FC1) CV_CAP_OPENNI_VALID_DEPTH_MASK = 4, // CV_8UC1 // Data given from RGB image generator. CV_CAP_OPENNI_BGR_IMAGE = 5, CV_CAP_OPENNI_GRAY_IMAGE = 6 }; // Supported output modes of OpenNI image generator enum { CV_CAP_OPENNI_VGA_30HZ = 0, CV_CAP_OPENNI_SXGA_15HZ = 1 }; //supported by Android camera output formats enum { CV_CAP_ANDROID_COLOR_FRAME_BGR = 0, //BGR CV_CAP_ANDROID_COLOR_FRAME = CV_CAP_ANDROID_COLOR_FRAME_BGR, CV_CAP_ANDROID_GREY_FRAME = 1, //Y CV_CAP_ANDROID_COLOR_FRAME_RGB = 2, CV_CAP_ANDROID_COLOR_FRAME_BGRA = 3, CV_CAP_ANDROID_COLOR_FRAME_RGBA = 4 }; /* retrieve or set capture properties */ CVAPI(double) cvGetCaptureProperty( CvCapture* capture, int property_id ); CVAPI(int) cvSetCaptureProperty( CvCapture* capture, int property_id, double value ); // Return the type of the capturer (eg, CV_CAP_V4W, CV_CAP_UNICAP), which is unknown if created with CV_CAP_ANY CVAPI(int) cvGetCaptureDomain( CvCapture* capture); /* "black box" video file writer structure */ typedef struct CvVideoWriter CvVideoWriter; CV_INLINE int CV_FOURCC( char c1, char c2, char c3, char c4) { return (c1 & 255) + ((c2 & 255) << 8) + ((c3 &255) << 16) + ((c4 & 255) << 24); } #define CV_FOURCC_PROMPT -1 /* Open Codec Selection Dialog (Windows only) */ #define CV_FOURCC_DEFAULT CV_FOURCC('I' , 'Y', 'U', 'V' ) /* Use default codec for specified filename (Linux only) */ /* initialize video file writer */ CVAPI(CvVideoWriter*) cvCreateVideoWriter( const char * filename, int fourcc, double fps, CvSize frame_size, int is_color CV_DEFAULT(1)); //CVAPI(CvVideoWriter*) cvCreateImageSequenceWriter( const char* filename, // int is_color CV_DEFAULT(1)); /* write frame to video file */ CVAPI(int) cvWriteFrame( CvVideoWriter* writer, const IplImage* image ); /* close video file writer */ CVAPI(void) cvReleaseVideoWriter( CvVideoWriter** writer ); /**************************************************************************************** * Obsolete functions/synonyms * ****************************************************************************************/ #define cvCaptureFromFile cvCreateFileCapture #define cvCaptureFromCAM cvCreateCameraCapture #define cvCaptureFromAVI cvCaptureFromFile #define cvCreateAVIWriter cvCreateVideoWriter #define cvWriteToAVI cvWriteFrame #define cvAddSearchPath(path) #define cvvInitSystem cvInitSystem #define cvvNamedWindow cvNamedWindow #define cvvShowImage cvShowImage #define cvvResizeWindow cvResizeWindow #define cvvDestroyWindow cvDestroyWindow #define cvvCreateTrackbar cvCreateTrackbar #define cvvLoadImage(name) cvLoadImage((name),1) #define cvvSaveImage cvSaveImage #define cvvAddSearchPath cvAddSearchPath #define cvvWaitKey(name) cvWaitKey(0) #define cvvWaitKeyEx(name,delay) cvWaitKey(delay) #define cvvConvertImage cvConvertImage #define HG_AUTOSIZE CV_WINDOW_AUTOSIZE #define set_preprocess_func cvSetPreprocessFuncWin32 #define set_postprocess_func cvSetPostprocessFuncWin32 #if defined WIN32 || defined _WIN32 CVAPI(void) cvSetPreprocessFuncWin32_( const void * callback); CVAPI(void) cvSetPostprocessFuncWin32_( const void * callback); #define cvSetPreprocessFuncWin32(callback) cvSetPreprocessFuncWin32_((const void*)(callback)) #define cvSetPostprocessFuncWin32(callback) cvSetPostprocessFuncWin32_((const void*)(callback)) #endif #ifdef __cplusplus } #endif #endif
版权声明:本文为博主原创文章,未经博主允许不得转载。