高レベルGUI

トピック
	HighGUIウィンドウの作成・操作およびマウスイベントに関するフラグ
	OpenGL サポート
	Qt 新規関数

詳細説明

OpenCV はフルスケールのアプリケーションでの使用を想定して設計されており、機能が豊富な UI フレームワーク（Qt*、WinForms*、Cocoa* など）の中でも、あるいは UI をまったく使わずに利用することもできるが、機能を素早く試して結果を可視化したい場合もある。HighGUI モジュールはまさにそのために設計されている。

次のことを行う簡単なインターフェイスを提供する:

• 画像を表示し、その内容を「記憶」できるウィンドウを作成・操作する（OS からの再描画イベントを扱う必要がない）。
• ウィンドウにトラックバーを追加し、単純なマウスイベントやキーボードコマンドを処理する。

型定義
typedef void(*	cv::ButtonCallback) (int state, void *userdata)
	cv::createButton で作成されたボタン用のコールバック関数。
typedef void(*	cv::MouseCallback) (int event, int x, int y, int flags, void *userdata)
	マウスイベントのコールバック関数。 cv::setMouseCallback を参照。
typedef void(*	cv::OpenGlDrawCallback) (void *userdata)
	フレームごとに呼び出されるよう定義されたコールバック関数。cv::setOpenGlDrawCallback を参照。
typedef void(*	cv::TrackbarCallback) (int pos, void *userdata)
	トラックバーのコールバック関数。 cv::createTrackbar を参照。

関数
int	cv::createTrackbar (const String &trackbarname, const String &winname, int *value, int count, TrackbarCallback onChange=0, void *userdata=0)
	トラックバーを作成し、指定したウィンドウに追加する。
const std::string	cv::currentUIFramework ()
	使用するHighGUIバックエンド。
void	cv::destroyAllWindows ()
	すべてのHighGUIウィンドウを破棄する。
void	cv::destroyWindow (const String &winname)
	指定したウィンドウを破棄する。
int	cv::getMouseWheelDelta (int flags)
	マウスホイールイベントcv::EVENT_MOUSEWHEELおよびcv::EVENT_MOUSEHWHEELを処理する際に、マウスホイールの移動量を取得する。
int	cv::getTrackbarPos (const String &trackbarname, const String &winname)
	トラックバーの位置を返す。
Rect	cv::getWindowImageRect (const String &winname)
	ウィンドウ内の画像の矩形を返す。
double	cv::getWindowProperty (const String &winname, int prop_id)
	ウィンドウの引数を返す。
void	cv::imshow (const String &winname, InputArray mat)
	指定したウィンドウに画像を表示する。
void	cv::moveWindow (const String &winname, int x, int y)
	ウィンドウを指定した位置に移動する。
void	cv::namedWindow (const String &winname, int flags=WINDOW_AUTOSIZE)
	ウィンドウを作成する。
int	cv::pollKey ()
	押されたキーをポーリングする。
void	cv::resizeWindow (const String &winname, const cv::Size &size)
void	cv::resizeWindow (const String &winname, int width, int height)
	ウィンドウを指定したサイズにリサイズする。
Rect	cv::selectROI (const String &windowName, InputArray img, bool showCrosshair=true, bool fromCenter=false, bool printNotice=true)
	指定した画像上で ROI を選択できるようにする。
Rect	cv::selectROI (InputArray img, bool showCrosshair=true, bool fromCenter=false, bool printNotice=true)
void	cv::selectROIs (const String &windowName, InputArray img, std::vector< Rect > &boundingBoxes, bool showCrosshair=true, bool fromCenter=false, bool printNotice=true)
	指定した画像上で複数の ROI を選択できるようにする。
void	cv::setMouseCallback (const String &winname, MouseCallback onMouse, void *userdata=0)
	指定したウィンドウにマウスハンドラを設定する。
void	cv::setTrackbarMax (const String &trackbarname, const String &winname, int maxval)
	トラックバーの最大位置を設定する。
void	cv::setTrackbarMin (const String &trackbarname, const String &winname, int minval)
	トラックバーの最小位置を設定する。
