OpenCV VideoCapture 使い方入門：動画・カメラ操作の基本

By /

はい、承知いたしました。OpenCVのcv2.VideoCaptureクラスについて、動画やカメラの操作の基本を詳細に解説する約5000語の記事を作成します。

OpenCV VideoCapture 入門：動画・カメラ操作の基本と実践

はじめに

コンピュータービジョン分野において、動画やリアルタイムのカメラ映像を扱うことは非常に一般的です。監視システム、ロボット工学、インタラクティブなアプリケーション、画像・動画解析など、多くの応用で映像入力が必要となります。OpenCV（Open Source Computer Vision Library）は、これらのタスクを効率的かつ柔軟に実現するための強力なライブラリです。

OpenCVで動画ファイルやカメラデバイスを操作する際の中心となるのが、cv2.VideoCaptureクラスです。このクラスを使用することで、動画ファイルからフレームを読み込んだり、接続されたカメラからライブストリームを取得したりすることができます。

この記事では、Python版OpenCVを使用して、cv2.VideoCaptureの基本的な使い方から、より実践的な応用、そして知っておくべき詳細について、約5000語をかけて網羅的に解説します。動画やカメラを使ったプログラミングの第一歩を踏み出すために、ぜひこの記事を参考にしてください。

前提条件と環境構築

この記事のコード例はPythonで記述されています。以下のものが必要になります。

  1. Python: Python 3.6以上のバージョンを推奨します。
  2. OpenCV Library: Python版OpenCVライブラリが必要です。

OpenCVライブラリは、pipを使って簡単にインストールできます。コマンドプロンプトやターミナルを開き、以下のコマンドを実行してください。

bash
pip install opencv-python

もしGUI機能（cv2.imshowなど）も利用したい場合は、通常opencv-pythonに含まれていますが、環境によってはopencv-contrib-pythonが必要になる場合があります。

bash
pip install opencv-contrib-python

特定の動画コーデック（例：FFmpeg）が必要な場合、OpenCVをソースからビルドするか、システムに別途インストールが必要な場合がありますが、多くの場合、pip install opencv-pythonで基本的な機能は利用可能です。

cv2.VideoCaptureとは？

cv2.VideoCaptureは、OpenCVが提供する、動画ファイルまたはカメラデバイスを開いて、そこからフレーム（画像データ）を読み込むためのインターフェースです。動画は一連の静止画（フレーム）から構成されており、VideoCaptureはそれらのフレームを順番に取得する機能を提供します。カメラの場合は、一定間隔でセンサーから取得される画像をフレームとして提供します。

cv2.VideoCaptureクラスを使うことで、以下の基本的な操作が可能になります。

  • 動画ファイルを開く
  • 接続されたカメラデバイスを開く
  • 正常に開けたか確認する
  • 次のフレームを読み込む
  • 動画やカメラの様々なプロパティ（解像度、フレームレート、総フレーム数など）を取得する
  • 一部のプロパティ（解像度、再生位置など）を設定する
  • 使用したリソース（ファイルハンドル、カメラデバイス）を解放する

VideoCaptureオブジェクトの生成とオープン

cv2.VideoCaptureを使用するには、まずこのクラスのオブジェクトを作成します。オブジェクトを作成する際に、どの動画ファイルまたはどのカメラを開くかを指定します。

1. 動画ファイルを開く

特定の動画ファイルを開く場合、コンストラクタに動画ファイルのパス（ファイル名）を文字列として渡します。

“`python
import cv2

動画ファイルのパスを指定

video_path = ‘your_video.mp4’ # ここを実際のファイル名に置き換えてください

VideoCaptureオブジェクトを作成

cap = cv2.VideoCapture(video_path)
“`

your_video.mp4の部分を、実際に開きたい動画ファイルのパスに置き換えてください。ローカルにあるファイルであれば、絶対パスまたはPythonスクリプトからの相対パスで指定します。

対応している動画フォーマットは、OpenCVがビルドされた環境やインストールされているコーデックに依存しますが、一般的にはMP4, AVI, WMV, MOVなどがサポートされています。

2. カメラデバイスを開く

コンピューターに接続されたカメラデバイスを開く場合、コンストラクタにデバイスのインデックス（識別番号）を整数として渡します。通常、デフォルトのカメラはインデックス0で指定されます。複数のカメラが接続されている場合、1, 2, … と番号が振られます。

