highgui.hpp 35 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842
  1. /*M///////////////////////////////////////////////////////////////////////////////////////
  2. //
  3. // IMPORTANT: READ BEFORE DOWNLOADING, COPYING, INSTALLING OR USING.
  4. //
  5. // By downloading, copying, installing or using the software you agree to this license.
  6. // If you do not agree to this license, do not download, install,
  7. // copy or use the software.
  8. //
  9. //
  10. // License Agreement
  11. // For Open Source Computer Vision Library
  12. //
  13. // Copyright (C) 2000-2008, Intel Corporation, all rights reserved.
  14. // Copyright (C) 2009, Willow Garage Inc., all rights reserved.
  15. // Third party copyrights are property of their respective owners.
  16. //
  17. // Redistribution and use in source and binary forms, with or without modification,
  18. // are permitted provided that the following conditions are met:
  19. //
  20. // * Redistribution's of source code must retain the above copyright notice,
  21. // this list of conditions and the following disclaimer.
  22. //
  23. // * Redistribution's in binary form must reproduce the above copyright notice,
  24. // this list of conditions and the following disclaimer in the documentation
  25. // and/or other materials provided with the distribution.
  26. //
  27. // * The name of the copyright holders may not be used to endorse or promote products
  28. // derived from this software without specific prior written permission.
  29. //
  30. // This software is provided by the copyright holders and contributors "as is" and
  31. // any express or implied warranties, including, but not limited to, the implied
  32. // warranties of merchantability and fitness for a particular purpose are disclaimed.
  33. // In no event shall the Intel Corporation or contributors be liable for any direct,
  34. // indirect, incidental, special, exemplary, or consequential damages
  35. // (including, but not limited to, procurement of substitute goods or services;
  36. // loss of use, data, or profits; or business interruption) however caused
  37. // and on any theory of liability, whether in contract, strict liability,
  38. // or tort (including negligence or otherwise) arising in any way out of
  39. // the use of this software, even if advised of the possibility of such damage.
  40. //
  41. //M*/
  42. #ifndef OPENCV_HIGHGUI_HPP
  43. #define OPENCV_HIGHGUI_HPP
  44. #include "opencv2/core.hpp"
  45. #ifdef HAVE_OPENCV_IMGCODECS
  46. #include "opencv2/imgcodecs.hpp"
  47. #endif
  48. #ifdef HAVE_OPENCV_VIDEOIO
  49. #include "opencv2/videoio.hpp"
  50. #endif
  51. /**
  52. @defgroup highgui High-level GUI
  53. While OpenCV was designed for use in full-scale applications and can be used within functionally
  54. rich UI frameworks (such as Qt\*, WinForms\*, or Cocoa\*) or without any UI at all, sometimes there
  55. it is required to try functionality quickly and visualize the results. This is what the HighGUI
  56. module has been designed for.
  57. It provides easy interface to:
  58. - Create and manipulate windows that can display images and "remember" their content (no need to
  59. handle repaint events from OS).
  60. - Add trackbars to the windows, handle simple mouse events as well as keyboard commands.
  61. @{
  62. @defgroup highgui_opengl OpenGL support
  63. @defgroup highgui_qt Qt New Functions
  64. ![image](pics/qtgui.png)
  65. This figure explains new functionality implemented with Qt\* GUI. The new GUI provides a statusbar,
  66. a toolbar, and a control panel. The control panel can have trackbars and buttonbars attached to it.
  67. If you cannot see the control panel, press Ctrl+P or right-click any Qt window and select **Display
  68. properties window**.
  69. - To attach a trackbar, the window name parameter must be NULL.
  70. - To attach a buttonbar, a button must be created. If the last bar attached to the control panel
  71. is a buttonbar, the new button is added to the right of the last button. If the last bar
  72. attached to the control panel is a trackbar, or the control panel is empty, a new buttonbar is
  73. created. Then, a new button is attached to it.
  74. See below the example used to generate the figure:
  75. @code
  76. int main(int argc, char *argv[])
  77. {
  78. int value = 50;
  79. int value2 = 0;
  80. namedWindow("main1",WINDOW_NORMAL);
  81. namedWindow("main2",WINDOW_AUTOSIZE | CV_GUI_NORMAL);
  82. createTrackbar( "track1", "main1", &value, 255, NULL);
  83. String nameb1 = "button1";
  84. String nameb2 = "button2";
  85. createButton(nameb1,callbackButton,&nameb1,QT_CHECKBOX,1);
  86. createButton(nameb2,callbackButton,NULL,QT_CHECKBOX,0);
  87. createTrackbar( "track2", NULL, &value2, 255, NULL);
  88. createButton("button5",callbackButton1,NULL,QT_RADIOBOX,0);
  89. createButton("button6",callbackButton2,NULL,QT_RADIOBOX,1);
  90. setMouseCallback( "main2",on_mouse,NULL );
  91. Mat img1 = imread("files/flower.jpg");
  92. VideoCapture video;
  93. video.open("files/hockey.avi");
  94. Mat img2,img3;
  95. while( waitKey(33) != 27 )
  96. {
  97. img1.convertTo(img2,-1,1,value);
  98. video >> img3;
  99. imshow("main1",img2);
  100. imshow("main2",img3);
  101. }
  102. destroyAllWindows();
  103. return 0;
  104. }
  105. @endcode
  106. @defgroup highgui_winrt WinRT support
  107. This figure explains new functionality implemented with WinRT GUI. The new GUI provides an Image control,
  108. and a slider panel. Slider panel holds trackbars attached to it.
  109. Sliders are attached below the image control. Every new slider is added below the previous one.
  110. See below the example used to generate the figure:
  111. @code
  112. void sample_app::MainPage::ShowWindow()
  113. {
  114. static cv::String windowName("sample");
  115. cv::winrt_initContainer(this->cvContainer);
  116. cv::namedWindow(windowName); // not required
  117. cv::Mat image = cv::imread("Assets/sample.jpg");
  118. cv::Mat converted = cv::Mat(image.rows, image.cols, CV_8UC4);
  119. cv::cvtColor(image, converted, COLOR_BGR2BGRA);
  120. cv::imshow(windowName, converted); // this will create window if it hasn't been created before
  121. int state = 42;
  122. cv::TrackbarCallback callback = [](int pos, void* userdata)
  123. {
  124. if (pos == 0) {
  125. cv::destroyWindow(windowName);
  126. }
  127. };
  128. cv::TrackbarCallback callbackTwin = [](int pos, void* userdata)
  129. {
  130. if (pos >= 70) {
  131. cv::destroyAllWindows();
  132. }
  133. };
  134. cv::createTrackbar("Sample trackbar", windowName, &state, 100, callback);
  135. cv::createTrackbar("Twin brother", windowName, &state, 100, callbackTwin);
  136. }
  137. @endcode
  138. @defgroup highgui_c C API
  139. @}
  140. */
  141. ///////////////////////// graphical user interface //////////////////////////
  142. namespace cv
  143. {
  144. //! @addtogroup highgui
  145. //! @{
  146. //! Flags for cv::namedWindow
  147. enum WindowFlags {
  148. WINDOW_NORMAL = 0x00000000, //!< the user can resize the window (no constraint) / also use to switch a fullscreen window to a normal size.
  149. WINDOW_AUTOSIZE = 0x00000001, //!< the user cannot resize the window, the size is constrainted by the image displayed.
  150. WINDOW_OPENGL = 0x00001000, //!< window with opengl support.
  151. WINDOW_FULLSCREEN = 1, //!< change the window to fullscreen.
  152. WINDOW_FREERATIO = 0x00000100, //!< the image expends as much as it can (no ratio constraint).
  153. WINDOW_KEEPRATIO = 0x00000000, //!< the ratio of the image is respected.
  154. WINDOW_GUI_EXPANDED=0x00000000, //!< status bar and tool bar
  155. WINDOW_GUI_NORMAL = 0x00000010, //!< old fashious way
  156. };
  157. //! Flags for cv::setWindowProperty / cv::getWindowProperty
  158. enum WindowPropertyFlags {
  159. WND_PROP_FULLSCREEN = 0, //!< fullscreen property (can be WINDOW_NORMAL or WINDOW_FULLSCREEN).
  160. WND_PROP_AUTOSIZE = 1, //!< autosize property (can be WINDOW_NORMAL or WINDOW_AUTOSIZE).
  161. WND_PROP_ASPECT_RATIO = 2, //!< window's aspect ration (can be set to WINDOW_FREERATIO or WINDOW_KEEPRATIO).
  162. WND_PROP_OPENGL = 3, //!< opengl support.
  163. WND_PROP_VISIBLE = 4, //!< checks whether the window exists and is visible
  164. WND_PROP_TOPMOST = 5 //!< property to toggle normal window being topmost or not
  165. };
  166. //! Mouse Events see cv::MouseCallback
  167. enum MouseEventTypes {
  168. EVENT_MOUSEMOVE = 0, //!< indicates that the mouse pointer has moved over the window.
  169. EVENT_LBUTTONDOWN = 1, //!< indicates that the left mouse button is pressed.
  170. EVENT_RBUTTONDOWN = 2, //!< indicates that the right mouse button is pressed.
  171. EVENT_MBUTTONDOWN = 3, //!< indicates that the middle mouse button is pressed.
  172. EVENT_LBUTTONUP = 4, //!< indicates that left mouse button is released.
  173. EVENT_RBUTTONUP = 5, //!< indicates that right mouse button is released.
  174. EVENT_MBUTTONUP = 6, //!< indicates that middle mouse button is released.
  175. EVENT_LBUTTONDBLCLK = 7, //!< indicates that left mouse button is double clicked.
  176. EVENT_RBUTTONDBLCLK = 8, //!< indicates that right mouse button is double clicked.
  177. EVENT_MBUTTONDBLCLK = 9, //!< indicates that middle mouse button is double clicked.
  178. EVENT_MOUSEWHEEL = 10,//!< positive and negative values mean forward and backward scrolling, respectively.
  179. EVENT_MOUSEHWHEEL = 11 //!< positive and negative values mean right and left scrolling, respectively.
  180. };
  181. //! Mouse Event Flags see cv::MouseCallback
  182. enum MouseEventFlags {
  183. EVENT_FLAG_LBUTTON = 1, //!< indicates that the left mouse button is down.
  184. EVENT_FLAG_RBUTTON = 2, //!< indicates that the right mouse button is down.
  185. EVENT_FLAG_MBUTTON = 4, //!< indicates that the middle mouse button is down.
  186. EVENT_FLAG_CTRLKEY = 8, //!< indicates that CTRL Key is pressed.
  187. EVENT_FLAG_SHIFTKEY = 16,//!< indicates that SHIFT Key is pressed.
  188. EVENT_FLAG_ALTKEY = 32 //!< indicates that ALT Key is pressed.
  189. };
  190. //! Qt font weight
  191. enum QtFontWeights {
  192. QT_FONT_LIGHT = 25, //!< Weight of 25
  193. QT_FONT_NORMAL = 50, //!< Weight of 50
  194. QT_FONT_DEMIBOLD = 63, //!< Weight of 63
  195. QT_FONT_BOLD = 75, //!< Weight of 75
  196. QT_FONT_BLACK = 87 //!< Weight of 87
  197. };
  198. //! Qt font style
  199. enum QtFontStyles {
  200. QT_STYLE_NORMAL = 0, //!< Normal font.
  201. QT_STYLE_ITALIC = 1, //!< Italic font.
  202. QT_STYLE_OBLIQUE = 2 //!< Oblique font.
  203. };
  204. //! Qt "button" type
  205. enum QtButtonTypes {
  206. QT_PUSH_BUTTON = 0, //!< Push button.
  207. QT_CHECKBOX = 1, //!< Checkbox button.
  208. QT_RADIOBOX = 2, //!< Radiobox button.
  209. QT_NEW_BUTTONBAR = 1024 //!< Button should create a new buttonbar
  210. };
  211. /** @brief Callback function for mouse events. see cv::setMouseCallback
  212. @param event one of the cv::MouseEventTypes constants.
  213. @param x The x-coordinate of the mouse event.
  214. @param y The y-coordinate of the mouse event.
  215. @param flags one of the cv::MouseEventFlags constants.
  216. @param userdata The optional parameter.
  217. */
  218. typedef void (*MouseCallback)(int event, int x, int y, int flags, void* userdata);
  219. /** @brief Callback function for Trackbar see cv::createTrackbar
  220. @param pos current position of the specified trackbar.
  221. @param userdata The optional parameter.
  222. */
  223. typedef void (*TrackbarCallback)(int pos, void* userdata);
  224. /** @brief Callback function defined to be called every frame. See cv::setOpenGlDrawCallback
  225. @param userdata The optional parameter.
  226. */
  227. typedef void (*OpenGlDrawCallback)(void* userdata);
  228. /** @brief Callback function for a button created by cv::createButton
  229. @param state current state of the button. It could be -1 for a push button, 0 or 1 for a check/radio box button.
  230. @param userdata The optional parameter.
  231. */
  232. typedef void (*ButtonCallback)(int state, void* userdata);
  233. /** @brief Creates a window.
  234. The function namedWindow creates a window that can be used as a placeholder for images and
  235. trackbars. Created windows are referred to by their names.
  236. If a window with the same name already exists, the function does nothing.
  237. You can call cv::destroyWindow or cv::destroyAllWindows to close the window and de-allocate any associated
  238. memory usage. For a simple program, you do not really have to call these functions because all the
  239. resources and windows of the application are closed automatically by the operating system upon exit.
  240. @note
  241. Qt backend supports additional flags:
  242. - **WINDOW_NORMAL or WINDOW_AUTOSIZE:** WINDOW_NORMAL enables you to resize the
  243. window, whereas WINDOW_AUTOSIZE adjusts automatically the window size to fit the
  244. displayed image (see imshow ), and you cannot change the window size manually.
  245. - **WINDOW_FREERATIO or WINDOW_KEEPRATIO:** WINDOW_FREERATIO adjusts the image
  246. with no respect to its ratio, whereas WINDOW_KEEPRATIO keeps the image ratio.
  247. - **WINDOW_GUI_NORMAL or WINDOW_GUI_EXPANDED:** WINDOW_GUI_NORMAL is the old way to draw the window
  248. without statusbar and toolbar, whereas WINDOW_GUI_EXPANDED is a new enhanced GUI.
  249. By default, flags == WINDOW_AUTOSIZE | WINDOW_KEEPRATIO | WINDOW_GUI_EXPANDED
  250. @param winname Name of the window in the window caption that may be used as a window identifier.
  251. @param flags Flags of the window. The supported flags are: (cv::WindowFlags)
  252. */
  253. CV_EXPORTS_W void namedWindow(const String& winname, int flags = WINDOW_AUTOSIZE);
  254. /** @brief Destroys the specified window.
  255. The function destroyWindow destroys the window with the given name.
  256. @param winname Name of the window to be destroyed.
  257. */
  258. CV_EXPORTS_W void destroyWindow(const String& winname);
  259. /** @brief Destroys all of the HighGUI windows.
  260. The function destroyAllWindows destroys all of the opened HighGUI windows.
  261. */
  262. CV_EXPORTS_W void destroyAllWindows();
  263. CV_EXPORTS_W int startWindowThread();
  264. /** @brief Similar to #waitKey, but returns full key code.
  265. @note
  266. Key code is implementation specific and depends on used backend: QT/GTK/Win32/etc
  267. */
  268. CV_EXPORTS_W int waitKeyEx(int delay = 0);
  269. /** @brief Waits for a pressed key.
  270. The function waitKey waits for a key event infinitely (when \f$\texttt{delay}\leq 0\f$ ) or for delay
  271. milliseconds, when it is positive. Since the OS has a minimum time between switching threads, the
  272. function will not wait exactly delay ms, it will wait at least delay ms, depending on what else is
  273. running on your computer at that time. It returns the code of the pressed key or -1 if no key was
  274. pressed before the specified time had elapsed.
  275. @note
  276. This function is the only method in HighGUI that can fetch and handle events, so it needs to be
  277. called periodically for normal event processing unless HighGUI is used within an environment that
  278. takes care of event processing.
  279. @note
  280. The function only works if there is at least one HighGUI window created and the window is active.
  281. If there are several HighGUI windows, any of them can be active.
  282. @param delay Delay in milliseconds. 0 is the special value that means "forever".
  283. */
  284. CV_EXPORTS_W int waitKey(int delay = 0);
  285. /** @brief Displays an image in the specified window.
  286. The function imshow displays an image in the specified window. If the window was created with the
  287. cv::WINDOW_AUTOSIZE flag, the image is shown with its original size, however it is still limited by the screen resolution.
  288. Otherwise, the image is scaled to fit the window. The function may scale the image, depending on its depth:
  289. - If the image is 8-bit unsigned, it is displayed as is.
  290. - If the image is 16-bit unsigned or 32-bit integer, the pixels are divided by 256. That is, the
  291. value range [0,255\*256] is mapped to [0,255].
  292. - If the image is 32-bit or 64-bit floating-point, the pixel values are multiplied by 255. That is, the
  293. value range [0,1] is mapped to [0,255].
  294. If window was created with OpenGL support, cv::imshow also support ogl::Buffer , ogl::Texture2D and
  295. cuda::GpuMat as input.
  296. If the window was not created before this function, it is assumed creating a window with cv::WINDOW_AUTOSIZE.
  297. If you need to show an image that is bigger than the screen resolution, you will need to call namedWindow("", WINDOW_NORMAL) before the imshow.
  298. @note This function should be followed by cv::waitKey function which displays the image for specified
  299. milliseconds. Otherwise, it won't display the image. For example, **waitKey(0)** will display the window
  300. infinitely until any keypress (it is suitable for image display). **waitKey(25)** will display a frame
  301. for 25 ms, after which display will be automatically closed. (If you put it in a loop to read
  302. videos, it will display the video frame-by-frame)
  303. @note
  304. [__Windows Backend Only__] Pressing Ctrl+C will copy the image to the clipboard.
  305. [__Windows Backend Only__] Pressing Ctrl+S will show a dialog to save the image.
  306. @param winname Name of the window.
  307. @param mat Image to be shown.
  308. */
  309. CV_EXPORTS_W void imshow(const String& winname, InputArray mat);
  310. /** @brief Resizes window to the specified size
  311. @note
  312. - The specified window size is for the image area. Toolbars are not counted.
  313. - Only windows created without cv::WINDOW_AUTOSIZE flag can be resized.
  314. @param winname Window name.
  315. @param width The new window width.
  316. @param height The new window height.
  317. */
  318. CV_EXPORTS_W void resizeWindow(const String& winname, int width, int height);
  319. /** @overload
  320. @param winname Window name.
  321. @param size The new window size.
  322. */
  323. CV_EXPORTS_W void resizeWindow(const String& winname, const cv::Size& size);
  324. /** @brief Moves window to the specified position
  325. @param winname Name of the window.
  326. @param x The new x-coordinate of the window.
  327. @param y The new y-coordinate of the window.
  328. */
  329. CV_EXPORTS_W void moveWindow(const String& winname, int x, int y);
  330. /** @brief Changes parameters of a window dynamically.
  331. The function setWindowProperty enables changing properties of a window.
  332. @param winname Name of the window.
  333. @param prop_id Window property to edit. The supported operation flags are: (cv::WindowPropertyFlags)
  334. @param prop_value New value of the window property. The supported flags are: (cv::WindowFlags)
  335. */
  336. CV_EXPORTS_W void setWindowProperty(const String& winname, int prop_id, double prop_value);
  337. /** @brief Updates window title
  338. @param winname Name of the window.
  339. @param title New title.
  340. */
  341. CV_EXPORTS_W void setWindowTitle(const String& winname, const String& title);
  342. /** @brief Provides parameters of a window.
  343. The function getWindowProperty returns properties of a window.
  344. @param winname Name of the window.
  345. @param prop_id Window property to retrieve. The following operation flags are available: (cv::WindowPropertyFlags)
  346. @sa setWindowProperty
  347. */
  348. CV_EXPORTS_W double getWindowProperty(const String& winname, int prop_id);
  349. /** @brief Provides rectangle of image in the window.
  350. The function getWindowImageRect returns the client screen coordinates, width and height of the image rendering area.
  351. @param winname Name of the window.
  352. @sa resizeWindow moveWindow
  353. */
  354. CV_EXPORTS_W Rect getWindowImageRect(const String& winname);
  355. /** @example samples/cpp/create_mask.cpp
  356. This program demonstrates using mouse events and how to make and use a mask image (black and white) .
  357. */
  358. /** @brief Sets mouse handler for the specified window
  359. @param winname Name of the window.
  360. @param onMouse Callback function for mouse events. See OpenCV samples on how to specify and use the callback.
  361. @param userdata The optional parameter passed to the callback.
  362. */
  363. CV_EXPORTS void setMouseCallback(const String& winname, MouseCallback onMouse, void* userdata = 0);
  364. /** @brief Gets the mouse-wheel motion delta, when handling mouse-wheel events cv::EVENT_MOUSEWHEEL and
  365. cv::EVENT_MOUSEHWHEEL.
  366. For regular mice with a scroll-wheel, delta will be a multiple of 120. The value 120 corresponds to
  367. a one notch rotation of the wheel or the threshold for action to be taken and one such action should
  368. occur for each delta. Some high-precision mice with higher-resolution freely-rotating wheels may
  369. generate smaller values.
  370. For cv::EVENT_MOUSEWHEEL positive and negative values mean forward and backward scrolling,
  371. respectively. For cv::EVENT_MOUSEHWHEEL, where available, positive and negative values mean right and
  372. left scrolling, respectively.
  373. With the C API, the macro CV_GET_WHEEL_DELTA(flags) can be used alternatively.
  374. @note
  375. Mouse-wheel events are currently supported only on Windows.
  376. @param flags The mouse callback flags parameter.
  377. */
  378. CV_EXPORTS int getMouseWheelDelta(int flags);
  379. /** @brief Selects ROI on the given image.
  380. Function creates a window and allows user to select a ROI using mouse.
  381. Controls: use `space` or `enter` to finish selection, use key `c` to cancel selection (function will return the zero cv::Rect).
  382. @param windowName name of the window where selection process will be shown.
  383. @param img image to select a ROI.
  384. @param showCrosshair if true crosshair of selection rectangle will be shown.
  385. @param fromCenter if true center of selection will match initial mouse position. In opposite case a corner of
  386. selection rectangle will correspont to the initial mouse position.
  387. @return selected ROI or empty rect if selection canceled.
  388. @note The function sets it's own mouse callback for specified window using cv::setMouseCallback(windowName, ...).
  389. After finish of work an empty callback will be set for the used window.
  390. */
  391. CV_EXPORTS_W Rect selectROI(const String& windowName, InputArray img, bool showCrosshair = true, bool fromCenter = false);
  392. /** @overload
  393. */
  394. CV_EXPORTS_W Rect selectROI(InputArray img, bool showCrosshair = true, bool fromCenter = false);
  395. /** @brief Selects ROIs on the given image.
  396. Function creates a window and allows user to select a ROIs using mouse.
  397. Controls: use `space` or `enter` to finish current selection and start a new one,
  398. use `esc` to terminate multiple ROI selection process.
  399. @param windowName name of the window where selection process will be shown.
  400. @param img image to select a ROI.
  401. @param boundingBoxes selected ROIs.
  402. @param showCrosshair if true crosshair of selection rectangle will be shown.
  403. @param fromCenter if true center of selection will match initial mouse position. In opposite case a corner of
  404. selection rectangle will correspont to the initial mouse position.
  405. @note The function sets it's own mouse callback for specified window using cv::setMouseCallback(windowName, ...).
  406. After finish of work an empty callback will be set for the used window.
  407. */
  408. CV_EXPORTS_W void selectROIs(const String& windowName, InputArray img,
  409. CV_OUT std::vector<Rect>& boundingBoxes, bool showCrosshair = true, bool fromCenter = false);
  410. /** @brief Creates a trackbar and attaches it to the specified window.
  411. The function createTrackbar creates a trackbar (a slider or range control) with the specified name
  412. and range, assigns a variable value to be a position synchronized with the trackbar and specifies
  413. the callback function onChange to be called on the trackbar position change. The created trackbar is
  414. displayed in the specified window winname.
  415. @note
  416. [__Qt Backend Only__] winname can be empty if the trackbar should be attached to the
  417. control panel.
  418. Clicking the label of each trackbar enables editing the trackbar values manually.
  419. @param trackbarname Name of the created trackbar.
  420. @param winname Name of the window that will be used as a parent of the created trackbar.
  421. @param value Optional pointer to an integer variable whose value reflects the position of the
  422. slider. Upon creation, the slider position is defined by this variable.
  423. @param count Maximal position of the slider. The minimal position is always 0.
  424. @param onChange Pointer to the function to be called every time the slider changes position. This
  425. function should be prototyped as void Foo(int,void\*); , where the first parameter is the trackbar
  426. position and the second parameter is the user data (see the next parameter). If the callback is
  427. the NULL pointer, no callbacks are called, but only value is updated.
  428. @param userdata User data that is passed as is to the callback. It can be used to handle trackbar
  429. events without using global variables.
  430. */
  431. CV_EXPORTS int createTrackbar(const String& trackbarname, const String& winname,
  432. int* value, int count,
  433. TrackbarCallback onChange = 0,
  434. void* userdata = 0);
  435. /** @brief Returns the trackbar position.
  436. The function returns the current position of the specified trackbar.
  437. @note
  438. [__Qt Backend Only__] winname can be empty if the trackbar is attached to the control
  439. panel.
  440. @param trackbarname Name of the trackbar.
  441. @param winname Name of the window that is the parent of the trackbar.
  442. */
  443. CV_EXPORTS_W int getTrackbarPos(const String& trackbarname, const String& winname);
  444. /** @brief Sets the trackbar position.
  445. The function sets the position of the specified trackbar in the specified window.
  446. @note
  447. [__Qt Backend Only__] winname can be empty if the trackbar is attached to the control
  448. panel.
  449. @param trackbarname Name of the trackbar.
  450. @param winname Name of the window that is the parent of trackbar.
  451. @param pos New position.
  452. */
  453. CV_EXPORTS_W void setTrackbarPos(const String& trackbarname, const String& winname, int pos);
  454. /** @brief Sets the trackbar maximum position.
  455. The function sets the maximum position of the specified trackbar in the specified window.
  456. @note
  457. [__Qt Backend Only__] winname can be empty if the trackbar is attached to the control
  458. panel.
  459. @param trackbarname Name of the trackbar.
  460. @param winname Name of the window that is the parent of trackbar.
  461. @param maxval New maximum position.
  462. */
  463. CV_EXPORTS_W void setTrackbarMax(const String& trackbarname, const String& winname, int maxval);
  464. /** @brief Sets the trackbar minimum position.
  465. The function sets the minimum position of the specified trackbar in the specified window.
  466. @note
  467. [__Qt Backend Only__] winname can be empty if the trackbar is attached to the control
  468. panel.
  469. @param trackbarname Name of the trackbar.
  470. @param winname Name of the window that is the parent of trackbar.
  471. @param minval New minimum position.
  472. */
  473. CV_EXPORTS_W void setTrackbarMin(const String& trackbarname, const String& winname, int minval);
  474. //! @addtogroup highgui_opengl OpenGL support
  475. //! @{
  476. /** @brief Displays OpenGL 2D texture in the specified window.
  477. @param winname Name of the window.
  478. @param tex OpenGL 2D texture data.
  479. */
  480. CV_EXPORTS void imshow(const String& winname, const ogl::Texture2D& tex);
  481. /** @brief Sets a callback function to be called to draw on top of displayed image.
  482. The function setOpenGlDrawCallback can be used to draw 3D data on the window. See the example of
  483. callback function below:
  484. @code
  485. void on_opengl(void* param)
  486. {
  487. glLoadIdentity();
  488. glTranslated(0.0, 0.0, -1.0);
  489. glRotatef( 55, 1, 0, 0 );
  490. glRotatef( 45, 0, 1, 0 );
  491. glRotatef( 0, 0, 0, 1 );
  492. static const int coords[6][4][3] = {
  493. { { +1, -1, -1 }, { -1, -1, -1 }, { -1, +1, -1 }, { +1, +1, -1 } },
  494. { { +1, +1, -1 }, { -1, +1, -1 }, { -1, +1, +1 }, { +1, +1, +1 } },
  495. { { +1, -1, +1 }, { +1, -1, -1 }, { +1, +1, -1 }, { +1, +1, +1 } },
  496. { { -1, -1, -1 }, { -1, -1, +1 }, { -1, +1, +1 }, { -1, +1, -1 } },
  497. { { +1, -1, +1 }, { -1, -1, +1 }, { -1, -1, -1 }, { +1, -1, -1 } },
  498. { { -1, -1, +1 }, { +1, -1, +1 }, { +1, +1, +1 }, { -1, +1, +1 } }
  499. };
  500. for (int i = 0; i < 6; ++i) {
  501. glColor3ub( i*20, 100+i*10, i*42 );
  502. glBegin(GL_QUADS);
  503. for (int j = 0; j < 4; ++j) {
  504. glVertex3d(0.2 * coords[i][j][0], 0.2 * coords[i][j][1], 0.2 * coords[i][j][2]);
  505. }
  506. glEnd();
  507. }
  508. }
  509. @endcode
  510. @param winname Name of the window.
  511. @param onOpenGlDraw Pointer to the function to be called every frame. This function should be
  512. prototyped as void Foo(void\*) .
  513. @param userdata Pointer passed to the callback function.(__Optional__)
  514. */
  515. CV_EXPORTS void setOpenGlDrawCallback(const String& winname, OpenGlDrawCallback onOpenGlDraw, void* userdata = 0);
  516. /** @brief Sets the specified window as current OpenGL context.
  517. @param winname Name of the window.
  518. */
  519. CV_EXPORTS void setOpenGlContext(const String& winname);
  520. /** @brief Force window to redraw its context and call draw callback ( See cv::setOpenGlDrawCallback ).
  521. @param winname Name of the window.
  522. */
  523. CV_EXPORTS void updateWindow(const String& winname);
  524. //! @} highgui_opengl
  525. //! @addtogroup highgui_qt
  526. //! @{
  527. /** @brief QtFont available only for Qt. See cv::fontQt
  528. */
  529. struct QtFont
  530. {
  531. const char* nameFont; //!< Name of the font
  532. Scalar color; //!< Color of the font. Scalar(blue_component, green_component, red_component[, alpha_component])
  533. int font_face; //!< See cv::QtFontStyles
  534. const int* ascii; //!< font data and metrics
  535. const int* greek;
  536. const int* cyrillic;
  537. float hscale, vscale;
  538. float shear; //!< slope coefficient: 0 - normal, >0 - italic
  539. int thickness; //!< See cv::QtFontWeights
  540. float dx; //!< horizontal interval between letters
  541. int line_type; //!< PointSize
  542. };
  543. /** @brief Creates the font to draw a text on an image.
  544. The function fontQt creates a cv::QtFont object. This cv::QtFont is not compatible with putText .
  545. A basic usage of this function is the following: :
  546. @code
  547. QtFont font = fontQt("Times");
  548. addText( img1, "Hello World !", Point(50,50), font);
  549. @endcode
  550. @param nameFont Name of the font. The name should match the name of a system font (such as
  551. *Times*). If the font is not found, a default one is used.
  552. @param pointSize Size of the font. If not specified, equal zero or negative, the point size of the
  553. font is set to a system-dependent default value. Generally, this is 12 points.
  554. @param color Color of the font in BGRA where A = 255 is fully transparent. Use the macro CV_RGB
  555. for simplicity.
  556. @param weight Font weight. Available operation flags are : cv::QtFontWeights You can also specify a positive integer for better control.
  557. @param style Font style. Available operation flags are : cv::QtFontStyles
  558. @param spacing Spacing between characters. It can be negative or positive.
  559. */
  560. CV_EXPORTS QtFont fontQt(const String& nameFont, int pointSize = -1,
  561. Scalar color = Scalar::all(0), int weight = QT_FONT_NORMAL,
  562. int style = QT_STYLE_NORMAL, int spacing = 0);
  563. /** @brief Draws a text on the image.
  564. The function addText draws *text* on the image *img* using a specific font *font* (see example cv::fontQt
  565. )
  566. @param img 8-bit 3-channel image where the text should be drawn.
  567. @param text Text to write on an image.
  568. @param org Point(x,y) where the text should start on an image.
  569. @param font Font to use to draw a text.
  570. */
  571. CV_EXPORTS void addText( const Mat& img, const String& text, Point org, const QtFont& font);
  572. /** @brief Draws a text on the image.
  573. @param img 8-bit 3-channel image where the text should be drawn.
  574. @param text Text to write on an image.
  575. @param org Point(x,y) where the text should start on an image.
  576. @param nameFont Name of the font. The name should match the name of a system font (such as
  577. *Times*). If the font is not found, a default one is used.
  578. @param pointSize Size of the font. If not specified, equal zero or negative, the point size of the
  579. font is set to a system-dependent default value. Generally, this is 12 points.
  580. @param color Color of the font in BGRA where A = 255 is fully transparent.
  581. @param weight Font weight. Available operation flags are : cv::QtFontWeights You can also specify a positive integer for better control.
  582. @param style Font style. Available operation flags are : cv::QtFontStyles
  583. @param spacing Spacing between characters. It can be negative or positive.
  584. */
  585. CV_EXPORTS_W void addText(const Mat& img, const String& text, Point org, const String& nameFont, int pointSize = -1, Scalar color = Scalar::all(0),
  586. int weight = QT_FONT_NORMAL, int style = QT_STYLE_NORMAL, int spacing = 0);
  587. /** @brief Displays a text on a window image as an overlay for a specified duration.
  588. The function displayOverlay displays useful information/tips on top of the window for a certain
  589. amount of time *delayms*. The function does not modify the image, displayed in the window, that is,
  590. after the specified delay the original content of the window is restored.
  591. @param winname Name of the window.
  592. @param text Overlay text to write on a window image.
  593. @param delayms The period (in milliseconds), during which the overlay text is displayed. If this
  594. function is called before the previous overlay text timed out, the timer is restarted and the text
  595. is updated. If this value is zero, the text never disappears.
  596. */
  597. CV_EXPORTS_W void displayOverlay(const String& winname, const String& text, int delayms = 0);
  598. /** @brief Displays a text on the window statusbar during the specified period of time.
  599. The function displayStatusBar displays useful information/tips on top of the window for a certain
  600. amount of time *delayms* . This information is displayed on the window statusbar (the window must be
  601. created with the CV_GUI_EXPANDED flags).
  602. @param winname Name of the window.
  603. @param text Text to write on the window statusbar.
  604. @param delayms Duration (in milliseconds) to display the text. If this function is called before
  605. the previous text timed out, the timer is restarted and the text is updated. If this value is
  606. zero, the text never disappears.
  607. */
  608. CV_EXPORTS_W void displayStatusBar(const String& winname, const String& text, int delayms = 0);
  609. /** @brief Saves parameters of the specified window.
  610. The function saveWindowParameters saves size, location, flags, trackbars value, zoom and panning
  611. location of the window windowName.
  612. @param windowName Name of the window.
  613. */
  614. CV_EXPORTS void saveWindowParameters(const String& windowName);
  615. /** @brief Loads parameters of the specified window.
  616. The function loadWindowParameters loads size, location, flags, trackbars value, zoom and panning
  617. location of the window windowName.
  618. @param windowName Name of the window.
  619. */
  620. CV_EXPORTS void loadWindowParameters(const String& windowName);
  621. CV_EXPORTS int startLoop(int (*pt2Func)(int argc, char *argv[]), int argc, char* argv[]);
  622. CV_EXPORTS void stopLoop();
  623. /** @brief Attaches a button to the control panel.
  624. The function createButton attaches a button to the control panel. Each button is added to a
  625. buttonbar to the right of the last button. A new buttonbar is created if nothing was attached to the
  626. control panel before, or if the last element attached to the control panel was a trackbar or if the
  627. QT_NEW_BUTTONBAR flag is added to the type.
  628. See below various examples of the cv::createButton function call: :
  629. @code
  630. createButton("",callbackButton);//create a push button "button 0", that will call callbackButton.
  631. createButton("button2",callbackButton,NULL,QT_CHECKBOX,0);
  632. createButton("button3",callbackButton,&value);
  633. createButton("button5",callbackButton1,NULL,QT_RADIOBOX);
  634. createButton("button6",callbackButton2,NULL,QT_PUSH_BUTTON,1);
  635. createButton("button6",callbackButton2,NULL,QT_PUSH_BUTTON|QT_NEW_BUTTONBAR);// create a push button in a new row
  636. @endcode
  637. @param bar_name Name of the button.
  638. @param on_change Pointer to the function to be called every time the button changes its state.
  639. This function should be prototyped as void Foo(int state,\*void); . *state* is the current state
  640. of the button. It could be -1 for a push button, 0 or 1 for a check/radio box button.
  641. @param userdata Pointer passed to the callback function.
  642. @param type Optional type of the button. Available types are: (cv::QtButtonTypes)
  643. @param initial_button_state Default state of the button. Use for checkbox and radiobox. Its
  644. value could be 0 or 1. (__Optional__)
  645. */
  646. CV_EXPORTS int createButton( const String& bar_name, ButtonCallback on_change,
  647. void* userdata = 0, int type = QT_PUSH_BUTTON,
  648. bool initial_button_state = false);
  649. //! @} highgui_qt
  650. //! @} highgui
  651. } // cv
  652. #endif