void	cv::setTrackbarPos (const String &trackbarname, const String &winname, int pos)
	トラックバーの位置を設定する。
void	cv::setWindowProperty (const String &winname, int prop_id, double prop_value)
	ウィンドウの引数を動的に変更する。
void	cv::setWindowTitle (const String &winname, const String &title)
	ウィンドウのタイトルを更新する。
int	cv::startWindowThread ()
int	cv::waitKey (int delay=0)
	押されたキーを待つ。
int	cv::waitKeyEx (int delay=0)
	waitKey に似ているが、完全なキーコードを返す。

型定義詳解

ButtonCallback

typedef void(* cv::ButtonCallback) (int state, void *userdata)

#include <opencv2/highgui.hpp>

cv::createButton で作成されたボタンのコールバック関数。

引数

state	ボタンの現在の状態。プッシュボタンでは -1、チェックボックス／ラジオボタンでは 0 または 1 となる。
userdata	省略可能な引数。

MouseCallback

typedef void(* cv::MouseCallback) (int event, int x, int y, int flags, void *userdata)

#include <opencv2/highgui.hpp>

マウスイベントのコールバック関数。 cv::setMouseCallback を参照。

引数

event	cv::MouseEventTypes 定数のいずれか。
x	マウスイベントの x 座標。
y	マウスイベントの y 座標。
flags	cv::MouseEventFlags 定数のいずれか。
userdata	省略可能な引数。

OpenGlDrawCallback

typedef void(* cv::OpenGlDrawCallback) (void *userdata)

#include <opencv2/highgui.hpp>

毎フレーム呼び出されるように定義されたコールバック関数。 cv::setOpenGlDrawCallback を参照。

引数

userdata

省略可能な引数。

TrackbarCallback

typedef void(* cv::TrackbarCallback) (int pos, void *userdata)

#include <opencv2/highgui.hpp>

トラックバーのコールバック関数。 cv::createTrackbar を参照。

引数

pos	指定したトラックバーの現在位置。
userdata	省略可能な引数。

関数詳解

createTrackbar()

int cv::createTrackbar	(	const String &	trackbarname,
		const String &	winname,
		int *	value,
		int	count,
		TrackbarCallback	onChange = 0,
		void *	userdata = 0 )

#include <opencv2/highgui.hpp>

トラックバーを作成し、指定したウィンドウに取り付ける。

関数 createTrackbar は、指定した名前と範囲でトラックバー（スライダーまたは範囲コントロール）を作成し、トラックバーと同期する位置として変数 value を割り当て、トラックバーの位置が変化したときに呼び出されるコールバック関数 onChange を指定する。作成されたトラックバーは、指定したウィンドウ winname に表示される。

覚え書き

[Qt バックエンドのみ] トラックバーをコントロールパネルに取り付ける場合、winname は空でもよい。

各トラックバーのラベルをクリックすると、トラックバーの値を手動で編集できる。

引数

trackbarname	作成するトラックバーの名前。
winname	トラックバーを含むウィンドウの名前。
value	トラックバーによって変更される整数値へのポインタ。値ポインタを使用しない場合は nullptr を渡す。その場合、コールバック関数内でトラックバーの位置を手動で扱うこと。
count	トラックバーの最大位置。
onChange	スライダーの位置が変わるたびに呼び出される関数へのポインタ。この関数は void Foo(int, void*); というプロトタイプを持つ必要があり、第1引数はトラックバーの位置、第2引数はユーザーデータ（次の引数を参照）である。コールバックが nullptr の場合、コールバックは呼び出されないが、トラックバーの値は自動的に更新される。
userdata	コールバックに渡される省略可能なユーザーデータ。

覚え書き

value ポインタが nullptr の場合、トラックバーの位置は手動で管理する必要がある。実行時の警告を避けるため、希望する初期値を指定してコールバック関数を手動で呼び出すこと。

参照

アプリケーションへのトラックバーの追加

currentUIFramework()

const std::string cv::currentUIFramework

(

)

Python:
	cv.currentUIFramework(		) ->	retval