“`python
import cv2

カメラデバイスのインデックスを指定

camera_index = 0 # 通常は0が内蔵カメラやプライマリカメラ

VideoCaptureオブジェクトを作成

cap = cv2.VideoCapture(camera_index)
“`

カメラのインデックスは環境によって異なる場合があります。特にUSBカメラなどを複数接続している場合、どのインデックスがどのカメラに対応するかは実行時に試してみる必要があるかもしれません。一般的なシステムでは、内蔵カメラや最初に認識されたカメラが0になります。もしインデックス0でカメラが開けない場合は、-1などを試してみることもあります（ただし、これは古いOpenCVの挙動である可能性が高いです。現在は通常0から順に割り当てられます）。

3. 開けたかどうかの確認

cv2.VideoCaptureオブジェクトが作成された時点では、指定された動画ファイルやカメラデバイスが正常に開かれたかどうかは保証されません。ファイルが存在しない、パスが間違っている、カメラが接続されていない、カメラが他のアプリケーションによって使用中、必要なコーデックがない、といった様々な理由でオープンに失敗することがあります。

オブジェクトが正常にデバイスを開けたかどうかは、isOpened()メソッドを使って確認する必要があります。これは非常に重要なステップです。

“`python
import cv2
import sys

動画ファイルまたはカメラを開く (例: カメラを開く)

camera_index = 0
cap = cv2.VideoCapture(camera_index)

正常に開けたか確認

if not cap.isOpened():
print(“エラー: カメラを開けませんでした。”)
sys.exit() # プログラムを終了する
“`

この確認を怠ると、その後のフレーム読み込みやプロパティ取得の操作でエラーが発生し、プログラムがクラッシュする原因となります。常にisOpened()で確認し、失敗した場合は適切なエラー処理（エラーメッセージ表示、プログラム終了など）を行うべきです。

フレームの読み込みと表示

VideoCaptureオブジェクトが正常に開けたら、次にその中から個々のフレームを読み込みます。フレームを読み込むには、read()メソッドを使用します。

read() メソッド

read()メソッドは、動画やカメラストリームから次のフレームを1つ読み込みます。このメソッドは2つの値を返します。

  1. 成功フラグ (ret): フレームの読み込みが成功したかどうかを示すブール値です (TrueまたはFalse)。動画の終端に達した場合や、カメラからの読み込みに失敗した場合にFalseを返します。
  2. フレーム (frame): 読み込まれたフレームの画像データです。NumPyのndarray形式で返されます。読み込みに失敗した場合はNoneが返されます。

基本的なフレーム読み込みループは以下のようになります。

“`python
import cv2
import sys

カメラを開く (例)

cap = cv2.VideoCapture(0)

if not cap.isOpened():
print(“エラー: カメラを開けませんでした。”)
sys.exit()

while True:
# フレームを1つ読み込む
ret, frame = cap.read()

# フレームの読み込みに失敗した場合 (動画の終端など)
if not ret:
    print("フレームを読み込めません。終了します。")
    break

# ここでフレーム (frame) に対して画像処理などを行う
# 例: グレースケールに変換
# gray_frame = cv2.cvtColor(frame, cv2.COLOR_BGR2GRAY)

# フレームを表示する (OpenCVのウィンドウ機能)
cv2.imshow('Camera Feed', frame) # ウィンドウタイトル 'Camera Feed' で frame を表示
# cv2.imshow('Grayscale Feed', gray_frame) # グレースケールフレームを表示する場合

# キー入力を待つ
# cv2.waitKey() は指定したミリ秒だけキー入力を待つ関数
# 引数に 1 を指定すると、約1ms待つ (フレームレート制御に使われることが多い)
# 戻り値は押されたキーのASCIIコード、何も押されなければ -1
# 0xFF は下位8ビットを取り出すためのマスク (環境による違いを吸収)
# ord('q') は 'q' キーのASCIIコードを取得
if cv2.waitKey(1) & 0xFF == ord('q'):
    break # 'q' キーが押されたらループを抜ける

リソースの解放

cap.release() # VideoCaptureオブジェクトを解放
cv2.destroyAllWindows() # 作成された全てのウィンドウを閉じる
“`

このコードは、カメラからの映像をリアルタイムでウィンドウに表示し、’q’キーが押されるまでこれを続けます。

