Read an image sequence from the disk and display it.
The sequence is made of separate images. Each image corresponds to a PGM file.
#include <visp3/core/vpConfig.h>
#include <visp3/core/vpDebug.h>
#include <visp3/core/vpIoTools.h>
#include <visp3/io/vpParseArgv.h>
#include <iomanip>
#include <sstream>
#include <stdio.h>
#include <stdlib.h>
#if (defined(VISP_HAVE_GTK) || defined(VISP_HAVE_X11) || defined(VISP_HAVE_GDI) || defined(VISP_HAVE_D3D9))
#include <visp3/core/vpImage.h>
#include <visp3/io/vpImageIo.h>
#include <visp3/core/vpMouseButton.h>
#include <visp3/gui/vpDisplayD3D.h>
#include <visp3/gui/vpDisplayGDI.h>
#include <visp3/gui/vpDisplayGTK.h>
#include <visp3/gui/vpDisplayX.h>
#include <visp3/core/vpTime.h>
#define GETOPTARGS "cdi:lp:ht:f:n:s:w"
typedef enum {
vpX11,
vpGTK,
vpGDI,
vpD3D,
} vpDisplayType;
void usage(const char *name, const char *badparam, std::string ipath, std::string ppath, unsigned first,
unsigned nimages, unsigned step, vpDisplayType &dtype);
bool getOptions(int argc, const char **argv, std::string &ipath, std::string &ppath, unsigned &first, unsigned &nimages,
unsigned &step, vpDisplayType &dtype,
bool &list,
bool &display,
bool &click,
bool &
wait);
void usage(const char *name, const char *badparam, std::string ipath, std::string ppath, unsigned first,
unsigned nimages, unsigned step, vpDisplayType &dtype)
{
fprintf(stdout, "\n\
Read an image sequence from the disk and display it.\n\
The sequence is made of separate images. Each image corresponds\n\
to a PGM file.\n\
\n\
SYNOPSIS\n\
%s [-i <test image path>] [-p <personal image path>]\n\
[-f <first image>] [-n <number of images>] [-s <step>] \n\
[-t <type of video device>] [-l] [-w] [-c] [-d] [-h]\n \
", name);
std::string display;
switch (dtype) {
case vpX11:
display = "X11";
break;
case vpGTK:
display = "GTK";
break;
case vpGDI:
display = "GDI";
break;
case vpD3D:
display = "D3D";
break;
}
fprintf(stdout, "\n\
OPTIONS: Default\n\
-i <test image path> %s\n\
Set image input path.\n\
From this path read \"cube/image.%%04d.pgm\"\n\
images. These images come from ViSP-images-x.y.z.tar.gz\n\
available on the ViSP website.\n\
Setting the VISP_INPUT_IMAGE_PATH environment\n\
variable produces the same behaviour than using\n\
this option.\n\
\n\
-p <personal image path> %s\n\
Specify a personal sequence containing images \n\
to process.\n\
By image sequence, we mean one file per image.\n\
The following image file formats PNM (PGM P5, PPM P6)\n\
are supported. The format is selected by analysing \n\
the filename extension.\n\
Example : \"/Temp/ViSP-images/cube/image.%%04d.pgm\"\n\
%%04d is for the image numbering.\n\
\n\
-f <first image> %u\n\
First image number of the sequence.\n\
\n\
-n <number of images> %u\n\
Number of images to load from the sequence.\n\
\n\
-s <step> %u\n\
Step between two images.\n\
\n\
-t <type of video device> \"%s\"\n\
String specifying the video device to use.\n\
Possible values:\n\
\"X11\": only on UNIX platforms,\n\
\"GTK\": on all plaforms,\n\
\"GDI\": only on Windows platform (Graphics Device Interface),\n\
\"D3D\": only on Windows platform (Direct3D).\n\
\n\
-l\n\
Print the list of video-devices available and exit.\n\
\n\
-c\n\
Disable mouse click.\n\
\n\
-d\n\
Disable the image display. This can be useful \n\
for automatic tests using crontab under Unix or \n\
using the task manager under Windows.\n\
\n\
-w\n\
Wait for a mouse click between two images.\n\
If the image display is disabled (using -d)\n\
this option is without effect.\n\
\n\
-h\n\
Print the help.\n\n", ipath.c_str(), ppath.c_str(), first, nimages, step, display.c_str());
if (badparam)
fprintf(stdout, "\nERROR: Bad parameter [%s]\n", badparam);
}
bool getOptions(int argc, const char **argv, std::string &ipath, std::string &ppath, unsigned &first, unsigned &nimages,
unsigned &step, vpDisplayType &dtype,
bool &list,
bool &display,
bool &click,
bool &
wait)
{
const char *optarg_;
int c;
std::string sDisplayType;
switch (c) {
case 'c':
click = false;
break;
case 'd':
display = false;
break;
case 't':
sDisplayType = optarg_;
if (sDisplayType.compare("X11") == 0) {
dtype = vpX11;
} else if (sDisplayType.compare("GTK") == 0) {
dtype = vpGTK;
} else if (sDisplayType.compare("GDI") == 0) {
dtype = vpGDI;
} else if (sDisplayType.compare("D3D") == 0) {
dtype = vpD3D;
}
break;
case 'i':
ipath = optarg_;
break;
case 'l':
list = true;
break;
case 'p':
ppath = optarg_;
break;
case 'f':
first = (unsigned)atoi(optarg_);
break;
case 'n':
nimages = (unsigned)atoi(optarg_);
break;
case 's':
step = (unsigned)atoi(optarg_);
break;
case 'w':
wait = true;
break;
case 'h':
usage(argv[0], NULL, ipath, ppath, first, nimages, step, dtype);
return false;
break;
default:
usage(argv[0], optarg_, ipath, ppath, first, nimages, step, dtype);
return false;
break;
}
}
if ((c == 1) || (c == -1)) {
usage(argv[0], NULL, ipath, ppath, first, nimages, step, dtype);
std::cerr << "ERROR: " << std::endl;
std::cerr << " Bad argument " << optarg_ << std::endl << std::endl;
return false;
}
return true;
}
int main(int argc, const char **argv)
{
std::string env_ipath;
std::string opt_ipath;
std::string ipath;
std::string opt_ppath;
std::string dirname;
std::string filename;
unsigned opt_first = 30;
unsigned opt_nimages = 10;
unsigned opt_step = 1;
vpDisplayType opt_dtype;
bool opt_list = false;
bool opt_display = true;
bool opt_click = true;
bool opt_click_blocking = false;
#if defined VISP_HAVE_GTK
opt_dtype = vpGTK;
#elif defined VISP_HAVE_X11
opt_dtype = vpX11;
#elif defined VISP_HAVE_GDI
opt_dtype = vpGDI;
#elif defined VISP_HAVE_D3D9
opt_dtype = vpD3D;
#endif
if (!env_ipath.empty())
ipath = env_ipath;
if (getOptions(argc, argv, opt_ipath, opt_ppath, opt_first, opt_nimages, opt_step, opt_dtype, opt_list, opt_display,
opt_click, opt_click_blocking) == false) {
exit(-1);
}
if (opt_list) {
unsigned nbDevices = 0;
std::cout << "List of video-devices available: \n";
#if defined VISP_HAVE_GTK
std::cout << " GTK (use \"-t GTK\" option to use it)\n";
nbDevices++;
#endif
#if defined VISP_HAVE_X11
std::cout << " X11 (use \"-t X11\" option to use it)\n";
nbDevices++;
#endif
#if defined VISP_HAVE_GDI
std::cout << " GDI (use \"-t GDI\" option to use it)\n";
nbDevices++;
#endif
#if defined VISP_HAVE_D3D9
std::cout << " D3D (use \"-t D3D\" option to use it)\n";
nbDevices++;
#endif
if (!nbDevices) {
std::cout << " No display is available\n";
}
return (0);
}
if (!opt_display)
opt_click_blocking = false;
if (!opt_ipath.empty())
ipath = opt_ipath;
if (!opt_ipath.empty() && !env_ipath.empty() && opt_ppath.empty()) {
if (ipath != env_ipath) {
std::cout << std::endl << "WARNING: " << std::endl;
std::cout << " Since -i <visp image path=" << ipath << "> "
<< " is different from VISP_IMAGE_PATH=" << env_ipath << std::endl
<< " we skip the environment variable." << std::endl;
}
}
if (opt_ipath.empty() && env_ipath.empty() && opt_ppath.empty()) {
usage(argv[0], NULL, ipath, opt_ppath, opt_first, opt_nimages, opt_step, opt_dtype);
std::cerr << std::endl << "ERROR:" << std::endl;
std::cerr << " Use -i <visp image path> option or set VISP_INPUT_IMAGE_PATH " << std::endl
<< " environment variable to specify the location of the " << std::endl
<< " image path where test images are located." << std::endl
<< " Use -p <personal image path> option if you want to " << std::endl
<< " use personal images." << std::endl
<< std::endl;
exit(-1);
}
unsigned iter = opt_first;
std::ostringstream s;
char cfilename[FILENAME_MAX];
if (opt_ppath.empty()) {
s.setf(std::ios::right, std::ios::adjustfield);
s << "image." << std::setw(4) << std::setfill('0') << iter << ".pgm";
} else {
sprintf(cfilename, opt_ppath.c_str(), iter);
filename = cfilename;
}
try {
} catch (...) {
std::cerr << std::endl << "ERROR:" << std::endl;
std::cerr << " Cannot read " << filename << std::endl;
std::cerr << " Check your -i " << ipath << " option, " << std::endl
<< " or your -p " << opt_ppath << " option " << std::endl
<< " or VISP_INPUT_IMAGE_PATH environment variable" << std::endl;
exit(-1);
}
switch (opt_dtype) {
case vpX11:
std::cout << "Requested X11 display functionnalities..." << std::endl;
#if defined VISP_HAVE_X11
#else
std::cout << " Sorry, X11 video device is not available.\n";
std::cout << "Use \"" << argv[0] << " -l\" to print the list of available devices.\n";
return 0;
#endif
break;
case vpGTK:
std::cout << "Requested GTK display functionnalities..." << std::endl;
#if defined VISP_HAVE_GTK
#else
std::cout << " Sorry, GTK video device is not available.\n";
std::cout << "Use \"" << argv[0] << " -l\" to print the list of available devices.\n";
return 0;
#endif
break;
case vpGDI:
std::cout << "Requested GDI display functionnalities..." << std::endl;
#if defined VISP_HAVE_GDI
#else
std::cout << " Sorry, GDI video device is not available.\n";
std::cout << "Use \"" << argv[0] << " -l\" to print the list of available devices.\n";
return 0;
#endif
break;
case vpD3D:
std::cout << "Requested D3D display functionnalities..." << std::endl;
#if defined VISP_HAVE_D3D9
#else
std::cout << " Sorry, D3D video device is not available.\n";
std::cout << "Use \"" << argv[0] << " -l\" to print the list of available devices.\n";
return 0;
#endif
break;
}
if (opt_display) {
try {
display->init(I, 100, 100, "Display...");
} catch (...) {
delete display;
exit(-1);
}
}
unsigned niter = 0;
while (iter < opt_first + opt_nimages * opt_step) {
try {
if (opt_ppath.empty()) {
s.str("");
s << "image." << std::setw(4) << std::setfill('0') << iter << ".pgm";
} else {
sprintf(cfilename, opt_ppath.c_str(), iter);
filename = cfilename;
}
std::cout << "read : " << filename << std::endl;
if (opt_display) {
if (opt_click_blocking) {
std::cout << "A click in the image to continue..." << std::endl;
}
if (opt_click) {
if (pressed) {
switch (button) {
std::cout << "Left button was pressed." << std::endl;
break;
std::cout << "Middle button was pressed." << std::endl;
break;
std::cout << "Right button was pressed. Bye. " << std::endl;
delete display;
return 0;
break;
break;
}
}
}
}
else {
}
niter++;
} catch (...) {
delete display;
exit(-1);
}
iter += opt_step;
}
delete display;
}
#else
int main() {
vpERROR_TRACE(
"You do not have X11 or GTK display functionalities..."); }
#endif