#include <opencv2/highgui.hpp>

使用しているHighGUIバックエンド。

この関数は使用しているHighGUIバックエンドの名前を返す。COCOA、GTK2/3、QT、WAYLAND、WIN32のいずれかである。利用可能なUIバックエンドがない場合は空文字列を返す。

destroyAllWindows()

void cv::destroyAllWindows

(

)

Python:
	cv.destroyAllWindows(		) ->	None

#include <opencv2/highgui.hpp>

すべてのHighGUIウィンドウを破棄する。

関数destroyAllWindowsは開いているすべてのHighGUIウィンドウを破棄する。

destroyWindow()

void cv::destroyWindow

(

const String &

winname

)

Python:
	cv.destroyWindow(	winname	) ->	None

#include <opencv2/highgui.hpp>

指定したウィンドウを破棄する。

関数destroyWindowは指定した名前のウィンドウを破棄する。

引数

winname

破棄するウィンドウの名前。

getMouseWheelDelta()

int cv::getMouseWheelDelta

(

int

flags

)

#include <opencv2/highgui.hpp>

マウスホイールイベント cv::EVENT_MOUSEWHEEL および cv::EVENT_MOUSEHWHEEL を処理する際に、マウスホイールの移動量(デルタ)を取得する。

スクロールホイールを備えた通常のマウスでは、デルタは120の倍数になる。値120はホイールの1ノッチ分の回転、すなわちアクションを起こすしきい値に相当し、デルタごとに1回そのようなアクションが発生する。自由に回転する高分解能ホイールを備えた高精度マウスでは、より小さい値が生成されることがある。

cv::EVENT_MOUSEWHEEL では、正の値と負の値はそれぞれ前方および後方へのスクロールを意味する。利用可能な環境における cv::EVENT_MOUSEHWHEEL では、正の値と負の値はそれぞれ右および左へのスクロールを意味する。

覚え書き

マウスホイールイベントは現在のところWindowsとCocoaでのみサポートされている。

引数

flags

マウスコールバックのフラグ引数。

getTrackbarPos()

int cv::getTrackbarPos	(	const String &	trackbarname,
		const String &	winname )

Python:
	cv.getTrackbarPos(	trackbarname, winname	) ->	retval

#include <opencv2/highgui.hpp>

トラックバーの位置を返す。

この関数は指定したトラックバーの現在位置を返す。

覚え書き

[Qtバックエンドのみ] トラックバーがコントロールパネルにアタッチされている場合、winnameは空にできる。

引数

trackbarname	トラックバーの名前。
winname	トラックバーの親となるウィンドウの名前。

getWindowImageRect()

Rect cv::getWindowImageRect

(

const String &

winname

)

Python:
	cv.getWindowImageRect(	winname	) ->	retval

#include <opencv2/highgui.hpp>

ウィンドウ内の画像の矩形を取得する。

関数getWindowImageRectは、画像描画領域のクライアントスクリーン座標、幅、高さを返す。

引数

winname

ウィンドウの名前。

参照

resizeWindow moveWindow

覚え書き

[Waylandバックエンドのみ] この関数はWaylandプロトコルの制約によりサポートされていない。

getWindowProperty()

double cv::getWindowProperty	(	const String &	winname,
		int	prop_id )

Python:
	cv.getWindowProperty(	winname, prop_id	) ->	retval

#include <opencv2/highgui.hpp>

ウィンドウの各種パラメータを取得する。

関数getWindowPropertyはウィンドウのプロパティを返す。

引数

winname	ウィンドウの名前。
prop_id	取得するウィンドウプロパティ。次の操作フラグが利用できる: (cv::WindowPropertyFlags)

参照

setWindowProperty

覚え書き

[Waylandバックエンドのみ] この関数はサポートされていない。

imshow()

void cv::imshow	(	const String &	winname,
		InputArray	mat )

Python:
	cv.imshow(	winname, mat	) ->	None

#include <opencv2/highgui.hpp>

指定したウィンドウに画像を表示する。

