File: tutorial-pose-estimation-qrcode.dox

package info (click to toggle)
visp 3.7.0-10
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 166,384 kB
  • sloc: cpp: 392,705; ansic: 224,448; xml: 23,444; python: 13,701; java: 4,792; sh: 207; objc: 145; makefile: 118
file content (56 lines) | stat: -rw-r--r-- 2,607 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
/**

\page tutorial-pose-estimation-qrcode Tutorial: Pose estimation from QRcode
\tableofcontents

\section tutorial_pose_qrcode_intro Introduction

This tutorial shows how to use \ref tutorial-detection-barcode and \ref tutorial-pose-estimation in order to
estimate the pose of a QRcode. After a first step that enables QRcode detection, the pose estimation process is
achieved from the location of the four QRcode corners. The 3D coordinates of the corners are set knowing the size
of the QRcode while their 2D coordinates are extracted from the image and transformed in the image plane thanks to
camera intrinsic parameters.

Note that all the material (source code and image) described in this tutorial is
part of ViSP source code (in `tutorial/computer-vision` folder) and could be found in
https://github.com/lagadic/visp/tree/master/tutorial/computer-vision.

Note also that ViSP has to be built with zbar 3rd party library that enables barcode detection. See
 <a href="https://visp.inria.fr/3rd_zbar">zbar quick installation guide</a>.

\section tutorial_pose_qrcode_est Pose estimation of a QRcode

In this section we consider the case of an image that may contain a 12 by 12 cm square QRcode. The camera should
be calibrated (see \ref tutorial-calibration-intrinsic). For each QRcode that is detected thanks to vpDetectorQRCode
class, we update the coordinates of the four corners as a vpPoint object and compute the pose from the four points
thanks to vpPose class. This process is replicated in a while loop. The end of the loop is reached when the user
click in the image that is displayed.

The corresponding source code also provided in tutorial-pose-from-qrcode-image.cpp is the following.

\include tutorial-pose-from-qrcode-image.cpp

Here is a screen shot of the resulting program:

\image html img-pose-qrcode.jpg

More source code explanations could be found in \ref tutorial-detection-barcode and \ref tutorial-pose-estimation.

Note that adapting this tutorial to process images coming from a camera live stream consists in replacing the lines
\code
vpImageIo::read(I, "bar-code.jpg");
\endcode
by
\code
g.aquire(I);
\endcode
where \c g is nothing more than a grabber instantiated as a vp1394TwoGrabber, vpFlyCaptureGrabber, vpV4l2Grabber or
vpRealSense. How to implement framegrabbing is explained in \ref tutorial-grabber.

\section tutorial_pose_qrcode_next Next tutorial

You are now ready to see the next \ref tutorial-homography that shows how to estimate an homography from points.

If you have an RGB-D camera, you may also continue with \ref tutorial-planar-object-pose.

*/