詳細な解説

  • while True:: 無限ループを作成し、カメラが接続されている限り、または動画の終端に達するまでフレームを読み込み続けます。
  • ret, frame = cap.read(): 各ループイテレーションで次のフレームを読み込みます。
  • if not ret:: read()がFalseを返した場合（読み込み失敗）、ループを中断します。動画ファイルの場合は終端、カメラの場合はエラー発生などが考えられます。
  • cv2.imshow(window_name, image): 指定されたウィンドウ名で新しいウィンドウを作成（または既存のウィンドウを更新）し、与えられた画像（NumPy配列）を表示します。ウィンドウ名は任意に指定できます。
  • cv2.waitKey(delay): キーボード入力を待ちます。引数delayは待つ時間（ミリ秒）です。delay=0とすると、キー入力があるまで無限に待ちます。delay=1はノンブロッキングに近い形で、次のフレーム処理に進む前にわずかに待機します。この待機時間が、フレームレートを制御するのに役立つことがあります。戻り値は押されたキーのコードです。
  • & 0xFF == ord('q'): cv2.waitKey()の戻り値は環境によって上位ビットが付加されることがあるため、& 0xFFで下位8ビットだけを取り出すのが一般的な方法です。これにより、押されたキーの基本的なASCIIコードが得られます。ord('q')は文字 ‘q’ のASCIIコードを返します。この条件で ‘q’ キーが押されたかを判定しています。
  • cap.release(): VideoCaptureオブジェクトが使用していたリソース（カメラデバイス、ファイルハンドルなど）を解放します。プログラムが終了する前に必ず呼び出すべきです。これを忘れると、カメラデバイスが他のアプリケーションから使用できなくなったり、ファイルが適切に閉じられなかったりする可能性があります。
  • cv2.destroyAllWindows(): cv2.imshow()で作成された全てのウィンドウを閉じます。これもプログラムの終了時に呼び出すのが一般的です。

動画・カメラのプロパティ取得 (get())

cv2.VideoCaptureオブジェクトは、開いている動画やカメラに関する様々な情報（プロパティ）を持っています。これらのプロパティは、get()メソッドを使って取得できます。

get()メソッドは、引数として取得したいプロパティを示す定数（cv2.CAP_PROP_*）を取ります。戻り値は、指定されたプロパティの値です（通常は浮動小数点数）。

よく使われるプロパティ定数をいくつか紹介します。

  • cv2.CAP_PROP_FRAME_WIDTH: フレームの幅（ピクセル単位）
  • cv2.CAP_PROP_FRAME_HEIGHT: フレームの高さ（ピクセル単位）
  • cv2.CAP_PROP_FPS: フレームレート（秒間フレーム数）
  • cv2.CAP_PROP_FRAME_COUNT: 動画の総フレーム数（動画ファイルの場合のみ有効）
  • cv2.CAP_PROP_POS_FRAMES: 現在のフレームのインデックス（0から始まる）
  • cv2.CAP_PROP_POS_MSEC: 動画の現在位置（ミリ秒単位）
  • cv2.CAP_PROP_BRIGHTNESS: カメラの明るさ（カメラの場合のみ有効）
  • cv2.CAP_PROP_CONTRAST: カメラのコントラスト（カメラの場合のみ有効）
  • cv2.CAP_PROP_SATURATION: カメラの彩度（カメラの場合のみ有効）
  • cv2.CAP_PROP_HUE: カメラの色相（カメラの場合のみ有効）

これらのプロパティは、カメラの種類やドライバー、動画ファイルの形式によってサポートされているかどうかが異なります。サポートされていないプロパティを取得しようとすると、通常は0を返します。

プロパティ取得の例

