46 #include <visp3/core/vpConfig.h>
50 #include <visp3/core/vpImage.h>
51 #include <visp3/core/vpIoTools.h>
52 #include <visp3/core/vpTime.h>
53 #include <visp3/gui/vpDisplayX.h>
54 #include <visp3/io/vpImageIo.h>
55 #include <visp3/io/vpParseArgv.h>
67 #define GETOPTARGS "cdi:o:p:h"
80 void usage(
const char *name,
const char *badparam, std::string ipath, std::string opath, std::string user)
83 Read an image on the disk, display it using X11, display some\n\
84 features (line, circle, characters) in overlay and finally write \n\
85 the image and the overlayed features in an image on the disk.\n\
88 %s [-i <input image path>] [-o <output image path>]\n\
95 -i <input image path> %s\n\
96 Set image input path.\n\
97 From this path read \"Klimt/Klimt.pgm\"\n\
99 Setting the VISP_INPUT_IMAGE_PATH environment\n\
100 variable produces the same behaviour than using\n\
103 -o <output image path> %s\n\
104 Set image output path.\n\
105 From this directory, creates the \"%s\"\n\
106 subdirectory depending on the username, where \n\
107 Klimt_grey.overlay.ppm output image is written.\n\
110 Disable the mouse click. Useful to automate the \n\
111 execution of this program without human intervention.\n\
114 Disable the image display. This can be useful \n\
115 for automatic tests using crontab under Unix or \n\
116 using the task manager under Windows.\n\
119 Print the help.\n\n",
120 ipath.c_str(), opath.c_str(), user.c_str());
123 fprintf(stderr,
"ERROR: \n");
124 fprintf(stderr,
"\nBad parameter [%s]\n", badparam);
146 bool getOptions(
int argc,
const char **argv, std::string &ipath, std::string &opath,
bool &click_allowed,
147 const std::string &user,
bool &display)
155 click_allowed =
false;
167 usage(argv[0],
nullptr, ipath, opath, user);
172 usage(argv[0], optarg_, ipath, opath, user);
178 if ((c == 1) || (c == -1)) {
180 usage(argv[0],
nullptr, ipath, opath, user);
181 std::cerr <<
"ERROR: " << std::endl;
182 std::cerr <<
" Bad argument " << optarg_ << std::endl << std::endl;
189 int main(
int argc,
const char **argv)
192 std::string env_ipath;
193 std::string opt_ipath;
194 std::string opt_opath;
197 std::string filename;
198 std::string username;
199 bool opt_click_allowed =
true;
200 bool opt_display =
true;
207 if (!env_ipath.empty())
211 #if !defined(_WIN32) && (defined(__unix__) || defined(__unix) || (defined(__APPLE__) && defined(__MACH__)))
213 #elif defined(_WIN32)
214 opt_opath =
"C:\\temp";
221 if (getOptions(argc, argv, opt_ipath, opt_opath, opt_click_allowed, username, opt_display) ==
false) {
226 if (!opt_ipath.empty())
228 if (!opt_opath.empty())
241 usage(argv[0],
nullptr, ipath, opath, username);
242 std::cerr << std::endl <<
"ERROR:" << std::endl;
243 std::cerr <<
" Cannot create " << odirname << std::endl;
244 std::cerr <<
" Check your -o " << opath <<
" option " << std::endl;
251 if (!opt_ipath.empty() && !env_ipath.empty()) {
252 if (ipath != env_ipath) {
253 std::cout << std::endl <<
"WARNING: " << std::endl;
254 std::cout <<
" Since -i <visp image path=" << ipath <<
"> "
255 <<
" is different from VISP_IMAGE_PATH=" << env_ipath << std::endl
256 <<
" we skip the environment variable." << std::endl;
261 if (opt_ipath.empty() && env_ipath.empty()) {
262 usage(argv[0],
nullptr, ipath, opath, username);
263 std::cerr << std::endl <<
"ERROR:" << std::endl;
264 std::cerr <<
" Use -i <visp image path> option or set VISP_INPUT_IMAGE_PATH " << std::endl
265 <<
" environment variable to specify the location of the " << std::endl
266 <<
" image path where test images are located." << std::endl
285 display.init(I, 100, 100,
"X11 display");
298 for (
unsigned i = 0; i < I.
getHeight(); i += 20) {
315 for (
unsigned i = 0; i < I.
getWidth(); i += 20) {
338 for (
unsigned int i = 0; i < 100; i += 20) {
366 if (opt_click_allowed) {
367 std::cout <<
"\nA click to close the windows..." << std::endl;
389 displayRGBa.
init(Irgba, 100, 100,
"X11 color display");
397 if (opt_click_allowed) {
398 std::cout <<
"\nA click to display a cross..." << std::endl;
404 std::cout <<
"Cross position: " << ip << std::endl;
412 std::cout <<
"Cross position: " << ip << std::endl;
430 if (opt_click_allowed) {
431 std::cout <<
"\nA click to exit the program..." << std::endl;
433 std::cout <<
"Bye" << std::endl;
439 std::cout <<
"Catch an exception: " << e << std::endl;
446 std::cout <<
"You do not have X11 functionalities to display images..." << std::endl;
447 std::cout <<
"Tip if you are on a unix-like system:" << std::endl;
448 std::cout <<
"- Install X11, configure again ViSP using cmake and build again this example" << std::endl;
static const vpColor orange
static const vpColor blue
static const vpColor yellow
static const vpColor green
Use the X11 console to display images on unix-like OS. Thus to enable this class X11 should be instal...
void init(vpImage< unsigned char > &I, int win_x=-1, int win_y=-1, const std::string &win_title="") vp_override
static void close(vpImage< unsigned char > &I)
static bool getClick(const vpImage< unsigned char > &I, bool blocking=true)
static void displayCircle(const vpImage< unsigned char > &I, const vpImageCircle &circle, const vpColor &color, bool fill=false, unsigned int thickness=1)
static void display(const vpImage< unsigned char > &I)
static void displayLine(const vpImage< unsigned char > &I, const vpImagePoint &ip1, const vpImagePoint &ip2, const vpColor &color, unsigned int thickness=1, bool segment=true)
static void getImage(const vpImage< unsigned char > &Is, vpImage< vpRGBa > &Id)
static void displayCross(const vpImage< unsigned char > &I, const vpImagePoint &ip, unsigned int size, const vpColor &color, unsigned int thickness=1)
static void flush(const vpImage< unsigned char > &I)
static void displayArrow(const vpImage< unsigned char > &I, const vpImagePoint &ip1, const vpImagePoint &ip2, const vpColor &color=vpColor::white, unsigned int w=4, unsigned int h=2, unsigned int thickness=1)
static void displayDotLine(const vpImage< unsigned char > &I, const vpImagePoint &ip1, const vpImagePoint &ip2, const vpColor &color, unsigned int thickness=1)
static void displayRectangle(const vpImage< unsigned char > &I, const vpImagePoint &topLeft, unsigned int width, unsigned int height, const vpColor &color, bool fill=false, unsigned int thickness=1)
static void displayText(const vpImage< unsigned char > &I, const vpImagePoint &ip, const std::string &s, const vpColor &color)
error that can be emitted by ViSP classes.
static void read(vpImage< unsigned char > &I, const std::string &filename, int backend=IO_DEFAULT_BACKEND)
static void write(const vpImage< unsigned char > &I, const std::string &filename, int backend=IO_DEFAULT_BACKEND)
Class that defines a 2D point in an image. This class is useful for image processing and stores only ...
unsigned int getWidth() const
unsigned int getHeight() const
static bool parse(int *argcPtr, const char **argv, vpArgvInfo *argTable, int flags)
void display(vpImage< unsigned char > &I, const std::string &title)
Display a gray-scale image.