趣味は車輪の再発明♪

[opencv] cvGetCaptureProperty - キャプチャプロパティの取得 (highgui)


詳解 OpenCV ―コンピュータビジョンライブラリを使った画像処理・認識
Gary Bradski Adrian Kaehler
オライリージャパン
売り上げランキング: 25,746


■ たかみんつ / ソフト開発メモINDEX / OpenCVリファレンス(じぶん用) / 関数リファレンス /


キャプチャのプロパティを取得する。 (⇒ サンプルプログラム)

double cvGetCaptureProperty(
    CvCapture* capture, int property_id );
No 引数 説明
1 capture キャプチャオブジェクトへのポインタ。
2 property_id プロパティID。

戻り値

指定されたプロパティの値を返します。必要に応じてキャストします。

プロパティID

制御レジスタのモード

自動、手動、自動1プッシュが使用できる。最後に設定したものが有効。同時に有効になるのはどれか一つだけ。

名称 説明
CV_CAP_PROP_DC1394_OFF -4 オフ。手動でも自動でも制御されない。
CV_CAP_PROP_DC1394_MODE_MANUAL -3 ユーザーに値が設定されたときに自動的に設定される。
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 FOUR CC
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 露出はカメラで制御され決定済みだが、ユーザーはこのプロパティで参照レベルを調整できる。
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_ZOOM 27
CV_CAP_PROP_FOCUS 28
CV_CAP_PROP_GUID 29
CV_CAP_PROP_ISO_SPEED 30
CV_CAP_PROP_MAX_DC1394 31
CV_CAP_PROP_BACKLIGHT 32
CV_CAP_PROP_PAN 33
CV_CAP_PROP_TILT 34
CV_CAP_PROP_ROLL 35
CV_CAP_PROP_IRIS 36
CV_CAP_PROP_SETTINGS 37

特殊なプロパティ

名称 説明
CV_CAP_PROP_AUTOGRAB 1024 highgui の CvCapture_Androidクラスにだけ有効
CV_CAP_PROP_SUPPORTED_PREVIEW_SIZES_STRING 1025 読み込み専用で、扱いに注意を要するプロパティ。const char* を返します。
CV_CAP_PROP_PREVIEW_FORMAT 1026

OpenNIマップジェネレータ

    CV_CAP_OPENNI_DEPTH_GENERATOR = 1 << 31,
    CV_CAP_OPENNI_IMAGE_GENERATOR = 1 << 30,
    CV_CAP_OPENNI_GENERATORS_MASK = CV_CAP_OPENNI_DEPTH_GENERATOR + CV_CAP_OPENNI_IMAGE_GENERATOR,

OpenNIインタフェースが有効なカメラのプロパティ

    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    = 104, // flag
    CV_CAP_PROP_OPENNI_REGISTRATION_ON = CV_CAP_PROP_OPENNI_REGISTRATION, // 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_PROP_OPENNI_APPROX_FRAME_SYNC = 105,
    CV_CAP_PROP_OPENNI_MAX_BUFFER_SIZE   = 106,
    CV_CAP_PROP_OPENNI_CIRCLE_BUFFER     = 107,
    CV_CAP_PROP_OPENNI_MAX_TIME_DURATION = 108,

    CV_CAP_PROP_OPENNI_GENERATOR_PRESENT = 109,

    CV_CAP_OPENNI_IMAGE_GENERATOR_PRESENT         = CV_CAP_OPENNI_IMAGE_GENERATOR + CV_CAP_PROP_OPENNI_GENERATOR_PRESENT,
    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    = CV_CAP_OPENNI_DEPTH_GENERATOR + CV_CAP_PROP_OPENNI_REGISTRATION,
    CV_CAP_OPENNI_DEPTH_GENERATOR_REGISTRATION_ON = CV_CAP_OPENNI_DEPTH_GENERATOR_REGISTRATION,

GStreamerインターフェースが有効なカメラのプロパティ(ja-wikipedia:GStreamer)

    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

XIMEA SDKインターフェースが有効なカメラのプロパティ(XIMEA)

    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