関数imshowは指定したウィンドウに画像を表示する。ウィンドウが cv::WINDOW_AUTOSIZE フラグで作成された場合、画像は元のサイズで表示されるが、それでも画面解像度による制限を受ける。それ以外の場合、画像はウィンドウに合わせてスケーリングされる。この関数はビット深度に応じて画像をスケーリングすることがある:

• 画像が8ビット符号なしの場合、そのまま表示される。
• 画像が16ビット符号なしの場合、ピクセルは256で除算される。すなわち、値の範囲[0,255*256]が[0,255]にマッピングされる。
• 画像が32ビットまたは64ビット浮動小数点の場合、ピクセル値は255倍される。すなわち、値の範囲[0,1]が[0,255]にマッピングされる。
• 32ビット整数画像は、必要な変換が一意に定まらないため、もはや処理されない。画像のコンテキストに応じた独自の前処理を用いて、8ビット符号なし行列に変換すること。

ウィンドウがOpenGLサポート付きで作成された場合、cv::imshow は入力として ogl::Buffer 、ogl::Texture2D 、cuda::GpuMat もサポートする。

この関数の前にウィンドウが作成されていない場合、cv::WINDOW_AUTOSIZE でウィンドウを作成するものとみなされる。

画面解像度より大きい画像を表示する必要がある場合、imshowの前に namedWindow("", WINDOW_NORMAL) を呼び出す必要がある。

覚え書き

この関数の後には cv::waitKey または cv::pollKey の呼び出しを続けるべきである。これは、指定した画像を実際に表示し、ウィンドウがマウスやキーボードのイベントに応答できるようにするために必要なGUIのハウスキーピング処理を行うためである。そうしないと画像は表示されず、ウィンドウがロックアップする可能性がある。例えば waitKey(0) は、いずれかのキーが押されるまでウィンドウを無限に表示する(画像表示に適している)。waitKey(25) はフレームを表示し、キー入力を約25ミリ秒待つ(動画を1フレームずつ表示するのに適している)。ウィンドウを削除するには cv::destroyWindow を使用する。

[Windowsバックエンドのみ] Ctrl+Cを押すと画像がクリップボードにコピーされる。Ctrl+Sを押すと画像を保存するダイアログが表示される。

[Wayland Backend Only] Supoorting format is extended.

• 画像が8ビット符号付きの場合、ピクセルは128だけバイアスされる。すなわち、値の範囲[-128,127]が[0,255]にマッピングされる。
• 画像が16ビット符号付きの場合、ピクセルは256で除算され128だけバイアスされる。すなわち、値の範囲[-32768,32767]が[0,255]にマッピングされる。

引数

winname	ウィンドウの名前。
mat	表示する画像。

moveWindow()

void cv::moveWindow	(	const String &	winname,
		int	x,
		int	y )

Python:
	cv.moveWindow(	winname, x, y	) ->	None

#include <opencv2/highgui.hpp>

ウィンドウを指定した位置に移動する。

引数

winname	ウィンドウの名前。
x	ウィンドウの新しい x 座標。
y	ウィンドウの新しい y 座標。

覚え書き

[Waylandバックエンドのみ] この関数はWaylandプロトコルの制約によりサポートされていない。

namedWindow()

void cv::namedWindow	(	const String &	winname,
		int	flags = WINDOW_AUTOSIZE )

Python:
	cv.namedWindow(	winname[, flags]	) ->	None

#include <opencv2/highgui.hpp>

ウィンドウを作成する。

関数namedWindowは、画像やトラックバーのプレースホルダとして使用できるウィンドウを作成する。作成されたウィンドウはその名前で参照される。

同じ名前のウィンドウがすでに存在する場合、この関数は何もしない。

ウィンドウを閉じ、関連するメモリを解放するには cv::destroyWindow または cv::destroyAllWindows を呼び出せる。単純なプログラムでは、終了時にアプリケーションのすべてのリソースとウィンドウがOSによって自動的に閉じられるため、これらの関数を実際に呼び出す必要はない。

覚え書き

Qt backend supports additional flags:

• WINDOW_NORMAL または WINDOW_AUTOSIZE: WINDOW_NORMAL ではウィンドウのサイズを変更できるのに対し、WINDOW_AUTOSIZE では表示する画像に合わせてウィンドウサイズが自動的に調整され(imshow を参照)、手動でウィンドウサイズを変更することはできない。
• WINDOW_FREERATIO または WINDOW_KEEPRATIO: WINDOW_FREERATIO では画像の縦横比を無視して調整するのに対し、WINDOW_KEEPRATIO では画像の縦横比を保持する。
• WINDOW_GUI_NORMAL または WINDOW_GUI_EXPANDED: WINDOW_GUI_NORMAL はステータスバーやツールバーなしでウィンドウを描画する従来の方式であるのに対し、WINDOW_GUI_EXPANDED は新しく拡張されたGUIである。デフォルトでは flags == WINDOW_AUTOSIZE | WINDOW_KEEPRATIO | WINDOW_GUI_EXPANDED となる。

引数

winname	ウィンドウ識別子として使用できる、ウィンドウのキャプションに表示される名前。
flags	ウィンドウのフラグ。サポートされているフラグは次のとおり: (cv::WindowFlags)

pollKey()

int cv::pollKey

(

)

Python:
	cv.pollKey(		) ->	retval

#include <opencv2/highgui.hpp>

押されたキーをポーリングする。

関数pollKeyは待機せずにキーイベントをポーリングする。押されたキーのコードを返すか、前回の呼び出し以降にキーが押されていない場合は-1を返す。キーが押されるまで待機するには waitKey を使用する。

覚え書き

関数 waitKey と pollKey は、HighGUIにおいてGUIイベントを取得・処理できる唯一のメソッドである。そのため、イベント処理を担う環境内でHighGUIが使用される場合を除き、通常のイベント処理のためにはこれらのいずれかを定期的に呼び出す必要がある。

この関数は、少なくとも1つのHighGUIウィンドウが作成され、そのウィンドウがアクティブな場合にのみ動作する。複数のHighGUIウィンドウがある場合は、そのいずれかがアクティブであればよい。

resizeWindow() [1/2]

void cv::resizeWindow	(	const String &	winname,
		const cv::Size &	size )

Python:
	cv.resizeWindow(	winname, width, height	) ->	None
	cv.resizeWindow(	winname, size	) ->	None

#include <opencv2/highgui.hpp>

これは利便性のために提供されているオーバーロードされたメンバ関数である。上記の関数とは、受け取る引数のみが異なる。

引数

winname	ウィンドウ名。
size	ウィンドウの新しいサイズ。

resizeWindow() [2/2]

void cv::resizeWindow	(	const String &	winname,
		int	width,
		int	height )

Python:
	cv.resizeWindow(	winname, width, height	) ->	None
	cv.resizeWindow(	winname, size	) ->	None

#include <opencv2/highgui.hpp>

ウィンドウを指定したサイズにリサイズする。

覚え書き

指定するウィンドウサイズは画像領域に対するものである。ツールバーは含まれない。リサイズできるのは cv::WINDOW_AUTOSIZE フラグなしで作成されたウィンドウのみである。

引数

winname	ウィンドウ名。
width	ウィンドウの新しい幅。
height	ウィンドウの新しい高さ。

selectROI() [1/2]

Rect cv::selectROI	(	const String &	windowName,
		InputArray	img,
		bool	showCrosshair = true,
		bool	fromCenter = false,
		bool	printNotice = true )

Python:
	cv.selectROI(	windowName, img[, showCrosshair[, fromCenter[, printNotice]]]	) ->	retval
	cv.selectROI(	img[, showCrosshair[, fromCenter[, printNotice]]]	) ->	retval

#include <opencv2/highgui.hpp>

指定した画像上でユーザがROIを選択できるようにする。

この関数はウィンドウを作成し、ユーザがマウスを使ってROIを選択できるようにする。操作方法: 選択を確定するには space または enter を、選択をキャンセルするにはキー c を使用する(関数はゼロの cv::Rect を返す)。

引数

