Qt New Functions

クラス
struct	cv::QtFont
	QtFontQtでのみ使用可能です。参照cv::fontQt [【詳解】（英語］

列挙型
enum	cv::QtFontWeights { cv::QT_FONT_LIGHT = 25 , cv::QT_FONT_NORMAL = 50 , cv::QT_FONT_DEMIBOLD = 63 , cv::QT_FONT_BOLD = 75 , cv::QT_FONT_BLACK = 87 }
	Qtフォントの重さ[【詳解】（英語］
enum	cv::QtFontStyles { cv::QT_STYLE_NORMAL = 0 , cv::QT_STYLE_ITALIC = 1 , cv::QT_STYLE_OBLIQUE = 2 }
	Qtのフォントスタイル[【詳解】（英語］
enum	cv::QtButtonTypes { cv::QT_PUSH_BUTTON = 0 , cv::QT_CHECKBOX = 1 , cv::QT_RADIOBOX = 2 , cv::QT_NEW_BUTTONBAR = 1024 }
	Qtの「ボタン」タイプ[【詳解】（英語］

関数
CV_EXPORTS QtFont	cv::fontQt (const String &nameFont, int pointSize=-1, Scalar color=Scalar::all(0), int weight=QT_FONT_NORMAL, int style=QT_STYLE_NORMAL, int spacing=0)
	画像上にテキストを描画するためのフォントを作成します。[【詳解】（英語］
CV_EXPORTS void	cv::addText (const Mat &img, const String &text, Point org, const QtFont &font)
	画像上にテキストを描画します。[【詳解】（英語］
CV_EXPORTS_W void	cv::addText (const Mat &img, const String &text, Point org, const String &nameFont, int pointSize=-1, Scalar color=Scalar::all(0), int weight=QT_FONT_NORMAL, int style=QT_STYLE_NORMAL, int spacing=0)
	画像上にテキストを描画します。[【詳解】（英語］
CV_EXPORTS_W void	cv::displayOverlay (const String &winname, const String &text, int delayms=0)
	指定された時間、ウィンドウイメージ上にテキストをオーバーレイとして表示します。[【詳解】（英語］
CV_EXPORTS_W void	cv::displayStatusBar (const String &winname, const String &text, int delayms=0)
	指定された時間内にウィンドウのステータスバーにテキストを表示します。[【詳解】（英語］
CV_EXPORTS void	cv::saveWindowParameters (const String &windowName)
	指定されたウィンドウのパラメータを保存します。[【詳解】（英語］
CV_EXPORTS void	cv::loadWindowParameters (const String &windowName)
	指定されたウィンドウのパラメータを読み込みます．[【詳解】（英語］
CV_EXPORTS int	cv::startLoop (int(*pt2Func)(int argc, char *argv[]), int argc, char *argv[])
CV_EXPORTS void	cv::stopLoop ()
CV_EXPORTS int	cv::createButton (const String &bar_name, ButtonCallback on_change, void *userdata=0, int type=QT_PUSH_BUTTON, bool initial_button_state=false)
	コントロールパネルにボタンを追加します。[【詳解】（英語］

詳解

This figure explains new functionality implemented with Qt* GUI. The new GUI provides a statusbar, a toolbar, and a control panel. The control panel can have trackbars and buttonbars attached to it. If you cannot see the control panel, press Ctrl+P or right-click any Qt window and select Display properties window.

• To attach a trackbar, the window name parameter must be NULL.
• To attach a buttonbar, a button must be created. If the last bar attached to the control panel is a buttonbar, the new button is added to the right of the last button. If the last bar attached to the control panel is a trackbar, or the control panel is empty, a new buttonbar is created. Then, a new button is attached to it.

See below the example used to generate the figure:

int
main(int
argc,
char
*argv[])
{



int
value = 50;

int
value2 = 0;





namedWindow("main1",WINDOW_NORMAL);

namedWindow("main2",WINDOW_AUTOSIZE
|
WINDOW_GUI_NORMAL);

createTrackbar(
"track1",
"main1", &value, 255,  NULL);



String nameb1 =
"button1";

String nameb2 =
"button2";



createButton(nameb1,callbackButton,&nameb1,QT_CHECKBOX,1);

createButton(nameb2,callbackButton,NULL,QT_CHECKBOX,0);

createTrackbar(
"track2", NULL, &value2, 255, NULL);

createButton("button5",callbackButton1,NULL,QT_RADIOBOX,0);

createButton("button6",callbackButton2,NULL,QT_RADIOBOX,1);



setMouseCallback(
"main2",on_mouse,NULL );



Mat
img1 =
imread("files/flower.jpg");

VideoCapture
video;

video.open("files/hockey.avi");



Mat
img2,img3;



while(
waitKey(33) != 27 )

{

img1.convertTo(img2,-1,1,value);

video >> img3;



imshow("main1",img2);

imshow("main2",img3);

}



destroyAllWindows();



return
0;
}

@defgroup highgui_winrt WinRT support  This figure explains new functionality implemented with WinRT GUI. The new GUI provides an Image control, and a slider panel. Slider panel holds trackbars attached to it.  Sliders are attached below the image control. Every new slider is added below the previous one.  See below the example used to generate the figure: @code     void sample_app::MainPage::ShowWindow()     {         static cv::String windowName("sample");         cv::winrt_initContainer(this->cvContainer);         cv::namedWindow(windowName); // not required          cv::Mat image = cv::imread("Assets/sample.jpg");         cv::Mat converted = cv::Mat(image.rows, image.cols, CV_8UC4);         cv::cvtColor(image, converted, COLOR_BGR2BGRA);         cv::imshow(windowName, converted); // this will create window if it hasn't been created before          int state = 42;         cv::TrackbarCallback callback = [](int pos, void* userdata)         {             if (pos == 0) {                 cv::destroyWindow(windowName);             }         };         cv::TrackbarCallback callbackTwin = [](int pos, void* userdata)         {             if (pos >= 70) {                 cv::destroyAllWindows();             }         };         cv::createTrackbar("Sample trackbar", windowName, &state, 100, callback);         cv::createTrackbar("Twin brother", windowName, &state, 100, callbackTwin);     } @endcode  @defgroup highgui_c C API

列挙型詳解

QtButtonTypes

enum cv::QtButtonTypes

Qtの「ボタン」タイプ

列挙値
QT_PUSH_BUTTON	プッシュ ボタン。
QT_CHECKBOX	チェックボックス・ボタン。
QT_RADIOBOX	ラジオボックスボタン。
QT_NEW_BOTTONBAR	新しいボタンバーを作成するボタン。

QtFontStyles

enum cv::QtFontStyles

Qtのフォントスタイル

列挙値
qt_style_normal	通常のフォントです。
qt_style_italic	イタリック体のフォントです。
qt_style_oblique	斜体フォント。

QtFontWeights

enum cv::QtFontWeights

Qtフォントの重さ

列挙値
QT_FONT_LIGHT	25のウェイト
QT_FONT_NORMAL	50の重み
qt_font_demibold	重みは63です。
QT_FONT_BOLD	75%のウェイト
QT_FONT_BLACK	Weight of 87

関数詳解

addText() [1/2]

CV_EXPORTS void cv::addText	(	const Mat &	img,
		const String &	text,
		Point	org,
		const QtFont &	font
	)

画像上にテキストを描画します。

関数 addText は、以下を描画します。テキストを画像上に描画します。imgに，特定のフォントフォント(例cv::fontQt)

引数

img	8ビット3チャンネルのイメージ上にテキストを描画します．
text	画像上に書き込むテキストです。
org	画像上でテキストを開始する点(x,y)
font	テキストの描画に使用するフォント

addText() [2/2]

CV_EXPORTS_W void cv::addText	(	const Mat &	img,
		const String &	text,
		Point	org,
		const String &	nameFont,
		int	pointSize = -1,
		Scalar	color = Scalar::all(0),
		int	weight = QT_FONT_NORMAL ,
		int	style = QT_STYLE_NORMAL ,
		int	spacing = 0
	)

画像上にテキストを描画します。

引数

img	8ビット3チャンネルのイメージ上にテキストを描画します．
text	画像上に書き込むテキストです。
org	画像上でテキストを開始する点(x,y)
nameFont	フォントの名前です。この名前はシステムフォントの名前（Times*など）と一致する必要があります。フォントが見つからない場合は、デフォルトのフォントが使用されます。
pointSize	フォントのサイズ。指定されていないか、ゼロまたは負の値の場合、フォントのポイントサイズはシステム依存のデフォルト値に設定されます。一般的には12ポイントです。
color	フォントの色（BGRA） A = 255 は完全な透明です。
weight	フォントの太さ。利用可能な操作フラグは:cv::QtFontWeights制御しやすいように正の整数を指定することもできます。
style	フォントのスタイルを指定します。使用できる操作フラグは次のとおりです。cv::QtFontStyles
spacing	文字間の間隔を指定します。負または正の値を指定できます。

createButton()

CV_EXPORTS int cv::createButton	(	const String &	bar_name,
		ButtonCallback	on_change,
		void *	userdata = 0,
		int	type = QT_PUSH_BUTTON ,
		bool	initial_button_state = false
	)

コントロールパネルにボタンを追加します。

createButton関数は、コントロールパネルにボタンを追加します。各ボタンは、最後のボタンの右側にあるボタンバーに追加されます。コントロールパネルに何も取り付けられていなかった場合や、コントロールパネルに最後に取り付けられた要素がトラックバーだった場合、あるいは QT_NEW_BUTTONBAR フラグがタイプに追加されていた場合は、新しいボタンバーが作成されます。

以下に、関数呼び出しの例を示します。cv::createButton関数の呼び出しの例を以下に示します： :

createButton("",callbackButton);//create a push button "button 0", that will call callbackButton.


createButton("button2",callbackButton,NULL,QT_CHECKBOX,0);

createButton("button3",callbackButton,&value);

createButton("button5",callbackButton1,NULL,QT_RADIOBOX);

createButton("button6",callbackButton2,NULL,QT_PUSH_BUTTON,1);

createButton("button6",callbackButton2,NULL,QT_PUSH_BUTTON|QT_NEW_BUTTONBAR);// create a push button in a new row

引数

bar_name	ボタンの名前。
on_change	ボタンがその状態を変えるたびに呼び出される関数へのポインタ。この関数は、void Foo(int state,*void); のようにプロトタイプ化します。stateは，ボタンの現在の状態です．プッシュボタンであれば-1，チェック/ラジオボックスボタンであれば0または1です．
userdata	コールバック関数に渡されるポインターです．
type	オプションで，ボタンのタイプを指定します。利用可能なタイプは次のとおりです。(cv::QtButtonTypes)
initial_button_state	ボタンのデフォルトの状態です。checkbox と radiobox で使用します。その値は0または1です。 (オプション)

displayOverlay()

CV_EXPORTS_W void cv::displayOverlay	(	const String &	winname,
		const String &	text,
		int	delayms = 0
	)

指定された時間、ウィンドウイメージ上にテキストをオーバーレイとして表示します。

関数 displayOverlay は、有用な情報／ヒントを、一定時間、ウィンドウの上部に表示しますdelayms. この関数は、ウィンドウに表示されている画像を変更しません。つまり、指定された遅延時間の後には、ウィンドウの元の内容が復元されます。

引数

winname	ウィンドウの名前を指定します。
text	Overlay text ウィンドウの画像上にテキストを書き込む。
delayms	オーバーレイテキストが表示される期間（ミリ秒単位）を指定します．前回のオーバーレイテキストがタイムアウトする前にこの関数が呼び出された場合、タイマーが再起動され、テキストが更新されます。この値がゼロの場合、テキストは決して消えません。

displayStatusBar()

CV_EXPORTS_W void cv::displayStatusBar	(	const String &	winname,
		const String &	text,
		int	delayms = 0
	)

指定された時間内にウィンドウのステータスバーにテキストを表示します。

関数 displayStatusBar は、一定時間、ウィンドウの上部に有用な情報/ヒントを表示しますdelayms. この情報は，ウィンドウのステータスバーに表示されます（ウィンドウは CV_GUI_EXPANDED フラグ付きで作成されなければいけません）．

引数

winname	ウィンドウの名前を指定します。
text	ウィンドウのステータスバーに表示するテキスト。
delayms	テキストを表示する時間（ミリ秒単位）．前のテキストがタイムアウトする前にこの関数が呼ばれた場合，タイマーが再開され，テキストが更新されます．この値がゼロの場合、テキストは決して消えません。

fontQt()

CV_EXPORTS QtFont cv::fontQt	(	const String &	nameFont,
		int	pointSize = -1,
		Scalar	color = Scalar::all(0),
		int	weight = QT_FONT_NORMAL ,
		int	style = QT_STYLE_NORMAL ,
		int	spacing = 0
	)

画像上にテキストを描画するためのフォントを作成します。

関数 fontQt はcv::QtFontオブジェクトを作成します。これはcv::QtFontは putText とは互換性がありません。

この関数の基本的な使い方は以下の通りです。:

QtFont
font =
fontQt("Times");

addText( img1,
"Hello World !",
Point(50,50), font);

引数

nameFont	フォントの名前です。この名前はシステムフォントの名前（Times*など）と一致する必要があります。フォントが見つからない場合は、デフォルトのフォントが使用されます。
pointSize	フォントのサイズ。指定されていないか、ゼロまたは負の値の場合、フォントのポイントサイズはシステム依存のデフォルト値に設定されます。一般的には12ポイントです。
color	フォントの色を BGRA で表します．A = 255 は完全な透明です．簡単にするためにマクロ CV_RGB を使います。
weight	フォントの太さ。利用可能な操作フラグは:cv::QtFontWeights制御しやすいように正の整数を指定することもできます。
style	フォントのスタイルを指定します。使用できる操作フラグは次のとおりです。cv::QtFontStyles
spacing	文字間の間隔を指定します。負または正の値を指定できます。

loadWindowParameters()

CV_EXPORTS void cv::loadWindowParameters

(

const String &

windowName

)

指定されたウィンドウのパラメータを読み込みます．

関数 loadWindowParameters は，windowName のサイズ，位置，フラグ，トラックバーの値，ズームとパンの位置を読み込みます．

引数

windowName

ウィンドウの名前を指定します。

saveWindowParameters()

CV_EXPORTS void cv::saveWindowParameters

(

const String &

windowName

)

指定されたウィンドウのパラメータを保存します。

関数 saveWindowParametersは、ウィンドウ windowNameのサイズ、位置、フラグ、トラックバーの値、ズームとパンの位置を保存します。

引数

windowName

ウィンドウの名前を指定します。