“`python
import cv2
import sys

動画ファイルを開く (例)

video_path = ‘your_video.mp4’ # 実際の動画ファイルに置き換え
cap = cv2.VideoCapture(video_path)

またはカメラを開く

camera_index = 0

cap = cv2.VideoCapture(camera_index)

if not cap.isOpened():
print(f”エラー: {video_path} を開けませんでした。”)
sys.exit()

動画/カメラのプロパティを取得

frame_width = int(cap.get(cv2.CAP_PROP_FRAME_WIDTH))
frame_height = int(cap.get(cv2.CAP_PROP_FRAME_HEIGHT))
fps = cap.get(cv2.CAP_PROP_FPS)
frame_count = int(cap.get(cv2.CAP_PROP_FRAME_COUNT)) # 動画ファイルの場合のみ有効

print(f”フレーム幅: {frame_width}”)
print(f”フレーム高さ: {frame_height}”)
print(f”フレームレート (FPS): {fps}”)
print(f”総フレーム数: {frame_count}”) # 動画ファイルの場合のみ意味のある値になる

カメラの場合に取得できる可能性のあるプロパティ例

brightness = cap.get(cv2.CAP_PROP_BRIGHTNESS)

print(f”明るさ: {brightness}”)

必要に応じてフレームを読み込んで表示するループなどを続ける…

while True:

ret, frame = cap.read()

if not ret: break

cv2.imshow(‘Video Frame’, frame)

if cv2.waitKey(int(1000/fps)) & 0xFF == ord(‘q’): # フレームレートに合わせて待機時間調整

break

リソース解放

cap.release()
cv2.destroyAllWindows()
“`

注意: 動画ファイルの場合、cv2.CAP_PROP_FRAME_COUNTやcv2.CAP_PROP_FPSなどのプロパティは正確な値を取得できることが多いですが、一部のフォーマットや破損したファイルでは取得できない、あるいは不正確な値になることがあります。カメラの場合、cv2.CAP_PROP_FRAME_COUNTは通常無効な値（-1など）を返します。また、カメラのプロパティ（明るさ、コントラストなど）は、カメラハードウェアとドライバーがその設定変更をサポートしている場合にのみ有効な値を返します。

動画・カメラのプロパティ設定 (set())

一部のcv2.CAP_PROP_*プロパティは、set()メソッドを使って値を変更することができます。これは特にカメラの設定（解像度など）や、動画ファイルでの特定位置へのシーク（再生位置の変更）を行う場合に便利です。

set()メソッドは、引数として設定したいプロパティを示す定数（cv2.CAP_PROP_*）と、設定したい値を取ります。設定が成功した場合はTrueを、失敗した場合はFalseを返します。

よく設定されるプロパティ

  • cv2.CAP_PROP_FRAME_WIDTH: フレームの幅を設定
  • cv2.CAP_PROP_FRAME_HEIGHT: フレームの高さを設定
  • cv2.CAP_PROP_POS_FRAMES: 現在のフレーム位置をフレームインデックスで設定（動画ファイルの場合）
  • cv2.CAP_PROP_POS_MSEC: 動画の現在位置をミリ秒で設定（動画ファイルの場合）

プロパティ設定の例：カメラ解像度変更

カメラを開いた後で解像度を変更してみます。ただし、カメラがその解像度をサポートしている必要があります。サポートされていない解像度を設定しようとしても、通常は無視されるか失敗します。

“`python
import cv2
import sys

カメラを開く

camera_index = 0
cap = cv2.VideoCapture(camera_index)

if not cap.isOpened():
print(“エラー: カメラを開けませんでした。”)
sys.exit()

現在の解像度を取得して表示

current_width = int(cap.get(cv2.CAP_PROP_FRAME_WIDTH))
current_height = int(cap.get(cv2.CAP_PROP_FRAME_HEIGHT))
print(f”初期解像度: {current_width}x{current_height}”)

新しい解像度を設定してみる (例: 640×480)

new_width = 640
new_height = 480

set()メソッドは設定成功の True/False を返す

success_width = cap.set(cv2.CAP_PROP_FRAME_WIDTH, new_width)
success_height = cap.set(cv2.CAP_PROP_FRAME_HEIGHT, new_height)

設定後の解像度を再度取得して確認

実際に設定された値は、要求した値と異なる場合があります

actual_width = int(cap.get(cv2.CAP_PROP_FRAME_WIDTH))
actual_height = int(cap.get(cv2.CAP_PROP_FRAME_HEIGHT))

print(f”設定要求 成功?: 幅={success_width}, 高さ={success_height}”)
print(f”設定後 実際の解像度: {actual_width}x{actual_height}”)

フレームを取得して表示するループ

while True:
ret, frame = cap.read()
if not ret:
print(“フレーム取得失敗”)
break

cv2.imshow('Camera Feed (Resized)', frame)

if cv2.waitKey(1) & 0xFF == ord('q'):
    break

cap.release()
cv2.destroyAllWindows()
“`

