Qt新函数

详细描述

image

此图解释了使用 Qt* GUI 实现的新功能。新的 GUI 提供了一个状态栏、一个工具栏和一个控制面板。控制面板可以附带跟踪条和按钮条。如果您看不到控制面板，请按 Ctrl+P 或右键单击任何 Qt 窗口并选择显示属性窗口。

• 要附带跟踪条，窗口名称参数必须为 NULL。
• 要附带按钮条，必须先创建一个按钮。如果附加到控制面板的最后一个条是按钮条，则新按钮将添加到最后一个按钮的右侧。如果附加到控制面板的最后一个条是跟踪条，或者控制面板为空，则会创建一个新的按钮条。然后，一个新的按钮将附加到它上面。

请参见下方用于生成该图的示例

#include "opencv2/highgui.hpp"
 
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;
}

类
结构体	cv::QtFont
	QtFont 仅适用于 Qt。参见 cv::fontQt。更多...

枚举
枚举	cv::QtButtonTypes {   cv::QT_PUSH_BUTTON = 0 ,   cv::QT_CHECKBOX = 1 ,   cv::QT_RADIOBOX = 2 ,   cv::QT_NEW_BUTTONBAR = 1024 }
	Qt “按钮”类型。更多...
枚举	cv::QtFontStyles {   cv::QT_STYLE_NORMAL = 0 ,   cv::QT_STYLE_ITALIC = 1 ,   cv::QT_STYLE_OBLIQUE = 2 }
	Qt 字体样式。更多...
枚举	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 字体粗细。更多...

函数
void	cv::addText (const Mat &img, const String &text, Point org, const QtFont &font)
	在图像上绘制文本。
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)
	在图像上绘制文本。
int	cv::createButton (const String &bar_name, ButtonCallback on_change, void *userdata=0, int type=QT_PUSH_BUTTON, bool initial_button_state=false)
	Attaches a button to the control panel.
void	cv::displayOverlay (const String &winname, const String &text, int delayms=0)
	在窗口图像上以叠加层形式显示文本，持续指定时间。
void	cv::displayStatusBar (const String &winname, const String &text, int delayms=0)
	在指定时间内在窗口状态栏上显示文本。
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)
	创建用于在图像上绘制文本的字体。
void	cv::loadWindowParameters (const String &windowName)
	加载指定窗口的参数。
void	cv::saveWindowParameters (const String &windowName)
	保存指定窗口的参数。
int	cv::startLoop (int(*pt2Func)(int argc, char *argv[]), int argc, char *argv[])
void	cv::stopLoop ()

枚举类型文档

QtButtonTypes

enum cv::QtButtonTypes

#include <opencv2/highgui.hpp>

Qt “按钮”类型。

枚举器
QT_PUSH_BUTTON  Python: cv.QT_PUSH_BUTTON	按钮。
QT_CHECKBOX  Python: cv.QT_CHECKBOX	复选框按钮。
QT_RADIOBOX  Python: cv.QT_RADIOBOX	单选框按钮。
QT_NEW_BUTTONBAR  Python: cv.QT_NEW_BUTTONBAR	按钮应创建一个新的按钮条。

QtFontStyles

enum cv::QtFontStyles

#include <opencv2/highgui.hpp>

Qt 字体样式。

枚举器
QT_STYLE_NORMAL  Python: cv.QT_STYLE_NORMAL	普通字体。
QT_STYLE_ITALIC  Python: cv.QT_STYLE_ITALIC	斜体字体。
QT_STYLE_OBLIQUE  Python: cv.QT_STYLE_OBLIQUE	倾斜字体。

QtFontWeights

enum cv::QtFontWeights

#include <opencv2/highgui.hpp>

Qt 字体粗细。

枚举器
QT_FONT_LIGHT  Python: cv.QT_FONT_LIGHT	粗细为 25。
QT_FONT_NORMAL  Python: cv.QT_FONT_NORMAL	粗细为 50。
QT_FONT_DEMIBOLD  Python: cv.QT_FONT_DEMIBOLD	粗细为 63。
QT_FONT_BOLD  Python: cv.QT_FONT_BOLD	粗细为 75。
QT_FONT_BLACK  Python: cv.QT_FONT_BLACK	粗细为 87。

函数文档

addText() [1/2]

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

Python
	cv.addText(	img, text, org, nameFont[, pointSize[, color[, weight[, style[, spacing]]]]]	) ->	无

#include <opencv2/highgui.hpp>

在图像上绘制文本。

函数 addText 使用特定字体 font（参见示例 cv::fontQt）在图像 img 上绘制文本。

参数

img	应绘制文本的 8 位 3 通道图像。
text	要写入图像的文本。
org	Point(x,y) 文本应在图像上开始的位置。
字体	用于绘制文本的字体。

addText() [2/2]

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 )

