当前位置：首页 > news >正文

OpenCV GUI常用函数详解

news 2026/2/9 15:39:37

在OpenCV的High_level GUI模组中有很多GUI函数，下面介绍几个常用的函数。

图像显示窗口相关函数

生成图像显示窗口函数nameWindow()

nameWindow()函数的原型如下：

函数用以创建一个给定名的图像显示窗口（后面简单叫做图像窗口），该窗口可以放置滑动条等控件，还可响应鼠标事件。

函数参数：

winname 图像窗口名

flags 窗口类型标志，有一下几种：

销毁图像窗口函数

销毁图像窗口函数有两个，其原型如下：

该函数销毁所有HighGUI 窗口。

该函数销毁指定窗口名的HighGUI 窗口。

获取图像窗口矩形函数getWindowImageRect()

getWindowImageRect()函数的原型如下:

该函数返回指定名窗口客户端屏幕坐标、图像渲染区域的宽度和高度组成的矩形。

获取图像窗口属性函数getWindowProperty

getWindowProperty()的原型如下:

该函数返回指定窗口属性。

函数参数：

Winname 窗口名称

prop_id 窗口属性标记, 有以下几种：

移动图像窗口函数moveWindow()

moveWindow()函数的原型如下:

该函数将指定图像窗口移动到指定位置。

函数参数：
winname 窗口名

X 新位置的横坐标

Y 新位置的纵坐标。

调整图像窗口图像显示区域大函数resizeWindow()

resizeWindow()函数的原型如下：

该函数功能是指定窗口图像区域大小,不包含工具条区域。

函数参数：

winname 窗口名

width 图像显示区域宽度

height 图像显示区域高度

选择感兴趣区域函数selectROI()

selectROI()有两个原型函数，如下：

该函数实现选取图像窗口中显示图像的ROI区域，该函数使用cv:：setMouseCallback（windowName，…）为指定窗口设置自己的鼠标回调。工作完成后，将为已使用的窗口设置一个空回调。

函数参数：

winName 图像窗口名

img 输入图像

showCrosshair 如果为真，显示选择矩形的十字准线

fromCenter 如果为真，选择ROI中心与初始鼠标位置匹配。在相反的情况下，选择矩形的一角将对应于初始鼠标位置。

printNotice 如果为真，将在控制台中打印选择ROI或取消选择的通知。

设置窗口属性函数setWindowProperty()

setWindowProperty()函数的原型如下:

setWindowProperty函数允许动态更改窗口的属性。

函数参数:

winname 窗口名

prop_id 属性id,可为以下几种之一:

prop_value 窗口属性新值,可以为以下几种之一:

函数参数：

winname 窗口名称

title 新的名称

启动窗口线程函数startWindowThread()

startWindowThread()原型如下：

在窗口中显示图像函数imshow()

imshow()函数的原型如下：

函数参数：

winname 窗口名

mat 含图像的mat对象。

延时等待按键输入函数waitKey()

waitKey()的原型如下：

如果delay小于或等于0，将无限期等待，直到有按键输入，才停止等待执行该包含函数语句后名程序。如果delay大于0，等待时间将以毫秒计，但等待时间并不是精确的。如果在等待时间内有按键输入，将会停止等待，执行后面程序，但这并非真正意义的立即停止，如果需要真正意义的立即执行后面程序，可使用pollKey()函数。

与鼠标操作相关的函数

获取鼠标滚轮运动增量函数getMouseWheelDeldlta()

getMouseWheelDeldlta()的原型如下：

对于带有滚轮的普通小鼠，delta将是120的倍数。值120对应于滚轮的一个凹口旋转或要采取行动的阈值，并且每个增量都应该发生一个这样的行动。一些具有更高分辨率的高精度鼠标自由旋转的轮子可能会产生更小的值。

参数 flags 鼠标回调标志参数。

鼠标事件相应函数类型MouseCallback

MouseCallback的定义如下：

参数：

envent 鼠标事件，鼠标事件有以下几种：

x 鼠标指针位置横坐标x

y 鼠标指针位置纵坐标x

flags 鼠标事件标志，可以是一下几种之一：

userdata 这是一个可选参数。

设置鼠标事件响应函数setMouseCallback()

setMouseCallback()函数的原型如下：

函数参数：

winname 图像窗口名

onMouse 鼠标事件相应函数名

userdata 传递给回调函数的可选参数。

与滑动条相关的函数

生成滑动条函数createTrackbar()

createTrackbar()的原型如下:

函数参数：

trackbarname 生成滑动条名称

winname 窗口名

value 指向整数变量的可选指针，其值反映滑块的位置。创建后，滑块位置由此变量定义。

count 滑块的最大位置。最小位置始终为0。

onChange 指向每次滑块改变位置时要调用的函数的指针。这个函数应该被原型化为void Foo（int，void*），其中第一个参数是轨迹条位置，第二个参数是用户数据（见下一个参数）。如果回调是NULL指针，则不调用回调，只更新值。每次滑块改变位置时要调用的函数需为TrackbarCallback 类型，TrackbarCallback的定义如下：