この例では、設定要求が成功したかどうか (success_width, success_height) と、実際に設定された値 (actual_width, actual_height) の両方を確認しています。これは、set()がTrueを返しても、要求した値が完全に反映されないことがあるためです。

プロパティ設定の例：動画のシーク

動画ファイルの場合、set()メソッドを使って特定のフレームや時間位置にシーク（再生位置を移動）することができます。これは、動画解析で特定のシーンから処理を開始したい場合などに便利です。

“`python
import cv2
import sys
import time

動画ファイルを開く

video_path = ‘your_video.mp4’ # 実際の動画ファイルに置き換え
cap = cv2.VideoCapture(video_path)

if not cap.isOpened():
print(f”エラー: {video_path} を開けませんでした。”)
sys.exit()

total_frames = int(cap.get(cv2.CAP_PROP_FRAME_COUNT))
fps = cap.get(cv2.CAP_PROP_FPS)
duration_sec = total_frames / fps if fps > 0 else 0 # 秒単位の動画長さ

print(f”総フレーム数: {total_frames}”)
print(f”フレームレート: {fps}”)
print(f”動画の長さ: {duration_sec:.2f} 秒”)

100フレーム目にシークしてみる

target_frame_index = 100
print(f”\n{target_frame_index} フレーム目にシーク…”)
success_seek_frame = cap.set(cv2.CAP_PROP_POS_FRAMES, target_frame_index)
print(f”フレームシーク成功?: {success_seek_frame}”)

シーク後の現在位置を確認

current_frame_index_after_seek = int(cap.get(cv2.CAP_PROP_POS_FRAMES))
print(f”シーク後 現在のフレームインデックス: {current_frame_index_after_seek}”)

シークした位置から数フレーム読み込んで表示

print(f”\n{target_frame_index} フレーム目から数フレーム表示:”)
for i in range(5): # 5フレームだけ表示
ret, frame = cap.read()
if not ret:
print(f”フレーム読み込み失敗 (フレームインデックス {current_frame_index_after_seek + i})”)
break
cv2.imshow(f’Frame {current_frame_index_after_seek + i}’, frame)
# 1秒待機して次のフレームを表示
cv2.waitKey(1000)
# シーク後の現在位置を確認 (read()するたびにインデックスは進む)
print(f”読込後 現在のフレームインデックス: {int(cap.get(cv2.CAP_PROP_POS_FRAMES))}”)

別の方法でシーク: 動画開始から5秒後の位置にシークしてみる

target_time_sec = 5.0
target_time_msec = target_time_sec * 1000
print(f”\n{target_time_sec:.2f} 秒 ( {target_time_msec:.0f} ミリ秒) にシーク…”)
success_seek_time = cap.set(cv2.CAP_PROP_POS_MSEC, target_time_msec)
print(f”時間シーク成功?: {success_seek_time}”)

シーク後の現在位置を確認

current_time_msec_after_seek = cap.get(cv2.CAP_PROP_POS_MSEC)
print(f”シーク後 現在の時間位置 (ミリ秒): {current_time_msec_after_seek}”)
print(f”シーク後 現在のフレームインデックス: {int(cap.get(cv2.CAP_PROP_POS_FRAMES))}”)

シークした位置から数フレーム読み込んで表示

print(f”\n{target_time_sec:.2f} 秒の位置から数フレーム表示:”)
for i in range(5): # 5フレームだけ表示
ret, frame = cap.read()
if not ret:
print(f”フレーム読み込み失敗 (時間位置 {cap.get(cv2.CAP_PROP_POS_MSEC):.0f} ミリ秒)”)
break
cv2.imshow(f’Frame after {target_time_sec:.2f}s seek ({i})’, frame)
# 1秒待機して次のフレームを表示
cv2.waitKey(1000)

全てのウィンドウを閉じるためにキー入力を待つ

print(“\nウィンドウを閉じるには任意のキーを押してください…”)
cv2.waitKey(0)

リソース解放

cap.release()
cv2.destroyAllWindows()
“`

動画ファイルのシークは、動画のエンコーディング方式（キーフレームの位置など）に依存するため、要求したフレームや時間位置に正確にシークできない場合があります。特に非主要なフレームへのシークは時間がかかることがあります。cv2.CAP_PROP_POS_FRAMESやcv2.CAP_PROP_POS_MSECでシークした後、read()メソッドを呼び出すことで、指定位置以降のフレームを順次読み込むことができます。