Python
	cv.addText(	img, text, org, nameFont[, pointSize[, color[, weight[, style[, spacing]]]]]	) ->	无

#include <opencv2/highgui.hpp>

在图像上绘制文本。

参数

img	应绘制文本的 8 位 3 通道图像。
text	要写入图像的文本。
org	Point(x,y) 文本应在图像上开始的位置。
nameFont	字体的名称。名称应与系统字体（如 Times*）的名称匹配。如果未找到字体，则使用默认字体。
pointSize	字体大小。如果未指定、等于零或为负，则字体磅值将设置为系统相关的默认值。通常为 12 磅。
color	BGRA 格式的字体颜色，其中 A = 255 表示完全透明。
weight	字体粗细。可用操作标志为：cv::QtFontWeights 您也可以指定一个正整数以进行更好的控制。
样式	字体样式。可用操作标志为：cv::QtFontStyles
间距	字符之间的间距。可以是负数或正数。

createButton()

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

#include <opencv2/highgui.hpp>

Attaches a button to the control panel.

函数 createButton 将一个按钮附加到控制面板。每个按钮都添加到上一个按钮右侧的按钮条中。如果没有事先附加任何内容到控制面板，或者如果附加到控制面板的最后一个元素是跟踪条，或者如果 QT_NEW_BUTTONBAR 标志被添加到类型中，则会创建一个新的按钮条。

下面是 cv::createButton 函数调用的各种示例：

createButton("",callbackButton);//创建一个名为“button 0”的按钮，它将调用 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);//在新行中创建一个按钮

参数

bar_name	按钮名称。
on_change	指向每次按钮状态改变时要调用的函数的指针。该函数应原型为 void Foo(int state,*void);。state 是按钮的当前状态。对于按钮，它可以是 -1，对于复选框/单选框，可以是 0 或 1。
用户数据	传递给回调函数的指针。
type	按钮的可选类型。可用类型为：(cv::QtButtonTypes)
initial_button_state	按钮的默认状态。用于复选框和单选框。其值可以是 0 或 1。（可选）

displayOverlay()

void cv::displayOverlay	(	const String &	窗口名称,
		const String &	text,
		int	delayms = 0 )

Python
	cv.displayOverlay(	winname, text[, delayms]	) ->	无

#include <opencv2/highgui.hpp>

在窗口图像上以叠加层形式显示文本，持续指定时间。

函数 displayOverlay 在窗口顶部显示有用的信息/提示，持续指定时间 delayms。该函数不修改窗口中显示的图像，即在指定延迟后，窗口的原始内容将恢复。

参数

窗口名称	窗口名称。
text	要写入窗口图像的叠加文本。
delayms	叠加文本显示的时长（毫秒）。如果在上一个叠加文本超时之前调用此函数，则计时器将重新启动并更新文本。如果此值为零，则文本永不消失。

displayStatusBar()

void cv::displayStatusBar	(	const String &	窗口名称,
		const String &	text,
		int	delayms = 0 )

Python
	cv.displayStatusBar(	winname, text[, delayms]	) ->	无

#include <opencv2/highgui.hpp>

在指定时间内在窗口状态栏上显示文本。

函数 displayStatusBar 在窗口顶部显示有用的信息/提示，持续指定时间 delayms。此信息显示在窗口状态栏上（窗口必须使用 CV_GUI_EXPANDED 标志创建）。

参数

窗口名称	窗口名称。
text	要写入窗口状态栏的文本。
delayms	显示文本的时长（毫秒）。如果在上一个文本超时之前调用此函数，则计时器将重新启动并更新文本。如果此值为零，则文本永不消失。

fontQt()

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 )

#include <opencv2/highgui.hpp>

创建用于在图像上绘制文本的字体。

函数 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 您也可以指定一个正整数以进行更好的控制。
样式	字体样式。可用操作标志为：cv::QtFontStyles
间距	字符之间的间距。可以是负数或正数。

loadWindowParameters()

void cv::loadWindowParameters

(

const String &

窗口名称

)

#include <opencv2/highgui.hpp>

加载指定窗口的参数。

函数 loadWindowParameters 加载窗口 windowName 的大小、位置、标志、跟踪条值、缩放和平移位置。

参数

窗口名称

窗口名称。

saveWindowParameters()

void cv::saveWindowParameters

(

const String &

窗口名称

)

#include <opencv2/highgui.hpp>

保存指定窗口的参数。

函数 saveWindowParameters 保存窗口 windowName 的大小、位置、标志、跟踪条值、缩放和平移位置。

参数

窗口名称

窗口名称。

startLoop()

int cv::startLoop	(	int(*	pt2Func )(int argc, char *argv[]),
		int	argc,
		char *	argv[] )

#include <opencv2/highgui.hpp>

stopLoop()

void cv::stopLoop

(

)

#include <opencv2/highgui.hpp>