OpenCVOpenCV Reference

【OpenCV/Python】画像ファイルの読み込み、表示

OpenCVでBmpやJpegなどの画像ファイルを開くには、imread関数を用います。

開いた画像データはimshow関数でウィンドウ付きで画像を表示します。

実際に画像が表示されるのは、waitKey関数が呼ばれたタイミングとなります。

以下に最もシンプルなサンプルを示します。

import cv2

# 画像ファイルの読み込み(カラー画像(3チャンネル)として読み込まれる)
img = cv2.imread("Mandrill.bmp")

# 画像の表示
cv2.imshow("Image", img)

# キー入力待ち(ここで画像が表示される)
cv2.waitKey()

(実行結果)

OpenCV-Python 画像ファイルを開く 画像の表示

ここに示したサンプルでは、画像データは必ず8bit x 3ch のデータとなり、表示されたウィンドウはリサイズすることができません。

そのようにしないためには、各関数のオプションを設定します。

詳細は、各関数ごとに説明します。

imread()

bmp, jpeg, png, tiff などの画像ファイルを開きます。

cv2.imread( filename[, flags] ) -> retval
引数 説明
filename 画像のファイル名を指定します。
ただし、日本語は使えません。
flags ファイルを開く際に、カラーデータとして開くか?モノクロデータとして開くか?などを指定します。
指定しない場合、カラーデータ(BGRの3チャンネル)として画像ファイルを開きます。
cv2.IMREAD_UNCHANGED 画像ファイルのフォーマットのまま、画像ファイルを開きます。
cv2.IMREAD_GRAYSCALE   グレースケールに変換して画像ファイルを開きます。
cv2.IMREAD_COLOR          カラーデータ(BGRの3チャンネル)に変換して画像ファイルを開きます。
cv2.IMREAD_ANYDEPTH    画像ファイルのビット深度のまま画像ファイルを開きます。
cv2.IMREAD_ANYCOLOR    画像ファイルの色(チャンネル数)のまま画像ファイルを開きます。(参考)ImreadModes
戻り値 画像の輝度値がnumpyのndarray配列に格納されて返されます。
画像データは画像の左上から格納されています。
グレースケールの場合、[高さ, 幅]の二次元配列になります。
カラーの場合、[高さ, 幅, 色]の三次元配列になります。色の順番は、B,G,R,B,G,R・・・の順で格納されています。

画像ファイル名に日本語ファイルを使いたい場合は、NumPyやPillowを使って日本語ファイルを読み込む事も可能です。詳細は以下のページを参照ください。

日本語の画像ファイル読込・保存

また、imread()関数では、画像ファイルが見つからない場合など、画像ファイル読み込み時にエラーが発生しがちです。その場合の対応は以下のページを参照ください。

imreadで画像ファイルが読み込めないときの対応

 

(参考)

OpenCV: Image file reading and writing

imshow()

画像をウィンドウ付きで表示します。
実際に画面に画像が表示されるのは、cv2.waitKey()関数が呼ばれたタイミングで表示されます。

cv2.imshow( winname, mat ) -> None
引数 説明
winname 表示するウィンドウのタイトルを指定します。
namedWindow()関数で作成したウィンドウと同じwinnameを指定することで、画像を表示するウィンドウを切り替えることもできます。
winnameで指定したウィンドウが無い場合、新しいウィンドウで画像を表示します。
日本語を指定すると文字化けします。
mat 表示する画像データを指定します。
戻り値 なし

 

(参考)

OpenCV: High-level GUI

waitKey()

指定時間(mSec)分、キー入力を待ちます。

OpenCVで生成したウィンドウのキー入力イベント待ちとなります。

引数 説明
delay キー入力までの待ち時間をmSec単位で指定します。
値を省略、もしくは 0以下 を指定した場合、無限待ちとなります。
戻り値 入力したキーコードが戻されます。

(参考)

OpenCV: High-level GUI

namedWindow()

imshow()関数で表示するためのウィンドウを生成します。

cv2.namedWindow( winname[, flags] ) -> None
引数 説明
winname 表示するウィンドウのタイトルを指定します。
日本語を指定すると文字化けします。
flags ウィンドウのリサイズに関する設定を指定します。
cv2.WINDOW_NORMAL リサイズ可能なウィンドウを生成します。
表示されている画像はウィンドウサイズに合わせてリサイズされます。
cv2.WINDOW_AUTOSIZE 画像のサイズに合わせてウィンドウサイズを調整します。
ウィンドウのリサイズはできません。
他に cv2.WINDOW_FREERATIO, cv2.WINDOW_KEEPRATIO, cv2.WINDOW_GUI_NORMAL, cv2.WINDOW_GUI_EXPANDED の設定がありますが、少なくともWindows環境ではcv2.WINDOW_NORMALと同じ
(参考)WindowFlags
戻り値 なし

生成したウィンドウはdestroyWindow()関数で指定したウィンドウを削除するか、destroyAllWindows()関数で全てのウィンドウを削除するようにします。

(参考)

OpenCV: High-level GUI

destroyWindow()

ウィンドウタイトル名を指定してウィンドウを閉じます。

cv2.destroyWindow( winname ) -> None
引数 説明
winname 閉じるウィンドウのタイトルを指定します。
戻り値 なし

(参考)

OpenCV: High-level GUI

destroyAllWindows()

表示されているウィンドウ全てを閉じます。

cv2.destroyAllWindows() -> None

(参考)

OpenCV: High-level GUI

各種設定を行ったサンプルプログラム

import cv2

# 画像ファイルの読み込み(ファイルフォーマットのまま読み込み)
img1 = cv2.imread("Mandrill.bmp", cv2.IMREAD_UNCHANGED)
img2 = cv2.imread("Text.bmp", cv2.IMREAD_UNCHANGED)

# リサイズ可能なウィンドウの作成
cv2.namedWindow("Image1", cv2.WINDOW_NORMAL)
cv2.namedWindow("Image2", cv2.WINDOW_NORMAL)

# 画像の表示
cv2.imshow("Image1", img1)
cv2.imshow("Image2", img2)

# キー入力待ち(ここで画像が表示される)
cv2.waitKey()

# すべて全てのウィンドウを削除
cv2.destroyAllWindows()

(実行結果)

OpenCV-Python 画像ファイルを開く 画像の表示

コメント

タイトルとURLをコピーしました