opencv/doc/tutorials/viz/launching_viz/launching_viz.rst

119 lines
2.9 KiB
ReStructuredText
Raw Normal View History

2013-09-07 21:44:26 +08:00
.. _launching_viz:
Launching Viz
*************
Goal
====
In this tutorial you will learn how to
.. container:: enumeratevisibleitemswithsquare
* Open a visualization window.
* Access a window by its name.
* Start event loop.
* Start event loop for a given amount of time.
Code
====
You can download the code from :download:`here <../../../../samples/cpp/tutorial_code/viz/launching_viz.cpp>`.
2013-09-07 21:44:26 +08:00
.. code-block:: cpp
#include <opencv2/viz.hpp>
#include <iostream>
using namespace cv;
using namespace std;
2013-09-18 19:50:55 +08:00
/*
2013-09-07 21:44:26 +08:00
* @function main
*/
int main()
{
/// Create a window
viz::Viz3d myWindow("Viz Demo");
2013-09-18 19:50:55 +08:00
2013-09-07 21:44:26 +08:00
/// Start event loop
myWindow.spin();
2013-09-18 19:50:55 +08:00
2013-09-07 21:44:26 +08:00
/// Event loop is over when pressed q, Q, e, E
cout << "First event loop is over" << endl;
2013-09-18 19:50:55 +08:00
2013-09-07 21:44:26 +08:00
/// Access window via its name
2014-01-12 02:43:58 +08:00
viz::Viz3d sameWindow = viz::getWindowByName("Viz Demo");
2013-09-18 19:50:55 +08:00
2013-09-07 21:44:26 +08:00
/// Start event loop
sameWindow.spin();
2013-09-18 19:50:55 +08:00
2013-09-07 21:44:26 +08:00
/// Event loop is over when pressed q, Q, e, E
cout << "Second event loop is over" << endl;
2013-09-18 19:50:55 +08:00
2013-09-07 21:44:26 +08:00
/// Event loop is over when pressed q, Q, e, E
/// Start event loop once for 1 millisecond
sameWindow.spinOnce(1, true);
while(!sameWindow.wasStopped())
{
/// Interact with window
2013-09-18 19:50:55 +08:00
2013-09-07 21:44:26 +08:00
/// Event loop for 1 millisecond
sameWindow.spinOnce(1, true);
}
2013-09-18 19:50:55 +08:00
2013-09-07 21:44:26 +08:00
/// Once more event loop is stopped
cout << "Last event loop is over" << endl;
return 0;
}
2013-09-18 19:50:55 +08:00
2013-09-07 21:44:26 +08:00
Explanation
===========
Here is the general structure of the program:
* Create a window.
.. code-block:: cpp
/// Create a window
viz::Viz3d myWindow("Viz Demo");
2013-09-18 19:50:55 +08:00
2013-09-07 21:44:26 +08:00
* Start event loop. This event loop will run until user terminates it by pressing **e**, **E**, **q**, **Q**.
.. code-block:: cpp
/// Start event loop
myWindow.spin();
2013-09-18 19:50:55 +08:00
2013-09-07 21:44:26 +08:00
* Access same window via its name. Since windows are implicitly shared, **sameWindow** is exactly the same with **myWindow**. If the name does not exist, a new window is created.
.. code-block:: cpp
/// Access window via its name
viz::Viz3d sameWindow = viz::get("Viz Demo");
2013-09-18 19:50:55 +08:00
2013-09-07 21:44:26 +08:00
* Start a controlled event loop. Once it starts, **wasStopped** is set to false. Inside the while loop, in each iteration, **spinOnce** is called to prevent event loop from completely stopping. Inside the while loop, user can execute other statements including those which interact with the window.
.. code-block:: cpp
/// Event loop is over when pressed q, Q, e, E
/// Start event loop once for 1 millisecond
sameWindow.spinOnce(1, true);
while(!sameWindow.wasStopped())
{
/// Interact with window
2013-09-18 19:50:55 +08:00
2013-09-07 21:44:26 +08:00
/// Event loop for 1 millisecond
sameWindow.spinOnce(1, true);
}
2013-09-18 19:50:55 +08:00
2013-09-07 21:44:26 +08:00
Results
=======
Here is the result of the program.
.. image:: images/window_demo.png
:alt: Launching Viz
:align: center