opencv on mbed

Dependencies:   mbed

Embed: (wiki syntax)

« Back to documentation index

Show/hide line numbers videoio_c.h Source File

videoio_c.h

00001 /*M///////////////////////////////////////////////////////////////////////////////////////
00002 //
00003 //  IMPORTANT: READ BEFORE DOWNLOADING, COPYING, INSTALLING OR USING.
00004 //
00005 //  By downloading, copying, installing or using the software you agree to this license.
00006 //  If you do not agree to this license, do not download, install,
00007 //  copy or use the software.
00008 //
00009 //
00010 //                        Intel License Agreement
00011 //                For Open Source Computer Vision Library
00012 //
00013 // Copyright (C) 2000, Intel Corporation, all rights reserved.
00014 // Third party copyrights are property of their respective owners.
00015 //
00016 // Redistribution and use in source and binary forms, with or without modification,
00017 // are permitted provided that the following conditions are met:
00018 //
00019 //   * Redistribution's of source code must retain the above copyright notice,
00020 //     this list of conditions and the following disclaimer.
00021 //
00022 //   * Redistribution's in binary form must reproduce the above copyright notice,
00023 //     this list of conditions and the following disclaimer in the documentation
00024 //     and/or other materials provided with the distribution.
00025 //
00026 //   * The name of Intel Corporation may not be used to endorse or promote products
00027 //     derived from this software without specific prior written permission.
00028 //
00029 // This software is provided by the copyright holders and contributors "as is" and
00030 // any express or implied warranties, including, but not limited to, the implied
00031 // warranties of merchantability and fitness for a particular purpose are disclaimed.
00032 // In no event shall the Intel Corporation or contributors be liable for any direct,
00033 // indirect, incidental, special, exemplary, or consequential damages
00034 // (including, but not limited to, procurement of substitute goods or services;
00035 // loss of use, data, or profits; or business interruption) however caused
00036 // and on any theory of liability, whether in contract, strict liability,
00037 // or tort (including negligence or otherwise) arising in any way out of
00038 // the use of this software, even if advised of the possibility of such damage.
00039 //
00040 //M*/
00041 
00042 #ifndef __OPENCV_VIDEOIO_H__
00043 #define __OPENCV_VIDEOIO_H__
00044 
00045 #include "opencv2/core/core_c.h"
00046 
00047 #ifdef __cplusplus
00048 extern "C" {
00049 #endif /* __cplusplus */
00050 
00051 /**
00052   @addtogroup videoio_c
00053   @{
00054 */
00055 
00056 /****************************************************************************************\
00057 *                         Working with Video Files and Cameras                           *
00058 \****************************************************************************************/
00059 
00060 /* "black box" capture structure */
00061 typedef struct CvCapture CvCapture;
00062 
00063 /* start capturing frames from video file */
00064 CVAPI(CvCapture*) cvCreateFileCapture( const char* filename );
00065 
00066 /* start capturing frames from video file. allows specifying a preferred API to use */
00067 CVAPI(CvCapture*) cvCreateFileCaptureWithPreference( const char* filename , int apiPreference);
00068 
00069 enum
00070 {
00071     CV_CAP_ANY      =0,     // autodetect
00072 
00073     CV_CAP_MIL      =100,   // MIL proprietary drivers
00074 
00075     CV_CAP_VFW      =200,   // platform native
00076     CV_CAP_V4L      =200,
00077     CV_CAP_V4L2     =200,
00078 
00079     CV_CAP_FIREWARE =300,   // IEEE 1394 drivers
00080     CV_CAP_FIREWIRE =300,
00081     CV_CAP_IEEE1394 =300,
00082     CV_CAP_DC1394   =300,
00083     CV_CAP_CMU1394  =300,
00084 
00085     CV_CAP_STEREO   =400,   // TYZX proprietary drivers
00086     CV_CAP_TYZX     =400,
00087     CV_TYZX_LEFT    =400,
00088     CV_TYZX_RIGHT   =401,
00089     CV_TYZX_COLOR   =402,
00090     CV_TYZX_Z       =403,
00091 
00092     CV_CAP_QT       =500,   // QuickTime
00093 
00094     CV_CAP_UNICAP   =600,   // Unicap drivers
00095 
00096     CV_CAP_DSHOW    =700,   // DirectShow (via videoInput)
00097     CV_CAP_MSMF     =1400,  // Microsoft Media Foundation (via videoInput)
00098 
00099     CV_CAP_PVAPI    =800,   // PvAPI, Prosilica GigE SDK
00100 
00101     CV_CAP_OPENNI   =900,   // OpenNI (for Kinect)
00102     CV_CAP_OPENNI_ASUS =910,   // OpenNI (for Asus Xtion)
00103 
00104     CV_CAP_ANDROID  =1000,  // Android - not used
00105     CV_CAP_ANDROID_BACK =CV_CAP_ANDROID+99, // Android back camera - not used
00106     CV_CAP_ANDROID_FRONT =CV_CAP_ANDROID+98, // Android front camera - not used
00107 
00108     CV_CAP_XIAPI    =1100,   // XIMEA Camera API
00109 
00110     CV_CAP_AVFOUNDATION = 1200,  // AVFoundation framework for iOS (OS X Lion will have the same API)
00111 
00112     CV_CAP_GIGANETIX = 1300,  // Smartek Giganetix GigEVisionSDK
00113 
00114     CV_CAP_INTELPERC = 1500, // Intel Perceptual Computing
00115 
00116     CV_CAP_OPENNI2 = 1600,   // OpenNI2 (for Kinect)
00117     CV_CAP_GPHOTO2 = 1700,
00118     CV_CAP_GSTREAMER = 1800, // GStreamer
00119     CV_CAP_FFMPEG = 1900,    // FFMPEG
00120     CV_CAP_IMAGES = 2000     // OpenCV Image Sequence (e.g. img_%02d.jpg)
00121 };
00122 
00123 /* start capturing frames from camera: index = camera_index + domain_offset (CV_CAP_*) */
00124 CVAPI(CvCapture*) cvCreateCameraCapture( int index );
00125 
00126 /* grab a frame, return 1 on success, 0 on fail.
00127   this function is thought to be fast               */
00128 CVAPI(int) cvGrabFrame( CvCapture* capture );
00129 
00130 /* get the frame grabbed with cvGrabFrame(..)
00131   This function may apply some frame processing like
00132   frame decompression, flipping etc.
00133   !!!DO NOT RELEASE or MODIFY the retrieved frame!!! */
00134 CVAPI(IplImage*) cvRetrieveFrame( CvCapture* capture, int streamIdx CV_DEFAULT(0) );
00135 
00136 /* Just a combination of cvGrabFrame and cvRetrieveFrame
00137    !!!DO NOT RELEASE or MODIFY the retrieved frame!!!      */
00138 CVAPI(IplImage*) cvQueryFrame( CvCapture* capture );
00139 
00140 /* stop capturing/reading and free resources */
00141 CVAPI(void) cvReleaseCapture( CvCapture** capture );
00142 
00143 enum
00144 {
00145     // modes of the controlling registers (can be: auto, manual, auto single push, absolute Latter allowed with any other mode)
00146     // every feature can have only one mode turned on at a time
00147     CV_CAP_PROP_DC1394_OFF         = -4,  //turn the feature off (not controlled manually nor automatically)
00148     CV_CAP_PROP_DC1394_MODE_MANUAL = -3, //set automatically when a value of the feature is set by the user
00149     CV_CAP_PROP_DC1394_MODE_AUTO = -2,
00150     CV_CAP_PROP_DC1394_MODE_ONE_PUSH_AUTO = -1,
00151     CV_CAP_PROP_POS_MSEC       =0,
00152     CV_CAP_PROP_POS_FRAMES     =1,
00153     CV_CAP_PROP_POS_AVI_RATIO  =2,
00154     CV_CAP_PROP_FRAME_WIDTH    =3,
00155     CV_CAP_PROP_FRAME_HEIGHT   =4,
00156     CV_CAP_PROP_FPS            =5,
00157     CV_CAP_PROP_FOURCC         =6,
00158     CV_CAP_PROP_FRAME_COUNT    =7,
00159     CV_CAP_PROP_FORMAT         =8,
00160     CV_CAP_PROP_MODE           =9,
00161     CV_CAP_PROP_BRIGHTNESS    =10,
00162     CV_CAP_PROP_CONTRAST      =11,
00163     CV_CAP_PROP_SATURATION    =12,
00164     CV_CAP_PROP_HUE           =13,
00165     CV_CAP_PROP_GAIN          =14,
00166     CV_CAP_PROP_EXPOSURE      =15,
00167     CV_CAP_PROP_CONVERT_RGB   =16,
00168     CV_CAP_PROP_WHITE_BALANCE_BLUE_U =17,
00169     CV_CAP_PROP_RECTIFICATION =18,
00170     CV_CAP_PROP_MONOCHROME    =19,
00171     CV_CAP_PROP_SHARPNESS     =20,
00172     CV_CAP_PROP_AUTO_EXPOSURE =21, // exposure control done by camera,
00173                                    // user can adjust refernce level
00174                                    // using this feature
00175     CV_CAP_PROP_GAMMA         =22,
00176     CV_CAP_PROP_TEMPERATURE   =23,
00177     CV_CAP_PROP_TRIGGER       =24,
00178     CV_CAP_PROP_TRIGGER_DELAY =25,
00179     CV_CAP_PROP_WHITE_BALANCE_RED_V =26,
00180     CV_CAP_PROP_ZOOM          =27,
00181     CV_CAP_PROP_FOCUS         =28,
00182     CV_CAP_PROP_GUID          =29,
00183     CV_CAP_PROP_ISO_SPEED     =30,
00184     CV_CAP_PROP_MAX_DC1394    =31,
00185     CV_CAP_PROP_BACKLIGHT     =32,
00186     CV_CAP_PROP_PAN           =33,
00187     CV_CAP_PROP_TILT          =34,
00188     CV_CAP_PROP_ROLL          =35,
00189     CV_CAP_PROP_IRIS          =36,
00190     CV_CAP_PROP_SETTINGS      =37,
00191     CV_CAP_PROP_BUFFERSIZE    =38,
00192     CV_CAP_PROP_AUTOFOCUS     =39,
00193     CV_CAP_PROP_SAR_NUM       =40,
00194     CV_CAP_PROP_SAR_DEN       =41,
00195 
00196     CV_CAP_PROP_AUTOGRAB      =1024, // property for videoio class CvCapture_Android only
00197     CV_CAP_PROP_SUPPORTED_PREVIEW_SIZES_STRING=1025, // readonly, tricky property, returns cpnst char* indeed
00198     CV_CAP_PROP_PREVIEW_FORMAT=1026, // readonly, tricky property, returns cpnst char* indeed
00199 
00200     // OpenNI map generators
00201     CV_CAP_OPENNI_DEPTH_GENERATOR = 1 << 31,
00202     CV_CAP_OPENNI_IMAGE_GENERATOR = 1 << 30,
00203     CV_CAP_OPENNI_GENERATORS_MASK = CV_CAP_OPENNI_DEPTH_GENERATOR + CV_CAP_OPENNI_IMAGE_GENERATOR,
00204 
00205     // Properties of cameras available through OpenNI interfaces
00206     CV_CAP_PROP_OPENNI_OUTPUT_MODE     = 100,
00207     CV_CAP_PROP_OPENNI_FRAME_MAX_DEPTH = 101, // in mm
00208     CV_CAP_PROP_OPENNI_BASELINE        = 102, // in mm
00209     CV_CAP_PROP_OPENNI_FOCAL_LENGTH    = 103, // in pixels
00210     CV_CAP_PROP_OPENNI_REGISTRATION    = 104, // flag
00211     CV_CAP_PROP_OPENNI_REGISTRATION_ON = CV_CAP_PROP_OPENNI_REGISTRATION, // flag that synchronizes the remapping depth map to image map
00212                                                                           // by changing depth generator's view point (if the flag is "on") or
00213                                                                           // sets this view point to its normal one (if the flag is "off").
00214     CV_CAP_PROP_OPENNI_APPROX_FRAME_SYNC = 105,
00215     CV_CAP_PROP_OPENNI_MAX_BUFFER_SIZE   = 106,
00216     CV_CAP_PROP_OPENNI_CIRCLE_BUFFER     = 107,
00217     CV_CAP_PROP_OPENNI_MAX_TIME_DURATION = 108,
00218 
00219     CV_CAP_PROP_OPENNI_GENERATOR_PRESENT = 109,
00220     CV_CAP_PROP_OPENNI2_SYNC = 110,
00221     CV_CAP_PROP_OPENNI2_MIRROR = 111,
00222 
00223     CV_CAP_OPENNI_IMAGE_GENERATOR_PRESENT         = CV_CAP_OPENNI_IMAGE_GENERATOR + CV_CAP_PROP_OPENNI_GENERATOR_PRESENT,
00224     CV_CAP_OPENNI_IMAGE_GENERATOR_OUTPUT_MODE     = CV_CAP_OPENNI_IMAGE_GENERATOR + CV_CAP_PROP_OPENNI_OUTPUT_MODE,
00225     CV_CAP_OPENNI_DEPTH_GENERATOR_BASELINE        = CV_CAP_OPENNI_DEPTH_GENERATOR + CV_CAP_PROP_OPENNI_BASELINE,
00226     CV_CAP_OPENNI_DEPTH_GENERATOR_FOCAL_LENGTH    = CV_CAP_OPENNI_DEPTH_GENERATOR + CV_CAP_PROP_OPENNI_FOCAL_LENGTH,
00227     CV_CAP_OPENNI_DEPTH_GENERATOR_REGISTRATION    = CV_CAP_OPENNI_DEPTH_GENERATOR + CV_CAP_PROP_OPENNI_REGISTRATION,
00228     CV_CAP_OPENNI_DEPTH_GENERATOR_REGISTRATION_ON = CV_CAP_OPENNI_DEPTH_GENERATOR_REGISTRATION,
00229 
00230     // Properties of cameras available through GStreamer interface
00231     CV_CAP_GSTREAMER_QUEUE_LENGTH           = 200, // default is 1
00232 
00233     // PVAPI
00234     CV_CAP_PROP_PVAPI_MULTICASTIP           = 300, // ip for anable multicast master mode. 0 for disable multicast
00235     CV_CAP_PROP_PVAPI_FRAMESTARTTRIGGERMODE = 301, // FrameStartTriggerMode: Determines how a frame is initiated
00236     CV_CAP_PROP_PVAPI_DECIMATIONHORIZONTAL  = 302, // Horizontal sub-sampling of the image
00237     CV_CAP_PROP_PVAPI_DECIMATIONVERTICAL    = 303, // Vertical sub-sampling of the image
00238     CV_CAP_PROP_PVAPI_BINNINGX              = 304, // Horizontal binning factor
00239     CV_CAP_PROP_PVAPI_BINNINGY              = 305, // Vertical binning factor
00240     CV_CAP_PROP_PVAPI_PIXELFORMAT           = 306, // Pixel format
00241 
00242     // Properties of cameras available through XIMEA SDK interface
00243     CV_CAP_PROP_XI_DOWNSAMPLING                                 = 400, // Change image resolution by binning or skipping.
00244     CV_CAP_PROP_XI_DATA_FORMAT                                  = 401, // Output data format.
00245     CV_CAP_PROP_XI_OFFSET_X                                     = 402, // Horizontal offset from the origin to the area of interest (in pixels).
00246     CV_CAP_PROP_XI_OFFSET_Y                                     = 403, // Vertical offset from the origin to the area of interest (in pixels).
00247     CV_CAP_PROP_XI_TRG_SOURCE                                   = 404, // Defines source of trigger.
00248     CV_CAP_PROP_XI_TRG_SOFTWARE                                 = 405, // Generates an internal trigger. PRM_TRG_SOURCE must be set to TRG_SOFTWARE.
00249     CV_CAP_PROP_XI_GPI_SELECTOR                                 = 406, // Selects general purpose input
00250     CV_CAP_PROP_XI_GPI_MODE                                     = 407, // Set general purpose input mode
00251     CV_CAP_PROP_XI_GPI_LEVEL                                    = 408, // Get general purpose level
00252     CV_CAP_PROP_XI_GPO_SELECTOR                                 = 409, // Selects general purpose output
00253     CV_CAP_PROP_XI_GPO_MODE                                     = 410, // Set general purpose output mode
00254     CV_CAP_PROP_XI_LED_SELECTOR                                 = 411, // Selects camera signalling LED
00255     CV_CAP_PROP_XI_LED_MODE                                     = 412, // Define camera signalling LED functionality
00256     CV_CAP_PROP_XI_MANUAL_WB                                    = 413, // Calculates White Balance(must be called during acquisition)
00257     CV_CAP_PROP_XI_AUTO_WB                                      = 414, // Automatic white balance
00258     CV_CAP_PROP_XI_AEAG                                         = 415, // Automatic exposure/gain
00259     CV_CAP_PROP_XI_EXP_PRIORITY                                 = 416, // Exposure priority (0.5 - exposure 50%, gain 50%).
00260     CV_CAP_PROP_XI_AE_MAX_LIMIT                                 = 417, // Maximum limit of exposure in AEAG procedure
00261     CV_CAP_PROP_XI_AG_MAX_LIMIT                                 = 418,  // Maximum limit of gain in AEAG procedure
00262     CV_CAP_PROP_XI_AEAG_LEVEL                                   = 419, // Average intensity of output signal AEAG should achieve(in %)
00263     CV_CAP_PROP_XI_TIMEOUT                                      = 420, // Image capture timeout in milliseconds
00264     CV_CAP_PROP_XI_EXPOSURE                                     = 421, // Exposure time in microseconds
00265     CV_CAP_PROP_XI_EXPOSURE_BURST_COUNT                         = 422, // Sets the number of times of exposure in one frame.
00266     CV_CAP_PROP_XI_GAIN_SELECTOR                                = 423, // Gain selector for parameter Gain allows to select different type of gains.
00267     CV_CAP_PROP_XI_GAIN                                         = 424, // Gain in dB
00268     CV_CAP_PROP_XI_DOWNSAMPLING_TYPE                            = 426, // Change image downsampling type.
00269     CV_CAP_PROP_XI_BINNING_SELECTOR                             = 427, // Binning engine selector.
00270     CV_CAP_PROP_XI_BINNING_VERTICAL                             = 428, // Vertical Binning - number of vertical photo-sensitive cells to combine together.
00271     CV_CAP_PROP_XI_BINNING_HORIZONTAL                           = 429, // Horizontal Binning - number of horizontal photo-sensitive cells to combine together.
00272     CV_CAP_PROP_XI_BINNING_PATTERN                              = 430, // Binning pattern type.
00273     CV_CAP_PROP_XI_DECIMATION_SELECTOR                          = 431, // Decimation engine selector.
00274     CV_CAP_PROP_XI_DECIMATION_VERTICAL                          = 432, // Vertical Decimation - vertical sub-sampling of the image - reduces the vertical resolution of the image by the specified vertical decimation factor.
00275     CV_CAP_PROP_XI_DECIMATION_HORIZONTAL                        = 433, // Horizontal Decimation - horizontal sub-sampling of the image - reduces the horizontal resolution of the image by the specified vertical decimation factor.
00276     CV_CAP_PROP_XI_DECIMATION_PATTERN                           = 434, // Decimation pattern type.
00277     CV_CAP_PROP_XI_IMAGE_DATA_FORMAT                            = 435, // Output data format.
00278     CV_CAP_PROP_XI_SHUTTER_TYPE                                 = 436, // Change sensor shutter type(CMOS sensor).
00279     CV_CAP_PROP_XI_SENSOR_TAPS                                  = 437, // Number of taps
00280     CV_CAP_PROP_XI_AEAG_ROI_OFFSET_X                            = 439, // Automatic exposure/gain ROI offset X
00281     CV_CAP_PROP_XI_AEAG_ROI_OFFSET_Y                            = 440, // Automatic exposure/gain ROI offset Y
00282     CV_CAP_PROP_XI_AEAG_ROI_WIDTH                               = 441, // Automatic exposure/gain ROI Width
00283     CV_CAP_PROP_XI_AEAG_ROI_HEIGHT                              = 442, // Automatic exposure/gain ROI Height
00284     CV_CAP_PROP_XI_BPC                                          = 445, // Correction of bad pixels
00285     CV_CAP_PROP_XI_WB_KR                                        = 448, // White balance red coefficient
00286     CV_CAP_PROP_XI_WB_KG                                        = 449, // White balance green coefficient
00287     CV_CAP_PROP_XI_WB_KB                                        = 450, // White balance blue coefficient
00288     CV_CAP_PROP_XI_WIDTH                                        = 451, // Width of the Image provided by the device (in pixels).
00289     CV_CAP_PROP_XI_HEIGHT                                       = 452, // Height of the Image provided by the device (in pixels).
00290     CV_CAP_PROP_XI_LIMIT_BANDWIDTH                              = 459, // Set/get bandwidth(datarate)(in Megabits)
00291     CV_CAP_PROP_XI_SENSOR_DATA_BIT_DEPTH                        = 460, // Sensor output data bit depth.
00292     CV_CAP_PROP_XI_OUTPUT_DATA_BIT_DEPTH                        = 461, // Device output data bit depth.
00293     CV_CAP_PROP_XI_IMAGE_DATA_BIT_DEPTH                         = 462, // bitdepth of data returned by function xiGetImage
00294     CV_CAP_PROP_XI_OUTPUT_DATA_PACKING                          = 463, // Device output data packing (or grouping) enabled. Packing could be enabled if output_data_bit_depth > 8 and packing capability is available.
00295     CV_CAP_PROP_XI_OUTPUT_DATA_PACKING_TYPE                     = 464, // Data packing type. Some cameras supports only specific packing type.
00296     CV_CAP_PROP_XI_IS_COOLED                                    = 465, // Returns 1 for cameras that support cooling.
00297     CV_CAP_PROP_XI_COOLING                                      = 466, // Start camera cooling.
00298     CV_CAP_PROP_XI_TARGET_TEMP                                  = 467, // Set sensor target temperature for cooling.
00299     CV_CAP_PROP_XI_CHIP_TEMP                                    = 468, // Camera sensor temperature
00300     CV_CAP_PROP_XI_HOUS_TEMP                                    = 469, // Camera housing tepmerature
00301     CV_CAP_PROP_XI_CMS                                          = 470, // Mode of color management system.
00302     CV_CAP_PROP_XI_APPLY_CMS                                    = 471, // Enable applying of CMS profiles to xiGetImage (see XI_PRM_INPUT_CMS_PROFILE, XI_PRM_OUTPUT_CMS_PROFILE).
00303     CV_CAP_PROP_XI_IMAGE_IS_COLOR                               = 474, // Returns 1 for color cameras.
00304     CV_CAP_PROP_XI_COLOR_FILTER_ARRAY                           = 475, // Returns color filter array type of RAW data.
00305     CV_CAP_PROP_XI_GAMMAY                                       = 476, // Luminosity gamma
00306     CV_CAP_PROP_XI_GAMMAC                                       = 477, // Chromaticity gamma
00307     CV_CAP_PROP_XI_SHARPNESS                                    = 478, // Sharpness Strenght
00308     CV_CAP_PROP_XI_CC_MATRIX_00                                 = 479, // Color Correction Matrix element [0][0]
00309     CV_CAP_PROP_XI_CC_MATRIX_01                                 = 480, // Color Correction Matrix element [0][1]
00310     CV_CAP_PROP_XI_CC_MATRIX_02                                 = 481, // Color Correction Matrix element [0][2]
00311     CV_CAP_PROP_XI_CC_MATRIX_03                                 = 482, // Color Correction Matrix element [0][3]
00312     CV_CAP_PROP_XI_CC_MATRIX_10                                 = 483, // Color Correction Matrix element [1][0]
00313     CV_CAP_PROP_XI_CC_MATRIX_11                                 = 484, // Color Correction Matrix element [1][1]
00314     CV_CAP_PROP_XI_CC_MATRIX_12                                 = 485, // Color Correction Matrix element [1][2]
00315     CV_CAP_PROP_XI_CC_MATRIX_13                                 = 486, // Color Correction Matrix element [1][3]
00316     CV_CAP_PROP_XI_CC_MATRIX_20                                 = 487, // Color Correction Matrix element [2][0]
00317     CV_CAP_PROP_XI_CC_MATRIX_21                                 = 488, // Color Correction Matrix element [2][1]
00318     CV_CAP_PROP_XI_CC_MATRIX_22                                 = 489, // Color Correction Matrix element [2][2]
00319     CV_CAP_PROP_XI_CC_MATRIX_23                                 = 490, // Color Correction Matrix element [2][3]
00320     CV_CAP_PROP_XI_CC_MATRIX_30                                 = 491, // Color Correction Matrix element [3][0]
00321     CV_CAP_PROP_XI_CC_MATRIX_31                                 = 492, // Color Correction Matrix element [3][1]
00322     CV_CAP_PROP_XI_CC_MATRIX_32                                 = 493, // Color Correction Matrix element [3][2]
00323     CV_CAP_PROP_XI_CC_MATRIX_33                                 = 494, // Color Correction Matrix element [3][3]
00324     CV_CAP_PROP_XI_DEFAULT_CC_MATRIX                            = 495, // Set default Color Correction Matrix
00325     CV_CAP_PROP_XI_TRG_SELECTOR                                 = 498, // Selects the type of trigger.
00326     CV_CAP_PROP_XI_ACQ_FRAME_BURST_COUNT                        = 499, // Sets number of frames acquired by burst. This burst is used only if trigger is set to FrameBurstStart
00327     CV_CAP_PROP_XI_DEBOUNCE_EN                                  = 507, // Enable/Disable debounce to selected GPI
00328     CV_CAP_PROP_XI_DEBOUNCE_T0                                  = 508, // Debounce time (x * 10us)
00329     CV_CAP_PROP_XI_DEBOUNCE_T1                                  = 509, // Debounce time (x * 10us)
00330     CV_CAP_PROP_XI_DEBOUNCE_POL                                 = 510, // Debounce polarity (pol = 1 t0 - falling edge, t1 - rising edge)
00331     CV_CAP_PROP_XI_LENS_MODE                                    = 511, // Status of lens control interface. This shall be set to XI_ON before any Lens operations.
00332     CV_CAP_PROP_XI_LENS_APERTURE_VALUE                          = 512, // Current lens aperture value in stops. Examples: 2.8, 4, 5.6, 8, 11
00333     CV_CAP_PROP_XI_LENS_FOCUS_MOVEMENT_VALUE                    = 513, // Lens current focus movement value to be used by XI_PRM_LENS_FOCUS_MOVE in motor steps.
00334     CV_CAP_PROP_XI_LENS_FOCUS_MOVE                              = 514, // Moves lens focus motor by steps set in XI_PRM_LENS_FOCUS_MOVEMENT_VALUE.
00335     CV_CAP_PROP_XI_LENS_FOCUS_DISTANCE                          = 515, // Lens focus distance in cm.
00336     CV_CAP_PROP_XI_LENS_FOCAL_LENGTH                            = 516, // Lens focal distance in mm.
00337     CV_CAP_PROP_XI_LENS_FEATURE_SELECTOR                        = 517, // Selects the current feature which is accessible by XI_PRM_LENS_FEATURE.
00338     CV_CAP_PROP_XI_LENS_FEATURE                                 = 518, // Allows access to lens feature value currently selected by XI_PRM_LENS_FEATURE_SELECTOR.
00339     CV_CAP_PROP_XI_DEVICE_MODEL_ID                              = 521, // Return device model id
00340     CV_CAP_PROP_XI_DEVICE_SN                                    = 522, // Return device serial number
00341     CV_CAP_PROP_XI_IMAGE_DATA_FORMAT_RGB32_ALPHA                = 529, // The alpha channel of RGB32 output image format.
00342     CV_CAP_PROP_XI_IMAGE_PAYLOAD_SIZE                           = 530, // Buffer size in bytes sufficient for output image returned by xiGetImage
00343     CV_CAP_PROP_XI_TRANSPORT_PIXEL_FORMAT                       = 531, // Current format of pixels on transport layer.
00344     CV_CAP_PROP_XI_SENSOR_CLOCK_FREQ_HZ                         = 532, // Sensor clock frequency in Hz.
00345     CV_CAP_PROP_XI_SENSOR_CLOCK_FREQ_INDEX                      = 533, // Sensor clock frequency index. Sensor with selected frequencies have possibility to set the frequency only by this index.
00346     CV_CAP_PROP_XI_SENSOR_OUTPUT_CHANNEL_COUNT                  = 534, // Number of output channels from sensor used for data transfer.
00347     CV_CAP_PROP_XI_FRAMERATE                                    = 535, // Define framerate in Hz
00348     CV_CAP_PROP_XI_COUNTER_SELECTOR                             = 536, // Select counter
00349     CV_CAP_PROP_XI_COUNTER_VALUE                                = 537, // Counter status
00350     CV_CAP_PROP_XI_ACQ_TIMING_MODE                              = 538, // Type of sensor frames timing.
00351     CV_CAP_PROP_XI_AVAILABLE_BANDWIDTH                          = 539, // Calculate and return available interface bandwidth(int Megabits)
00352     CV_CAP_PROP_XI_BUFFER_POLICY                                = 540, // Data move policy
00353     CV_CAP_PROP_XI_LUT_EN                                       = 541, // Activates LUT.
00354     CV_CAP_PROP_XI_LUT_INDEX                                    = 542, // Control the index (offset) of the coefficient to access in the LUT.
00355     CV_CAP_PROP_XI_LUT_VALUE                                    = 543, // Value at entry LUTIndex of the LUT
00356     CV_CAP_PROP_XI_TRG_DELAY                                    = 544, // Specifies the delay in microseconds (us) to apply after the trigger reception before activating it.
00357     CV_CAP_PROP_XI_TS_RST_MODE                                  = 545, // Defines how time stamp reset engine will be armed
00358     CV_CAP_PROP_XI_TS_RST_SOURCE                                = 546, // Defines which source will be used for timestamp reset. Writing this parameter will trigger settings of engine (arming)
00359     CV_CAP_PROP_XI_IS_DEVICE_EXIST                              = 547, // Returns 1 if camera connected and works properly.
00360     CV_CAP_PROP_XI_ACQ_BUFFER_SIZE                              = 548, // Acquisition buffer size in buffer_size_unit. Default bytes.
00361     CV_CAP_PROP_XI_ACQ_BUFFER_SIZE_UNIT                         = 549, // Acquisition buffer size unit in bytes. Default 1. E.g. Value 1024 means that buffer_size is in KiBytes
00362     CV_CAP_PROP_XI_ACQ_TRANSPORT_BUFFER_SIZE                    = 550, // Acquisition transport buffer size in bytes
00363     CV_CAP_PROP_XI_BUFFERS_QUEUE_SIZE                           = 551, // Queue of field/frame buffers
00364     CV_CAP_PROP_XI_ACQ_TRANSPORT_BUFFER_COMMIT                  = 552, // Number of buffers to commit to low level
00365     CV_CAP_PROP_XI_RECENT_FRAME                                 = 553, // GetImage returns most recent frame
00366     CV_CAP_PROP_XI_DEVICE_RESET                                 = 554, // Resets the camera to default state.
00367     CV_CAP_PROP_XI_COLUMN_FPN_CORRECTION                        = 555, // Correction of column FPN
00368     CV_CAP_PROP_XI_SENSOR_MODE                                  = 558, // Current sensor mode. Allows to select sensor mode by one integer. Setting of this parameter affects: image dimensions and downsampling.
00369     CV_CAP_PROP_XI_HDR                                          = 559, // Enable High Dynamic Range feature.
00370     CV_CAP_PROP_XI_HDR_KNEEPOINT_COUNT                          = 560, // The number of kneepoints in the PWLR.
00371     CV_CAP_PROP_XI_HDR_T1                                       = 561, // position of first kneepoint(in % of XI_PRM_EXPOSURE)
00372     CV_CAP_PROP_XI_HDR_T2                                       = 562, // position of second kneepoint (in % of XI_PRM_EXPOSURE)
00373     CV_CAP_PROP_XI_KNEEPOINT1                                   = 563, // value of first kneepoint (% of sensor saturation)
00374     CV_CAP_PROP_XI_KNEEPOINT2                                   = 564, // value of second kneepoint (% of sensor saturation)
00375     CV_CAP_PROP_XI_IMAGE_BLACK_LEVEL                            = 565, // Last image black level counts. Can be used for Offline processing to recall it.
00376     CV_CAP_PROP_XI_HW_REVISION                                  = 571, // Returns hardware revision number.
00377     CV_CAP_PROP_XI_DEBUG_LEVEL                                  = 572, // Set debug level
00378     CV_CAP_PROP_XI_AUTO_BANDWIDTH_CALCULATION                   = 573, // Automatic bandwidth calculation,
00379     CV_CAP_PROP_XI_FREE_FFS_SIZE                                = 581, // Size of free camera FFS.
00380     CV_CAP_PROP_XI_USED_FFS_SIZE                                = 582, // Size of used camera FFS.
00381     CV_CAP_PROP_XI_FFS_ACCESS_KEY                               = 583, // Setting of key enables file operations on some cameras.
00382     CV_CAP_PROP_XI_SENSOR_FEATURE_SELECTOR                      = 585, // Selects the current feature which is accessible by XI_PRM_SENSOR_FEATURE_VALUE.
00383     CV_CAP_PROP_XI_SENSOR_FEATURE_VALUE                         = 586, // Allows access to sensor feature value currently selected by XI_PRM_SENSOR_FEATURE_SELECTOR.
00384 
00385     // Properties for Android cameras
00386     CV_CAP_PROP_ANDROID_FLASH_MODE = 8001,
00387     CV_CAP_PROP_ANDROID_FOCUS_MODE = 8002,
00388     CV_CAP_PROP_ANDROID_WHITE_BALANCE = 8003,
00389     CV_CAP_PROP_ANDROID_ANTIBANDING = 8004,
00390     CV_CAP_PROP_ANDROID_FOCAL_LENGTH = 8005,
00391     CV_CAP_PROP_ANDROID_FOCUS_DISTANCE_NEAR = 8006,
00392     CV_CAP_PROP_ANDROID_FOCUS_DISTANCE_OPTIMAL = 8007,
00393     CV_CAP_PROP_ANDROID_FOCUS_DISTANCE_FAR = 8008,
00394     CV_CAP_PROP_ANDROID_EXPOSE_LOCK = 8009,
00395     CV_CAP_PROP_ANDROID_WHITEBALANCE_LOCK = 8010,
00396 
00397     // Properties of cameras available through AVFOUNDATION interface
00398     CV_CAP_PROP_IOS_DEVICE_FOCUS = 9001,
00399     CV_CAP_PROP_IOS_DEVICE_EXPOSURE = 9002,
00400     CV_CAP_PROP_IOS_DEVICE_FLASH = 9003,
00401     CV_CAP_PROP_IOS_DEVICE_WHITEBALANCE = 9004,
00402     CV_CAP_PROP_IOS_DEVICE_TORCH = 9005,
00403 
00404     // Properties of cameras available through Smartek Giganetix Ethernet Vision interface
00405     /* --- Vladimir Litvinenko (litvinenko.vladimir@gmail.com) --- */
00406     CV_CAP_PROP_GIGA_FRAME_OFFSET_X = 10001,
00407     CV_CAP_PROP_GIGA_FRAME_OFFSET_Y = 10002,
00408     CV_CAP_PROP_GIGA_FRAME_WIDTH_MAX = 10003,
00409     CV_CAP_PROP_GIGA_FRAME_HEIGH_MAX = 10004,
00410     CV_CAP_PROP_GIGA_FRAME_SENS_WIDTH = 10005,
00411     CV_CAP_PROP_GIGA_FRAME_SENS_HEIGH = 10006,
00412 
00413     CV_CAP_PROP_INTELPERC_PROFILE_COUNT               = 11001,
00414     CV_CAP_PROP_INTELPERC_PROFILE_IDX                 = 11002,
00415     CV_CAP_PROP_INTELPERC_DEPTH_LOW_CONFIDENCE_VALUE  = 11003,
00416     CV_CAP_PROP_INTELPERC_DEPTH_SATURATION_VALUE      = 11004,
00417     CV_CAP_PROP_INTELPERC_DEPTH_CONFIDENCE_THRESHOLD  = 11005,
00418     CV_CAP_PROP_INTELPERC_DEPTH_FOCAL_LENGTH_HORZ     = 11006,
00419     CV_CAP_PROP_INTELPERC_DEPTH_FOCAL_LENGTH_VERT     = 11007,
00420 
00421     // Intel PerC streams
00422     CV_CAP_INTELPERC_DEPTH_GENERATOR = 1 << 29,
00423     CV_CAP_INTELPERC_IMAGE_GENERATOR = 1 << 28,
00424     CV_CAP_INTELPERC_GENERATORS_MASK = CV_CAP_INTELPERC_DEPTH_GENERATOR + CV_CAP_INTELPERC_IMAGE_GENERATOR
00425 };
00426 
00427 // Generic camera output modes.
00428 // Currently, these are supported through the libv4l interface only.
00429 enum
00430 {
00431     CV_CAP_MODE_BGR  = 0, // BGR24 (default)
00432     CV_CAP_MODE_RGB  = 1, // RGB24
00433     CV_CAP_MODE_GRAY = 2, // Y8
00434     CV_CAP_MODE_YUYV = 3  // YUYV
00435 };
00436 
00437 enum
00438 {
00439     // Data given from depth generator.
00440     CV_CAP_OPENNI_DEPTH_MAP                 = 0, // Depth values in mm (CV_16UC1)
00441     CV_CAP_OPENNI_POINT_CLOUD_MAP           = 1, // XYZ in meters (CV_32FC3)
00442     CV_CAP_OPENNI_DISPARITY_MAP             = 2, // Disparity in pixels (CV_8UC1)
00443     CV_CAP_OPENNI_DISPARITY_MAP_32F         = 3, // Disparity in pixels (CV_32FC1)
00444     CV_CAP_OPENNI_VALID_DEPTH_MASK          = 4, // CV_8UC1
00445 
00446     // Data given from RGB image generator.
00447     CV_CAP_OPENNI_BGR_IMAGE                 = 5,
00448     CV_CAP_OPENNI_GRAY_IMAGE                = 6
00449 };
00450 
00451 // Supported output modes of OpenNI image generator
00452 enum
00453 {
00454     CV_CAP_OPENNI_VGA_30HZ     = 0,
00455     CV_CAP_OPENNI_SXGA_15HZ    = 1,
00456     CV_CAP_OPENNI_SXGA_30HZ    = 2,
00457     CV_CAP_OPENNI_QVGA_30HZ    = 3,
00458     CV_CAP_OPENNI_QVGA_60HZ    = 4
00459 };
00460 
00461 enum
00462 {
00463     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.
00464     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.
00465     CV_CAP_INTELPERC_IR_MAP                 = 2, // Each pixel is a 16-bit integer. The value indicates the intensity of the reflected laser beam.
00466     CV_CAP_INTELPERC_IMAGE                  = 3
00467 };
00468 
00469 // gPhoto2 properties, if propertyId is less than 0 then work on widget with that __additive inversed__ camera setting ID
00470 // Get IDs by using CAP_PROP_GPHOTO2_WIDGET_ENUMERATE.
00471 // @see CvCaptureCAM_GPHOTO2 for more info
00472 enum
00473 {
00474     CV_CAP_PROP_GPHOTO2_PREVIEW           = 17001, // Capture only preview from liveview mode.
00475     CV_CAP_PROP_GPHOTO2_WIDGET_ENUMERATE  = 17002, // Readonly, returns (const char *).
00476     CV_CAP_PROP_GPHOTO2_RELOAD_CONFIG     = 17003, // Trigger, only by set. Reload camera settings.
00477     CV_CAP_PROP_GPHOTO2_RELOAD_ON_CHANGE  = 17004, // Reload all settings on set.
00478     CV_CAP_PROP_GPHOTO2_COLLECT_MSGS      = 17005, // Collect messages with details.
00479     CV_CAP_PROP_GPHOTO2_FLUSH_MSGS        = 17006, // Readonly, returns (const char *).
00480     CV_CAP_PROP_SPEED                     = 17007, // Exposure speed. Can be readonly, depends on camera program.
00481     CV_CAP_PROP_APERTURE                  = 17008, // Aperture. Can be readonly, depends on camera program.
00482     CV_CAP_PROP_EXPOSUREPROGRAM           = 17009, // Camera exposure program.
00483     CV_CAP_PROP_VIEWFINDER                = 17010  // Enter liveview mode.
00484 };
00485 
00486 /* retrieve or set capture properties */
00487 CVAPI(double) cvGetCaptureProperty( CvCapture* capture, int property_id );
00488 CVAPI(int)    cvSetCaptureProperty( CvCapture* capture, int property_id, double value );
00489 
00490 // Return the type of the capturer (eg, CV_CAP_V4W, CV_CAP_UNICAP), which is unknown if created with CV_CAP_ANY
00491 CVAPI(int)    cvGetCaptureDomain( CvCapture* capture);
00492 
00493 /* "black box" video file writer structure */
00494 typedef struct CvVideoWriter CvVideoWriter;
00495 
00496 #define CV_FOURCC_MACRO(c1, c2, c3, c4) (((c1) & 255) + (((c2) & 255) << 8) + (((c3) & 255) << 16) + (((c4) & 255) << 24))
00497 
00498 CV_INLINE int CV_FOURCC(char c1, char c2, char c3, char c4)
00499 {
00500     return CV_FOURCC_MACRO(c1, c2, c3, c4);
00501 }
00502 
00503 #define CV_FOURCC_PROMPT -1  /* Open Codec Selection Dialog (Windows only) */
00504 #define CV_FOURCC_DEFAULT CV_FOURCC('I', 'Y', 'U', 'V') /* Use default codec for specified filename (Linux only) */
00505 
00506 /* initialize video file writer */
00507 CVAPI(CvVideoWriter*) cvCreateVideoWriter( const char* filename, int fourcc,
00508                                            double fps, CvSize frame_size,
00509                                            int is_color CV_DEFAULT(1));
00510 
00511 /* write frame to video file */
00512 CVAPI(int) cvWriteFrame( CvVideoWriter* writer, const IplImage* image );
00513 
00514 /* close video file writer */
00515 CVAPI(void) cvReleaseVideoWriter( CvVideoWriter** writer );
00516 
00517 /****************************************************************************************\
00518 *                              Obsolete functions/synonyms                               *
00519 \****************************************************************************************/
00520 
00521 #define cvCaptureFromFile cvCreateFileCapture
00522 #define cvCaptureFromCAM cvCreateCameraCapture
00523 #define cvCaptureFromAVI cvCaptureFromFile
00524 #define cvCreateAVIWriter cvCreateVideoWriter
00525 #define cvWriteToAVI cvWriteFrame
00526 
00527 /** @} videoio_c */
00528 
00529 #ifdef __cplusplus
00530 }
00531 #endif
00532 
00533 #endif //__OPENCV_VIDEOIO_H__
00534