> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dwe.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# exploreHD OpenCV クイックスタートガイド

> exploreHD カメラを Python と OpenCV で使い始めるための基本ガイド。

<div style={{ marginTop: '-40px' }} />

## 前提条件

アプリケーションを実行する前に、システムに以下がインストールされていることを確認してください:

* Python(バージョン 3.x)
* OpenCV ライブラリ(`cv2`)

## セットアップ

OpenCV Guides リポジトリをクローンし、このガイド用のフォルダーを開きます:

```bash theme={null}
git clone https://github.com/DeepWaterExploration/opencv-guides.git
cd opencv-guides/1-basic-video-capture/python
```

## サンプルコード

以下の `main.py` スクリプトを使用して、カメラに接続し映像を表示できます。カメラを設定する際の重要なポイントは、`MJPG` ピクセルフォーマットを解像度設定の*前に*指定する必要があることです。

```python theme={null}
import cv2

# -- Camera Parameters --
# Camera Index
CAM_IDX = 0
# resolution
WIDTH = 1920
HEIGHT = 1080
# used to set the pixel format to MJPEG/MJPG mode.
MJPG = cv2.VideoWriter_fourcc(*'MJPG')

# -- DEVICE SETUP --
exploreHD = cv2.VideoCapture(CAM_IDX)

# set to MJPEG mode, by default idx 0 is YUYV
# MJPG needs to be set, before resolution. Pixel format is always selected first
exploreHD.set(cv2.CAP_PROP_FOURCC, MJPG)

exploreHD.set(cv2.CAP_PROP_FRAME_WIDTH, WIDTH)
exploreHD.set(cv2.CAP_PROP_FRAME_HEIGHT, HEIGHT)

# (Optional) Disable auto exposure
exploreHD.set(cv2.CAP_PROP_AUTO_EXPOSURE, 1)
exploreHD.set(cv2.CAP_PROP_EXPOSURE, 90)

# Error Check
if ((exploreHD == None) or (not exploreHD.isOpened())):
    print('\nError - could not open video device.\n')
    exit(0)

while(True):
    success, frame = exploreHD.read()
    if (success):
        cv2.imshow('exploreHD', frame)
    
    # required for frames to buffer and show properly.
    k = cv2.waitKey(1)

    # press 'q' to quit
    if k == ord('q'):
        break
    
exploreHD.release()
cv2.destroyAllWindows()
```

## 詳細情報

さらなる詳細、C++ などの他言語のサンプル、トラブルシューティングについては、GitHub リポジトリを参照してください。

<Card title="OpenCV クイックスタートリポジトリ" icon="Github" href="https://github.com/DeepWaterExploration/opencv-guides">
  基本的なビデオキャプチャ、ソフトウェアによるフレームサンプリング、C++ コードなど。
</Card>