windowName	選択処理を表示するウィンドウの名前。
img	ROI を選択する画像。
showCrosshair	true の場合、選択矩形の十字線が表示される。
fromCenter	true の場合、選択の中心が初期のマウス位置に一致する。そうでない場合は、選択矩形の角が初期のマウス位置に対応する。
printNotice	true の場合、ROI の選択またはキャンセルを促すメッセージがコンソールに表示される。

戻り値

選択されたROI、または選択がキャンセルされた場合は空の矩形。

覚え書き

この関数は cv::setMouseCallback(windowName, ...) を使って、指定したウィンドウに独自のマウスコールバックを設定する。処理が終了すると、使用したウィンドウには空のコールバックが設定される。

selectROI() [2/2]

Rect cv::selectROI	(	InputArray	img,
		bool	showCrosshair = true,
		bool	fromCenter = false,
		bool	printNotice = true )

Python:
	cv.selectROI(	windowName, img[, showCrosshair[, fromCenter[, printNotice]]]	) ->	retval
	cv.selectROI(	img[, showCrosshair[, fromCenter[, printNotice]]]	) ->	retval

#include <opencv2/highgui.hpp>

これは利便性のために提供されているオーバーロードされたメンバ関数である。上記の関数とは、受け取る引数のみが異なる。

selectROIs()

void cv::selectROIs	(	const String &	windowName,
		InputArray	img,
		std::vector< Rect > &	boundingBoxes,
		bool	showCrosshair = true,
		bool	fromCenter = false,
		bool	printNotice = true )

Python:
	cv.selectROIs(	windowName, img[, showCrosshair[, fromCenter[, printNotice]]]	) ->	boundingBoxes

#include <opencv2/highgui.hpp>

指定した画像上でユーザが複数のROIを選択できるようにする。

この関数はウィンドウを作成し、ユーザがマウスを使って複数のROIを選択できるようにする。操作方法: 現在の選択を確定して新しい選択を開始するには space または enter を、複数ROI選択処理を終了するには esc を使用する。

引数

windowName	選択処理を表示するウィンドウの名前。
img	ROI を選択する画像。
boundingBoxes	選択された ROI。
showCrosshair	true の場合、選択矩形の十字線が表示される。
fromCenter	true の場合、選択の中心が初期のマウス位置に一致する。そうでない場合は、選択矩形の角が初期のマウス位置に対応する。
printNotice	true の場合、ROI の選択またはキャンセルを促すメッセージがコンソールに表示される。

覚え書き

この関数は cv::setMouseCallback(windowName, ...) を使って、指定したウィンドウに独自のマウスコールバックを設定する。処理が終了すると、使用したウィンドウには空のコールバックが設定される。

setMouseCallback()

void cv::setMouseCallback	(	const String &	winname,
		MouseCallback	onMouse,
		void *	userdata = 0 )

#include <opencv2/highgui.hpp>

指定したウィンドウにマウスハンドラを設定する。

引数

winname	ウィンドウの名前。
onMouse	マウスイベントのコールバック関数。コールバックの指定方法と使用方法については OpenCV のサンプルを参照。
userdata	コールバックに渡される省略可能な引数。

setTrackbarMax()

void cv::setTrackbarMax	(	const String &	trackbarname,
		const String &	winname,
		int	maxval )

Python:
	cv.setTrackbarMax(	trackbarname, winname, maxval	) ->	None

#include <opencv2/highgui.hpp>

トラックバーの最大位置を設定する。

この関数は、指定したウィンドウ内の指定したトラックバーの最大位置を設定する。

覚え書き

[Qtバックエンドのみ] トラックバーがコントロールパネルにアタッチされている場合、winnameは空にできる。

引数

trackbarname	トラックバーの名前。
winname	トラックバーの親となるウィンドウの名前。
maxval	新しい最大位置。

setTrackbarMin()

void cv::setTrackbarMin	(	const String &	trackbarname,
		const String &	winname,
		int	minval )

Python:
	cv.setTrackbarMin(	trackbarname, winname, minval	) ->	None

#include <opencv2/highgui.hpp>

