![]() |
OpenCV 4.13.0
Open Source Computer Vision
|
| enum cv::VideoCaptureAPIs |
#include <opencv2/videoio.hpp>
cv::VideoCapture APIバックエンド識別子。
キャプチャオブジェクトに優先するAPIを選択する。VideoCapture::VideoCapture() コンストラクタまたは VideoCapture::open() で使用する
#include <opencv2/videoio.hpp>
cv::VideoCapture の汎用プロパティ識別子。
プロパティの読み取り/書き込みは多くの層を経由する。この一連の処理の途中で予期しない結果が生じる場合がある。実際の挙動はデバイスのハードウェア、ドライバ、API バックエンドに依存する。
| 列挙値 | |
|---|---|
| CAP_PROP_POS_MSEC Python: cv.CAP_PROP_POS_MSEC | 動画ファイルの現在位置(ミリ秒単位)。 |
| CAP_PROP_POS_FRAMES Python: cv.CAP_PROP_POS_FRAMES | 次にデコード/キャプチャされるフレームの0始まりのインデックス。RAWモード(CAP_PROP_FORMAT == -1)でインデックスiが設定された場合、k <= iを満たすキーフレームkにシークする。 |
| CAP_PROP_POS_AVI_RATIO Python: cv.CAP_PROP_POS_AVI_RATIO | 動画ファイルの相対位置: 0=映像の先頭、1=映像の末尾。 |
| CAP_PROP_FRAME_WIDTH Python: cv.CAP_PROP_FRAME_WIDTH | 動画ストリーム内のフレームの幅。 |
| CAP_PROP_FRAME_HEIGHT Python: cv.CAP_PROP_FRAME_HEIGHT | 動画ストリーム内のフレームの高さ。 |
| CAP_PROP_FPS Python: cv.CAP_PROP_FPS | フレームレート。 |
| CAP_PROP_FOURCC Python: cv.CAP_PROP_FOURCC | コーデックの4文字コード。VideoWriter::fourccを参照。 |
| CAP_PROP_FRAME_COUNT Python: cv.CAP_PROP_FRAME_COUNT | 動画ファイル内のフレーム数。 |
| CAP_PROP_FORMAT Python: cv.CAP_PROP_FORMAT | VideoCapture::retrieve() が返す Mat オブジェクトの型(Mat::type() を参照)。値に -1 を設定すると、未デコードのRAW動画ストリームを取得する(Mat 8UC1として)。 |
| CAP_PROP_MODE Python: cv.CAP_PROP_MODE | 現在のキャプチャモードを示すバックエンド固有の値。 |
| CAP_PROP_BRIGHTNESS Python: cv.CAP_PROP_BRIGHTNESS | 画像の明るさ(対応しているカメラのみ)。 |
| CAP_PROP_CONTRAST Python: cv.CAP_PROP_CONTRAST | 画像のコントラスト(カメラのみ)。 |
| CAP_PROP_SATURATION Python: cv.CAP_PROP_SATURATION | 画像の彩度(カメラのみ)。 |
| CAP_PROP_HUE Python: cv.CAP_PROP_HUE | 画像の色相(カメラのみ)。 |
| CAP_PROP_GAIN Python: cv.CAP_PROP_GAIN | 画像のゲイン(対応しているカメラのみ)。 |
| CAP_PROP_EXPOSURE Python: cv.CAP_PROP_EXPOSURE | 露出(対応しているカメラのみ)。 |
| CAP_PROP_CONVERT_RGB Python: cv.CAP_PROP_CONVERT_RGB | 画像をBGRに変換するかどうかを示すブール値フラグ。 |
| CAP_PROP_WHITE_BALANCE_BLUE_U Python: cv.CAP_PROP_WHITE_BALANCE_BLUE_U | 現在は未対応。 |
| CAP_PROP_RECTIFICATION Python: cv.CAP_PROP_RECTIFICATION | ステレオカメラの平行化(rectification)フラグ(注意: 現在はDC1394 v 2.xバックエンドのみ対応)。 |
| CAP_PROP_MONOCHROME Python: cv.CAP_PROP_MONOCHROME | |
| CAP_PROP_SHARPNESS Python: cv.CAP_PROP_SHARPNESS | |
| CAP_PROP_AUTO_EXPOSURE Python: cv.CAP_PROP_AUTO_EXPOSURE | DC1394: 露出制御はカメラが行い、ユーザーはこの機能を使って基準レベルを調整できる。 |
| CAP_PROP_GAMMA Python: cv.CAP_PROP_GAMMA | |
| CAP_PROP_TEMPERATURE Python: cv.CAP_PROP_TEMPERATURE | |
| CAP_PROP_TRIGGER Python: cv.CAP_PROP_TRIGGER | |
| CAP_PROP_TRIGGER_DELAY Python: cv.CAP_PROP_TRIGGER_DELAY | |
| CAP_PROP_WHITE_BALANCE_RED_V Python: cv.CAP_PROP_WHITE_BALANCE_RED_V | |
| CAP_PROP_ZOOM Python: cv.CAP_PROP_ZOOM | Android: 物理カメラ/レンズが切り替わる場合がある。係数と範囲はハードウェアに依存する。 |
| CAP_PROP_FOCUS Python: cv.CAP_PROP_FOCUS | |
| CAP_PROP_GUID Python: cv.CAP_PROP_GUID | |
| CAP_PROP_ISO_SPEED Python: cv.CAP_PROP_ISO_SPEED | |
| CAP_PROP_BACKLIGHT Python: cv.CAP_PROP_BACKLIGHT | |
| CAP_PROP_PAN Python: cv.CAP_PROP_PAN | |
| CAP_PROP_TILT Python: cv.CAP_PROP_TILT | |
| CAP_PROP_ROLL Python: cv.CAP_PROP_ROLL | |
| CAP_PROP_IRIS Python: cv.CAP_PROP_IRIS | |
| CAP_PROP_SETTINGS Python: cv.CAP_PROP_SETTINGS | 動画/カメラのフィルタダイアログをポップアップ表示する(注意: 現在はDSHOWバックエンドのみ対応。プロパティ値は無視される) |
| CAP_PROP_BUFFERSIZE Python: cv.CAP_PROP_BUFFERSIZE | |
| CAP_PROP_AUTOFOCUS Python: cv.CAP_PROP_AUTOFOCUS | |
| CAP_PROP_SAR_NUM Python: cv.CAP_PROP_SAR_NUM | サンプルアスペクト比: num/den (num) |
| CAP_PROP_SAR_DEN Python: cv.CAP_PROP_SAR_DEN | サンプルアスペクト比: num/den (den) |
| CAP_PROP_BACKEND Python: cv.CAP_PROP_BACKEND | 現在のバックエンド(enum VideoCaptureAPIs)。読み取り専用プロパティ。 |
| CAP_PROP_CHANNEL Python: cv.CAP_PROP_CHANNEL | 動画入力またはチャンネル番号(対応しているカメラのみ) |
| CAP_PROP_AUTO_WB Python: cv.CAP_PROP_AUTO_WB | オートホワイトバランスの有効/無効 |
| CAP_PROP_WB_TEMPERATURE Python: cv.CAP_PROP_WB_TEMPERATURE | ホワイトバランスの色温度 |
| CAP_PROP_CODEC_PIXEL_FORMAT Python: cv.CAP_PROP_CODEC_PIXEL_FORMAT | (読み取り専用) コーデックのピクセルフォーマット。4文字のコード - VideoWriter::fourcc を参照。AV_PIX_FMT_* のサブセット、または不明な場合は -1 |
| CAP_PROP_BITRATE Python: cv.CAP_PROP_BITRATE | (読み取り専用) 動画のビットレート(kbits/s) |
| CAP_PROP_ORIENTATION_META Python: cv.CAP_PROP_ORIENTATION_META | (読み取り専用) ストリームのメタデータで定義されたフレームの回転(FFmpegおよびAVFoundationバックエンドのみ適用) |
| CAP_PROP_ORIENTATION_AUTO Python: cv.CAP_PROP_ORIENTATION_AUTO | trueの場合、動画ファイルのメタデータを考慮してCvCaptureの出力フレームを回転する(FFmpegおよびAVFoundationバックエンドのみ適用)(https://github.com/opencv/opencv/issues/15499) |
| CAP_PROP_HW_ACCELERATION Python: cv.CAP_PROP_HW_ACCELERATION | (オープン時のみ) ハードウェアアクセラレーションの種類(VideoAccelerationType を参照)。設定は cv::VideoCapture のコンストラクタ / .open() メソッドの |
| CAP_PROP_HW_DEVICE Python: cv.CAP_PROP_HW_DEVICE | (オープン時のみ) ハードウェアデバイスのインデックス(複数利用可能な場合にGPUを選択)。デバイスの列挙はアクセラレーションの種類に固有。 |
| CAP_PROP_HW_ACCELERATION_USE_OPENCL Python: cv.CAP_PROP_HW_ACCELERATION_USE_OPENCL | (オープン時のみ) 非ゼロの場合、新しいOpenCLコンテキストを作成して現在のスレッドにバインドする。作成されるOpenCLコンテキストには(まだアタッチされていなければ)Video Accelerationコンテキストがアタッチされ、HWアクセラレーションされたデコーダと cv::UMat の間で最適化されたGPUデータコピーを行う。 |
| CAP_PROP_OPEN_TIMEOUT_MSEC Python: cv.CAP_PROP_OPEN_TIMEOUT_MSEC | (オープン時のみ) 動画キャプチャを開く際のタイムアウト(ミリ秒)(FFmpegおよびGStreamerバックエンドのみ適用) |
| CAP_PROP_READ_TIMEOUT_MSEC Python: cv.CAP_PROP_READ_TIMEOUT_MSEC | (オープン時のみ) 動画キャプチャからの読み取りのタイムアウト(ミリ秒)(FFmpegおよびGStreamerバックエンドのみ適用) |
| CAP_PROP_STREAM_OPEN_TIME_USEC Python: cv.CAP_PROP_STREAM_OPEN_TIME_USEC | (読み取り専用) ストリームが開かれた時点の、1970年1月1日からの経過時間(マイクロ秒)。FFmpegバックエンドのみ適用。RTSPやその他のライブストリームに有用 |
| CAP_PROP_VIDEO_TOTAL_CHANNELS Python: cv.CAP_PROP_VIDEO_TOTAL_CHANNELS | (読み取り専用) 動画チャンネル数 |
| CAP_PROP_VIDEO_STREAM Python: cv.CAP_PROP_VIDEO_STREAM | (オープン時のみ) 動画ストリームを指定する(0始まりのインデックス)。-1を指定すると、ファイルまたはIPカメラからの動画ストリームを無効化する。デフォルト値は0。 |
| CAP_PROP_AUDIO_STREAM Python: cv.CAP_PROP_AUDIO_STREAM | (オープン時のみ) 多言語メディアファイル内のストリームを指定する。-1はオーディオ処理またはマイクの無効化。デフォルト値は-1。 |
| CAP_PROP_AUDIO_POS Python: cv.CAP_PROP_AUDIO_POS | (読み取り専用) オーディオ位置はサンプル数で計測される。直前にグラブされたフラグメントの正確なオーディオサンプルのタイムスタンプ。CAP_PROP_AUDIO_SAMPLES_PER_SECOND および CAP_PROP_AUDIO_SHIFT_NSEC を参照。 |
| CAP_PROP_AUDIO_SHIFT_NSEC Python: cv.CAP_PROP_AUDIO_SHIFT_NSEC | (読み取り専用) オーディオストリームと動画ストリームの開始時刻の差をナノ秒単位で保持する。正の値はオーディオが最初の動画フレームより後に開始したことを意味する。負の値はオーディオが最初の動画フレームより前に開始したことを意味する。 |
| CAP_PROP_AUDIO_DATA_DEPTH Python: cv.CAP_PROP_AUDIO_DATA_DEPTH | (オープン、読み取り) bits-per-sampleの代替定義だが、32F / 32S を明確に扱える |
| CAP_PROP_AUDIO_SAMPLES_PER_SECOND Python: cv.CAP_PROP_AUDIO_SAMPLES_PER_SECOND | (オープン、読み取り) ファイル/コーデックの入力から判定される。指定されない場合、選択されるオーディオサンプルレートは44100となる |
| CAP_PROP_AUDIO_BASE_INDEX Python: cv.CAP_PROP_AUDIO_BASE_INDEX | (読み取り専用) .retrieve() 呼び出しにおける最初のオーディオチャンネルのインデックス。このオーディオチャンネル番号は動画チャンネルの後に続けて列挙される。 |
| CAP_PROP_AUDIO_TOTAL_CHANNELS Python: cv.CAP_PROP_AUDIO_TOTAL_CHANNELS | (読み取り専用) 選択されたオーディオストリーム内のオーディオチャンネル数(モノラル、ステレオなど) |
| CAP_PROP_AUDIO_TOTAL_STREAMS Python: cv.CAP_PROP_AUDIO_TOTAL_STREAMS | (読み取り専用) オーディオストリーム数。 |
| CAP_PROP_AUDIO_SYNCHRONIZE Python: cv.CAP_PROP_AUDIO_SYNCHRONIZE | (オープン、読み取り) オーディオ同期を有効にする。 |
| CAP_PROP_LRF_HAS_KEY_FRAME Python: cv.CAP_PROP_LRF_HAS_KEY_FRAME | FFmpegバックエンドのみ - VideoCapture が VideoCapture::open(CAP_FFMPEG, {CAP_PROP_FORMAT, -1}) で初期化されているか、最初の VideoCapture::read() 呼び出し前に VideoCapture::set(CAP_PROP_FORMAT,-1) が呼ばれている場合に、VideoCapture::read() から出力される最後のRAWフレーム(Last Raw Frame, LRF)が、キーフレームのエンコード済みデータを含むかどうかを示す。 |
| CAP_PROP_CODEC_EXTRADATA_INDEX Python: cv.CAP_PROP_CODEC_EXTRADATA_INDEX | 正のインデックスは、動画バックエンドが追加データの返却に対応していることを示す。これは cap.retrieve(data, <returned index>) で取得できる。例: h264エンコードのRTSPストリームを読み込む際、FFmpegバックエンドは(DESCRIBEリクエストへの応答として送られていれば)利用可能なSPSやPPSを、cap.retrieve(data, <returned index>) の呼び出しから返すことがある。 |
| CAP_PROP_FRAME_TYPE Python: cv.CAP_PROP_FRAME_TYPE | (読み取り専用) FFmpegバックエンドのみ - 直近に読み込まれたフレームのフレームタイプのascii コード(73 = 'I', 80 = 'P', 66 = 'B'、不明な場合は 63 = '?')。 |
| CAP_PROP_N_THREADS Python: cv.CAP_PROP_N_THREADS | (オープン時のみ) 使用するスレッドの最大数を設定する。0を指定するとCPUコア数と同じ数のスレッドを使用する(FFmpegバックエンドのみ適用)。 |
| CAP_PROP_PTS Python: cv.CAP_PROP_PTS | (読み取り専用) FFmpegバックエンドのみ - FPSタイムベースを用いた、直近に読み込まれたフレームのプレゼンテーションタイムスタンプ。例: fps = 25 のとき、VideoCapture::get(CAP_PROP_PTS) = 3 ならば、プレゼンテーション時刻 = 3/25 秒。 |
| CAP_PROP_DTS_DELAY Python: cv.CAP_PROP_DTS_DELAY | (読み取り専用) FFmpegバックエンドのみ - FPSタイムベースを用いた、プレゼンテーション(pts)とデコンプレッションタイムスタンプ(dts)の最大差。例: 遅延は frame_num = 0 のときに最大となり、true の場合、VideoCapture::get(CAP_PROP_PTS) = 0 かつ VideoCapture::get(CAP_PROP_DTS_DELAY) = 2、dts = -2 となる。非ゼロの値は通常、ストリームがプレゼンテーション順にデコードされないBフレームを用いてエンコードされていることを意味する。 |
#include <opencv2/videoio.hpp>
cv::VideoWriter の汎用プロパティ識別子。
| 列挙値 | |
|---|---|
| VIDEOWRITER_PROP_QUALITY Python: cv.VIDEOWRITER_PROP_QUALITY | エンコードされた動画ストリームの現在の品質(0..100%)。一部のコーデックでは動的に調整できる。 |
| VIDEOWRITER_PROP_FRAMEBYTES Python: cv.VIDEOWRITER_PROP_FRAMEBYTES | (読み取り専用): エンコードされたばかりの動画フレームのサイズ。エンコード順は表示順と異なる場合があることに注意。 |
| VIDEOWRITER_PROP_NSTRIPES Python: cv.VIDEOWRITER_PROP_NSTRIPES | 並列エンコードのストライプ数。-1で自動検出。 |
| VIDEOWRITER_PROP_IS_COLOR Python: cv.VIDEOWRITER_PROP_IS_COLOR | 非ゼロの場合、エンコーダはカラーフレームを期待してエンコードし、そうでなければグレースケールフレームを扱う。 |
| VIDEOWRITER_PROP_DEPTH Python: cv.VIDEOWRITER_PROP_DEPTH | デフォルトは CV_8U。 |
| VIDEOWRITER_PROP_HW_ACCELERATION Python: cv.VIDEOWRITER_PROP_HW_ACCELERATION | (オープン時のみ) ハードウェアアクセラレーションの種類(VideoAccelerationType を参照)。設定は VideoWriter のコンストラクタ / .open() メソッドの |
| VIDEOWRITER_PROP_HW_DEVICE Python: cv.VIDEOWRITER_PROP_HW_DEVICE | (オープン時のみ) ハードウェアデバイスのインデックス(複数利用可能な場合にGPUを選択)。デバイスの列挙はアクセラレーションの種類に固有。 |
| VIDEOWRITER_PROP_HW_ACCELERATION_USE_OPENCL Python: cv.VIDEOWRITER_PROP_HW_ACCELERATION_USE_OPENCL | (オープン時のみ) 非ゼロの場合、新しいOpenCLコンテキストを作成して現在のスレッドにバインドする。作成されるOpenCLコンテキストには(まだアタッチされていなければ)Video Accelerationコンテキストがアタッチされ、cv::UMat とHWアクセラレーションされたエンコーダの間で最適化されたGPUデータコピーを行う。 |
| VIDEOWRITER_PROP_RAW_VIDEO Python: cv.VIDEOWRITER_PROP_RAW_VIDEO | (オープン時のみ) 非ゼロに設定すると、エンコード済みのRAW動画ストリームのカプセル化を有効にする。エンコード済みの各RAW動画フレームは、CV_8UC1 の Mat の単一の行または列として VideoWriter::write() に渡す必要がある。
|
| VIDEOWRITER_PROP_KEY_INTERVAL Python: cv.VIDEOWRITER_PROP_KEY_INTERVAL | (オープン時のみ) RAW動画カプセル化(VIDEOWRITER_PROP_RAW_VIDEO != 0)使用時のキーフレーム間隔を設定する。設定しない場合のデフォルトは1。FFmpegバックエンドのみ。 |
| VIDEOWRITER_PROP_KEY_FLAG Python: cv.VIDEOWRITER_PROP_KEY_FLAG | RAW動画をカプセル化する(VIDEOWRITER_PROP_RAW_VIDEO != 0)際に、以降のフレームがキーフレームであることを示すには非ゼロに、そうでなければゼロに設定する。FFmpegバックエンドのみ。 |
| VIDEOWRITER_PROP_PTS Python: cv.VIDEOWRITER_PROP_PTS | FPSタイムベースを用いて各フレームのフレームプレゼンテーションタイムスタンプを指定する。このプロパティは、双方向Bフレームを含むGOPパターンのように、デコード順が表示順と異なる外部でエンコードされた動画をカプセル化する場合にのみ必要となる。値は外部エンコーダから提供されるべきものであり、フレームレートが固定された動画ソースの場合は、現在のフレームのプレゼンテーション時刻(CAP_PROP_POS_MSEC)をフレーム持続時間(1000.0 / VideoCapture::get(CAP_PROP_FPS))で割った値に等しい。これは結果として得られるカプセル化された動画ファイルから VideoCapture::get(CAP_PROP_PTS) を用いて問い合わせできる。FFmpegバックエンドのみ。 |
| VIDEOWRITER_PROP_DTS_DELAY Python: cv.VIDEOWRITER_PROP_DTS_DELAY | FPSタイムベースを用いた、プレゼンテーション(pts)とデコンプレッションタイムスタンプ(dts)の最大差を指定する。このプロパティは、双方向Bフレームを含むGOPパターンのように、デコード順が表示順と異なる外部でエンコードされた動画をカプセル化する場合にのみ必要となる。値はエンコード時に使用された特定のGOPパターンに基づいて計算すべきである。例えば、表示順IBP、デコード順IPBのGOPでは、Bフレームは2番目に表示されるが3番目にデコードされるため、この値は1となる。これは結果として得られるカプセル化された動画ファイルから VideoCapture::get(CAP_PROP_DTS_DELAY) を用いて問い合わせできる。非ゼロの値は通常、ストリームがBフレームを用いてエンコードされていることを意味する。FFmpegバックエンドのみ。 |