エラー処理とリソース管理の重要性

これまでのコード例でも触れてきましたが、cv2.VideoCaptureを使う上で、以下の2点は非常に重要です。

  1. isOpened()による開成確認: ファイルパスの間違い、カメラデバイスの不利用、コーデック不足など、VideoCaptureオブジェクトが正常に初期化できない原因は多岐にわたります。isOpened()で確認せずにread()やget()などのメソッドを呼び出すと、予期しないエラーやクラッシュの原因となります。必ず開成確認を行い、失敗した場合は適切なエラーメッセージを表示してプログラムを終了するなど、エラー処理を行うべきです。
  2. release()とcv2.destroyAllWindows()によるリソース解放: VideoCaptureオブジェクトは、カメラデバイスを占有したり、動画ファイルへのハンドルを持ったりします。プログラムが終了する前にcap.release()を呼び出してこれらのリソースを解放しないと、カメラが他のアプリケーションから使えなくなったり、ファイルがロックされたままになったりといった問題が発生する可能性があります。また、cv2.imshow()で作成したウィンドウは、cv2.destroyAllWindows()またはcv2.destroyWindow(window_name)を呼び出すことで閉じられます。これらの後片付けも忘れずに行う必要があります。

特に、プログラムの実行中に例外が発生した場合でもリソースが解放されるように、Pythonのtry...finallyブロックを使用するのが堅牢な方法です。

“`python
import cv2
import sys

cap = None # cap変数を初期化しておく
try:
# カメラを開く (例)
camera_index = 0
cap = cv2.VideoCapture(camera_index)

if not cap.isOpened():
    print("エラー: カメラを開けませんでした。")
    sys.exit() # 開けなかった場合はここで終了

print("カメラを開きました。フレームを表示します...")

while True:
    ret, frame = cap.read()

    if not ret:
        print("フレーム読み込み失敗。")
        break

    cv2.imshow('Camera Feed (Robust)', frame)

    if cv2.waitKey(1) & 0xFF == ord('q'):
        print("'q' キーが押されました。終了します。")
        break

    # 何らかの理由で例外が発生する可能性のあるコード (例)
    # result = 10 / 0 # ZeroDivisionError を意図的に発生させる

except Exception as e:
print(f”予期しないエラーが発生しました: {e}”)
# エラーが発生しても finally ブロックは実行される

finally:
# tryブロックでcapが正常に作成された場合のみreleaseを呼び出す
if cap is not None and cap.isOpened():
cap.release()
print(“VideoCaptureリソースを解放しました。”)

# ウィンドウを閉じる
cv2.destroyAllWindows()
print("全てのウィンドウを閉じました。")

print(“プログラム終了。”)
“`

この構造では、tryブロック内でVideoCaptureの操作を行い、finallyブロックでrelease()とdestroyAllWindows()を呼び出しています。これにより、ループが正常に終了した場合も、途中でエラー（例えばZeroDivisionErrorなど）が発生してexceptブロックにジャンプした場合も、必ずリソース解放処理が実行されるようになります。

その他の便利な機能と考慮事項

cv2.VideoCaptureクラスには、上記以外にもいくつかのプロパティや、関連して知っておくと良い事項があります。

cv2.CAP_PROP_FOURCC (動画ファイルの場合)

動画ファイルを読み込む際、そのエンコーディング形式（コーデック）を示すFOURCCコードを取得できます。FOURCCは4文字のコードで、動画データの圧縮方法を示します。

“`python
import cv2
import sys

video_path = ‘your_video.mp4’
cap = cv2.VideoCapture(video_path)

if not cap.isOpened():
print(“エラー: 動画を開けませんでした。”)
sys.exit()

FOURCCを取得 (浮動小数点数で返されるので、整数にキャストして struct.pack で文字列に戻す)

fourcc_code = int(cap.get(cv2.CAP_PROP_FOURCC))

Pythonの struct モジュールを使って整数を4文字のバイト列に変換

import struct
try:
fourcc_str = struct.pack(‘<I’, fourcc_code).decode(‘ascii’)
print(f”動画のFOURCCコーデック: {fourcc_str}”)
except (struct.error, UnicodeDecodeError):
print(f”動画のFOURCCコーデック (数値): {fourcc_code}”)
print(“FOURCCコードを文字列に変換できませんでした。”)

cap.release()
cv2.destroyAllWindows()
“`