UserData 按原样传递给回调函数的用户数据。它可用于处理轨迹栏事件，而无需使用全局变量。

获取滑动条游标位置函数getTrackbarPos()

getTrackbarPos()的原型如下：

改函数的返回值即为滑动条游标的位置。

函数参数：

trackbarname 滑块条名

winname 窗口名称

设置滑块条最大值位置函数setTrackbarMax()

setTrackbarMax()的原型如下：

函数参数:

trackbarname 滑块条名

winname 窗口名

maxVal 欲设置的最大值

设置滑块条最小值位置函数setTrackbarMin()

setTrackbarMin()的原型如下：

函数参数：

trackbarname 滑块条名

winname 窗口名

minVal 欲设置的最小值

示例程序

新建一个控制台应用程序来演示OpenCV GUI函数的用法。程序代码如下：

#include <opencv2/opencv.hpp>
#include <iostream>using namespace cv;
using namespace std;int main()
{Mat src1 = imread("1.webp");if (src1.empty()){cout << "Cann't open image!" << endl;return -1;}namedWindow("Src", WINDOW_AUTOSIZE);  //demo namedWindow()imshow("Src", src1);                 //demo imshow()Rect rec = getWindowImageRect("Src"); //demo getWindowImageRectcout << rec << endl;double dbData = getWindowProperty("Src", WND_PROP_AUTOSIZE); //demo getWindowProperty()cout << dbData << endl;dbData = getWindowProperty("Src", WND_PROP_FULLSCREEN);     //demo getWindowProperty()cout << dbData << endl;waitKey(0);destroyWindow("Src");               //demo destroyWindownamedWindow("Src", WINDOW_NORMAL);  //demo namedWindow()setWindowProperty("Src", WND_PROP_FULLSCREEN,WINDOW_FULLSCREEN);//demosetWindowPropertydbData = getWindowProperty("Src", WND_PROP_AUTOSIZE);     //demo getWindowProperty()cout << dbData << endl;imshow("Src", src1);                 waitKey(0);                          //demo waitKey()return 0;
}

试运行, 结果如下;

按任意键后，结果如下：

图片满屏显示，控制台输出如下：

注释掉上面程序中main函数中的前部分，加入新代码来演示与鼠标相关的函数用法，并在main函数的前面，添加一个 MouseCallback函数，代如下：

#include <opencv2/opencv.hpp>
#include <iostream>using namespace cv;
using namespace std;static void onMouse(int event, int x, int y, int flags, void* userIuput) //demo MouseCallback function
{Mat* pimg = (Mat*)userIuput;Rect rec(0,0,0,0);Mat roi;switch (event){   case EVENT_LBUTTONDOWN:circle(*pimg, Point(x, y), 20, Scalar(0, 0, 255), 2); rec = selectROI("Src", *pimg); //demo selectRoIroi = (*pimg)(rec);moveWindow("Src", x, y); //demo mmovebreak;case EVENT_MOUSEWHEEL:int mouseDelta = getMouseWheelDelta(flags); //demo getMouseWheelDeltamouseDelta /= 12;rec = getWindowImageRect("Src");  //demo getWindowImageRectresizeWindow("Src", Size(rec.width + mouseDelta, rec.height + mouseDelta)); //demo resizeWindowbreak;}imshow("Src", *pimg);if(!roi.empty())imshow("Roi", *pimg);
}int main()
{/*Mat src1 = imread("1.webp");if (src1.empty()){cout << "Cann't open image!" << endl;return -1;}namedWindow("Src", WINDOW_AUTOSIZE);  //test namedWindow()imshow("Src", src1);                 //test imshow()Rect rec = getWindowImageRect("Src"); //test getWindowImageRectcout << rec << endl;double dbData = getWindowProperty("Src", WND_PROP_AUTOSIZE); //test getWindowProperty()cout << dbData << endl;dbData = getWindowProperty("Src", WND_PROP_FULLSCREEN);     //test getWindowProperty()cout << dbData << endl;waitKey(0);destroyWindow("Src");               //test destroyWindownamedWindow("Src", WINDOW_NORMAL);  //test namedWindow()setWindowProperty("Src", WND_PROP_FULLSCREEN, WINDOW_FULLSCREEN); //test setWindowPropertydbData = getWindowProperty("Src", WND_PROP_AUTOSIZE);     //test getWindowProperty()cout << dbData << endl;imshow("Src", src1);*///demo mosue functionMat src1 = imread("1.webp");if (src1.empty()){cout << "Cann't open image!" << endl;return -1;}namedWindow("Src", WINDOW_AUTOSIZE);  //test namedWindow()imshow("Src", src1);                 //test imshow()setMouseCallback("Src", onMouse, &src1); //demo setMouseCallbackwaitKey(0);                          //test waitKey()return 0;
}

试运行，结果如下：

在右眼位置，点击鼠标，结果如下：