トラックバーの最小位置を設定する。

この関数は、指定したウィンドウ内の指定したトラックバーの最小位置を設定する。

覚え書き

[Qtバックエンドのみ] トラックバーがコントロールパネルにアタッチされている場合、winnameは空にできる。

引数

trackbarname	トラックバーの名前。
winname	トラックバーの親となるウィンドウの名前。
minval	新しい最小位置。

setTrackbarPos()

void cv::setTrackbarPos	(	const String &	trackbarname,
		const String &	winname,
		int	pos )

Python:
	cv.setTrackbarPos(	trackbarname, winname, pos	) ->	None

#include <opencv2/highgui.hpp>

トラックバーの位置を設定する。

この関数は、指定したウィンドウ内の指定したトラックバーの位置を設定する。

覚え書き

[Qtバックエンドのみ] トラックバーがコントロールパネルにアタッチされている場合、winnameは空にできる。

引数

trackbarname	トラックバーの名前。
winname	トラックバーの親となるウィンドウの名前。
pos	新しい位置。

setWindowProperty()

void cv::setWindowProperty	(	const String &	winname,
		int	prop_id,
		double	prop_value )

Python:
	cv.setWindowProperty(	winname, prop_id, prop_value	) ->	None

#include <opencv2/highgui.hpp>

ウィンドウのパラメータを動的に変更する。

関数setWindowPropertyはウィンドウのプロパティを変更できるようにする。

引数

winname	ウィンドウの名前。
prop_id	編集するウィンドウプロパティ。サポートされている操作フラグは次のとおり: (cv::WindowPropertyFlags)
prop_value	ウィンドウプロパティの新しい値。サポートされているフラグは次のとおり: (cv::WindowFlags)

覚え書き

[Waylandバックエンドのみ] この関数はサポートされていない。

setWindowTitle()

void cv::setWindowTitle	(	const String &	winname,
		const String &	title )

Python:
	cv.setWindowTitle(	winname, title	) ->	None

#include <opencv2/highgui.hpp>

ウィンドウのタイトルを更新する。

引数

winname	ウィンドウの名前。
title	新しいタイトル。

startWindowThread()

int cv::startWindowThread

(

)

Python:
	cv.startWindowThread(		) ->	retval

#include <opencv2/highgui.hpp>

waitKey()

int cv::waitKey

(

int

delay = 0

)

Python:
	cv.waitKey(	[, delay]	) ->	retval

#include <opencv2/highgui.hpp>

押されたキーを待機する。

関数waitKeyは、(\(\texttt{delay}\leq 0\) のとき)キーイベントを無限に待機するか、delayが正の場合はdelayミリ秒だけ待機する。OSにはスレッド切り替えの最小時間があるため、この関数は正確にdelayミリ秒待機するのではなく、そのときコンピュータ上で動作している他の処理に応じて、少なくともdelayミリ秒は待機する。押されたキーのコードを返すか、指定した時間が経過する前にキーが押されなかった場合は-1を返す。キー入力を確認するが待機はしない場合は pollKey を使用する。

覚え書き

関数 waitKey と pollKey は、HighGUIにおいてGUIイベントを取得・処理できる唯一のメソッドである。そのため、イベント処理を担う環境内でHighGUIが使用される場合を除き、通常のイベント処理のためにはこれらのいずれかを定期的に呼び出す必要がある。

この関数は、少なくとも1つのHighGUIウィンドウが作成され、そのウィンドウがアクティブな場合にのみ動作する。複数のHighGUIウィンドウがある場合は、そのいずれかがアクティブであればよい。

引数

delay

ミリ秒単位の遅延。0 は「無限に待つ」ことを意味する特別な値である。

waitKeyEx()

int cv::waitKeyEx

(

int

delay = 0

)

Python:
	cv.waitKeyEx(	[, delay]	) ->	retval

#include <opencv2/highgui.hpp>

waitKey と同様だが、完全なキーコードを返す。

覚え書き

キーコードは実装依存であり、使用するバックエンド(QT/GTK/Win32など)に依存する。