このFOURCCコードは、cv2.VideoWriterで動画を書き出す際にも指定する必要があります。

バッファリング

VideoCaptureは通常、スムーズな再生のためにフレームを内部的にバッファリングします。読み込みたいフレームの直前にset(cv2.CAP_PROP_POS_FRAMES, ...)でシークし、続けてread()を呼び出す場合、バッファリングの影響で意図したフレームがすぐに取得できない、あるいは期待と異なるフレームが取得されることがあります。精密なフレーム操作が必要な場合は、バッファリングの挙動を理解し、必要に応じて読み込み位置を調整したり、複数回read()を呼び出してバッファをクリアしたりするなどの対応が必要になることがあります。

cv2.CAP_PROP_BUFFERSIZEプロパティを使ってバッファサイズを取得または設定できることがありますが、これも環境依存性が高く、すべての環境で効果があるわけではありません。

パフォーマンス

read()メソッドは、動画のデコードやカメラからの画像取得といった比較的重い処理を行います。特に高解像度の映像や高速なフレームレートを扱う場合、この処理がボトルネックになりがちです。リアルタイム処理で特定のフレームレートを維持したい場合、画像処理の部分を軽量化するか、またはフレーム読み込みと画像処理を別々のスレッドで行うなどの工夫が必要になります。ただし、マルチスレッディングはVideoCaptureオブジェクトの排他制御など、実装が複雑になります。

簡単な解決策としては、cv2.waitKey(delay)のdelayを調整して、処理時間に余裕を持たせる方法があります。例えば、目標FPSが30であれば、各フレーム処理に約33msかけられることになります。waitKey(1)はほぼノンブロッキングですが、処理時間が33msを超える場合はフレームドロップが発生します。処理時間が10msであれば、waitKey(23)とすることで次のフレームまで合計33ms待機させることができます。

“`python

例: 目標FPS 30 の場合

import time

start_time = time.time()

フレーム処理コード…

end_time = time.time()
processing_time_ms = (end_time – start_time) * 1000

目標フレーム間の時間 (ミリ秒)

target_frame_interval_ms = 1000 / 30

waitKey で待機すべき時間

wait_time_ms = int(target_frame_interval_ms – processing_time_ms)

待ち時間が正の値の場合のみ待機

if wait_time_ms > 0:
if cv2.waitKey(wait_time_ms) & 0xFF == ord(‘q’):
break
else:
# 処理が遅延している場合はすぐに次のフレームへ
if cv2.waitKey(1) & 0xFF == ord(‘q’):
break
“`

ただし、これはあくまで簡易的なフレームレート制御であり、より厳密な同期には他のアプローチが必要です。

カメラの自動設定

多くのカメラデバイスは、明るさ、露出、ホワイトバランスなどの設定を自動的に調整する機能を持っています。これらの設定は、cv2.CAP_PROP_*を使って取得したり設定したりできますが、自動設定が有効な場合、手動で値を設定してもすぐに自動調整によって上書きされてしまうことがあります。自動設定をオフにするためのプロパティ（例: cv2.CAP_PROP_AUTO_EXPOSURE, cv2.CAP_PROP_AUTO_WBなど）も存在しますが、これらのサポート状況はハードウェアとドライバーに大きく依存します。

Linux環境でのカメラ指定

Linux環境では、カメラデバイスは通常 /dev/video0, /dev/video1 のようなファイルとして扱われます。cv2.VideoCapture(0)は通常 /dev/video0 を開こうとします。複数のカメラがある場合、どのデバイスがどの番号になるかは、システムへの接続順序やudevルールによって決まることがあります。特定のカメラを開きたい場合は、インデックス番号を試すか、より高度なシステム設定（例: シンボリックリンクの作成）が必要になる場合があります。

cv2.CAP_PROP 定数一覧 (抜粋)

取得・設定可能なプロパティの一部をリストアップします。完全なリストはOpenCVのドキュメントを参照してください。