アンドロイドのカメラ用プロパティ

    CV_CAP_PROP_ANDROID_FLASH_MODE = 8001,
    CV_CAP_PROP_ANDROID_FOCUS_MODE = 8002,
    CV_CAP_PROP_ANDROID_WHITE_BALANCE = 8003,
    CV_CAP_PROP_ANDROID_ANTIBANDING = 8004,
    CV_CAP_PROP_ANDROID_FOCAL_LENGTH = 8005,
    CV_CAP_PROP_ANDROID_FOCUS_DISTANCE_NEAR = 8006,
    CV_CAP_PROP_ANDROID_FOCUS_DISTANCE_OPTIMAL = 8007,
    CV_CAP_PROP_ANDROID_FOCUS_DISTANCE_FAR = 8008,

AVFOUNDATION インターフェースが有効なカメラのプロパティ(AVFOUNDATION - Appleのメディア再生作成フレームワーク)

    CV_CAP_PROP_IOS_DEVICE_FOCUS = 9001,
    CV_CAP_PROP_IOS_DEVICE_EXPOSURE = 9002,
    CV_CAP_PROP_IOS_DEVICE_FLASH = 9003,
    CV_CAP_PROP_IOS_DEVICE_WHITEBALANCE = 9004,
    CV_CAP_PROP_IOS_DEVICE_TORCH = 9005,

Smartek Giganetix Ethernet Visionインタフェースが有効なカメラのプロパティ

    /* --- Vladimir Litvinenko (litvinenko.vladimir@gmail.com) --- */
    CV_CAP_PROP_GIGA_FRAME_OFFSET_X = 10001,
    CV_CAP_PROP_GIGA_FRAME_OFFSET_Y = 10002,
    CV_CAP_PROP_GIGA_FRAME_WIDTH_MAX = 10003,
    CV_CAP_PROP_GIGA_FRAME_HEIGH_MAX = 10004,
    CV_CAP_PROP_GIGA_FRAME_SENS_WIDTH = 10005,
    CV_CAP_PROP_GIGA_FRAME_SENS_HEIGH = 10006,

Intel PerC用のプロパティ

    CV_CAP_PROP_INTELPERC_PROFILE_COUNT               = 11001,
    CV_CAP_PROP_INTELPERC_PROFILE_IDX                 = 11002,
    CV_CAP_PROP_INTELPERC_DEPTH_LOW_CONFIDENCE_VALUE  = 11003,
    CV_CAP_PROP_INTELPERC_DEPTH_SATURATION_VALUE      = 11004,
    CV_CAP_PROP_INTELPERC_DEPTH_CONFIDENCE_THRESHOLD  = 11005,
    CV_CAP_PROP_INTELPERC_DEPTH_FOCAL_LENGTH_HORZ     = 11006,
    CV_CAP_PROP_INTELPERC_DEPTH_FOCAL_LENGTH_VERT     = 11007,

    // Intel PerC streams
    CV_CAP_INTELPERC_DEPTH_GENERATOR = 1 << 29,
    CV_CAP_INTELPERC_IMAGE_GENERATOR = 1 << 28,
    CV_CAP_INTELPERC_GENERATORS_MASK = CV_CAP_INTELPERC_DEPTH_GENERATOR + CV_CAP_INTELPERC_IMAGE_GENERATOR

関連文書


Pythonプロフェッショナルプログラミング 第2版
秀和システム (2015-05-21)
売り上げランキング: 1,813


クラウドではじめる機械学習 Azure MLでらくらく体験
脇森浩志 杉山雅和 羽生貴史
リックテレコム
売り上げランキング: 2,081

実践Node.js プログラミング (Programmer's SELECTION)
Mike Cantelon Marc Harter T.J. Holowaychuk Nathan Rajlich
翔泳社
売り上げランキング: 40,213

■ たかみんつ / ソフト開発メモINDEX / OpenCVリファレンス(じぶん用) / 関数リファレンス /



RSS Feed Widget
[opencv] cvGetCaptureProperty - キャプチャプロパティの取得 (highgui)
(http://bicycle.life.coocan.jp/takamints/index.php/doc/opencv/function/cvGetCaptureProperty)
by Koji Takami ( email: vzg03566@gmail.com, GitHub: takamin )