定数 説明 型 備考
cv2.CAP_PROP_POS_MSEC 動画ファイルの現在位置（ミリ秒単位） double 動画ファイルのみ
cv2.CAP_PROP_POS_FRAMES 現在のフレームのインデックス（0から始まる） double 動画ファイルのみ
cv2.CAP_PROP_POS_AVI_RATIO 動画ファイルの現在位置（0.0～1.0） double 動画ファイルのみ
cv2.CAP_PROP_FRAME_WIDTH フレームの幅（ピクセル） double 取得・設定可能（カメラの場合）
cv2.CAP_PROP_FRAME_HEIGHT フレームの高さ（ピクセル） double 取得・設定可能（カメラの場合）
cv2.CAP_PROP_FPS フレームレート（秒間フレーム数） double 動画ファイルは取得、カメラは取得・設定
cv2.CAP_PROP_FOURCC 動画ファイルのFOURCCコード double 動画ファイルは取得、VideoWriterで設定
cv2.CAP_PROP_FRAME_COUNT 動画の総フレーム数 double 動画ファイルのみ有効
cv2.CAP_PROP_FORMAT Matオブジェクトのフォーマット（CV_8UC3など） double
cv2.CAP_PROP_MODE 現在のカメラモード double
cv2.CAP_PROP_BRIGHTNESS カメラの明るさ double カメラのみ、取得・設定可能（依存性高）
cv2.CAP_PROP_CONTRAST カメラのコントラスト double カメラのみ、取得・設定可能（依存性高）
cv2.CAP_PROP_SATURATION カメラの彩度 double カメラのみ、取得・設定可能（依存性高）
cv2.CAP_PROP_HUE カメラの色相 double カメラのみ、取得・設定可能（依存性高）
cv2.CAP_PROP_GAIN カメラのゲイン double カメラのみ、取得・設定可能（依存性高）
cv2.CAP_PROP_EXPOSURE カメラの露出時間 double カメラのみ、取得・設定可能（依存性高）
cv2.CAP_PROP_AUTOFOCUS カメラのオートフォーカスON/OFF double カメラのみ、取得・設定可能（依存性高）
cv2.CAP_PROP_SETTINGS カメラ設定ダイアログを表示（Windowsの場合） double カメラのみ、設定のみ（引数は通常0）
cv2.CAP_PROP_BUFFERSIZE 内部バッファリングされるフレーム数 double 取得・設定可能（依存性高）
cv2.CAP_PROP_AUTO_EXPOSURE カメラの自動露出ON/OFF double カメラのみ、取得・設定可能（依存性高）
cv2.CAP_PROP_AUTO_WB カメラの自動ホワイトバランスON/OFF double カメラのみ、取得・設定可能（依存性高）
cv2.CAP_PROP_BACKEND 使用されているVideoCaptureバックエンドのID double 取得のみ

これらのプロパティは、cap.get(property_id)やcap.set(property_id, value)の形で使用します。

まとめ

この記事では、OpenCVのcv2.VideoCaptureクラスを使って、動画ファイルやカメラデバイスを操作する基本的な方法を詳細に解説しました。

  • cv2.VideoCapture(filename) で動画ファイルを、cv2.VideoCapture(index) でカメラを開く方法
  • cap.isOpened() で正常に開けたか確認することの重要性
  • cap.read() を使ってフレームを読み込む基本的なループ構造
  • cv2.imshow() でフレームを表示し、cv2.waitKey() でキー入力を待つ方法
  • cap.get(cv2.CAP_PROP_*) で動画やカメラの様々なプロパティを取得する方法
  • cap.set(cv2.CAP_PROP_*, value) で一部のプロパティ（解像度、動画シークなど）を設定する方法
  • cap.release() と cv2.destroyAllWindows() によるリソース解放、および try...finally を使った堅牢なリソース管理
  • パフォーマンスやカメラ設定など、使用上の注意点

cv2.VideoCaptureは、OpenCVで動画やカメラを扱うための出発点となる非常に重要なクラスです。この記事で解説した基本をしっかりと理解することで、動画やカメラ映像を使った様々なアプリケーション開発に進むことができます。

例えば、取得したフレームに対して顔検出、物体認識、動き検出、色空間変換などの画像処理を施し、その結果を基に何かを行う（例: 特定の物体が検出されたらアラートを出す、顔の位置にエフェクトをかける）といった応用が考えられます。

この記事が、あなたのOpenCVとコンピュータービジョン学習の一助となれば幸いです。ぜひ実際にコードを書いて、動画やカメラの操作を試してみてください。

コメントする

メールアドレスが公開されることはありません。 ※ が付いている欄は必須項目です

上部へスクロール