### Run ViSP displayGDI example Source: https://github.com/lagadic/visp/blob/master/doc/tutorial/windows/tutorial-install-win10-msvc16.dox Demonstrates how to run the displayGDI.exe example after installation. ```shell C:\> cd %VISP_WS%\visp-build-vc16\example\device\display\Release C:\> displayGDI.exe A click to close the windows... A click to display a cross... Cross position: 392, 306 A click to exit the program... Bye ``` -------------------------------- ### Run ViSP displayX example Source: https://github.com/lagadic/visp/blob/master/doc/tutorial/unix/tutorial-install-jetson-quasar.dox Example command to run the displayX example and its expected output. ```bash $ cd $VISP_WS/visp-build $ ./example/device/display/displayX A click to close the windows... A click to display a cross... Cross position: 201, 441 A click to exit the program... Bye ``` -------------------------------- ### Testing ViSP Installation with displayX Example Source: https://github.com/lagadic/visp/blob/master/doc/tutorial/unix/tutorial-install-fedora.dox This command executes the displayX example from ViSP, which should open a window displaying an image and overlay drawings. ```bash $ cd $VISP_WS/visp-build $ ./example/device/display/displayX ``` -------------------------------- ### Test displayX example Source: https://github.com/lagadic/visp/blob/master/doc/tutorial/unix/tutorial-install-ubuntu.dox Runs the displayX example to test the data set usage, which should open a window with an image and overlay drawings. ```bash $ cd ${VISP_WS}/visp-build $ ./example/device/display/displayX ``` -------------------------------- ### Run RealSense capture example Source: https://github.com/lagadic/visp/blob/master/doc/tutorial/unix/tutorial-install-jetson-quasar.dox Executes the rs-capture example to verify librealsense installation. ```bash $ ./examples/capture/rs-capture ``` -------------------------------- ### Test ViSP example Source: https://github.com/lagadic/visp/blob/master/doc/tutorial/windows/tutorial-install-win11-msvc18.dox Commands to navigate to an example executable and run it. ```shell C:\> cd %VISP_WS%\visp-build-vc18\example\device\display\Release C:\> displayGDI.exe ``` -------------------------------- ### Start graphical user interface Source: https://github.com/lagadic/visp/blob/master/doc/tutorial/unix/tutorial-install-raspberry.dox Command to start the graphical user interface on Raspberry Pi. ```bash startx ``` -------------------------------- ### Building the model-based tracker module (mbt) Source: https://github.com/lagadic/visp/blob/master/doc/tutorial/unix/tutorial-install-raspberry.dox Example of building the model-based tracker module. ```bash cd $VISP_WS/visp-build make -j4 visp_mbt ``` -------------------------------- ### Run ViSP example Source: https://github.com/lagadic/visp/blob/master/doc/tutorial/windows/tutorial-install-win10-msvc15.dox Commands to navigate to the directory of a ViSP example executable and run it. ```shell C:\> cd %VISP_WS%\visp-build-vc15\example\device\display\Release C:\> displayGDI.exe ``` -------------------------------- ### Test ViSP Example: displayGDI Source: https://github.com/lagadic/visp/blob/master/doc/tutorial/windows/tutorial-install-win11-mingw-w64.dox Commands to navigate to the display example directory and run the displayGDI executable. ```bash C:\> cd %VISP_WS%\visp-build-mingw\example\device\display C:\> displayGDI.exe ``` -------------------------------- ### Launch mbt example with Python bindings Source: https://github.com/lagadic/visp/blob/master/doc/tutorial/python/tutorial-install-python-bindings.dox Steps to run a ViSP Python example for model-based tracking, including installing OpenCV and setting an environment variable. ```bash (venv) % cd visp/modules/python/examples (venv) % pip install opencv-python (venv) % export OPENCV_IO_ENABLE_OPENEXR=1 (venv) % python synthetic_data_mbt.py --data-root ../../../tutorial/tracking/model-based/generic-rgbd-blender ``` -------------------------------- ### Example ViSP Third-Party Configuration File Source: https://github.com/lagadic/visp/blob/master/doc/tutorial/unix/tutorial-install-fedora.dox An example of the content found in the ViSP-third-party.txt file, detailing detected third-party libraries and build configurations. ```text $ cat $VISP_WS/visp-build/ViSP-third-party.txt ========================================================== General configuration information for ViSP 3.4.1 Version control: v3.4.0-306-g318d05132 Platform: Timestamp: 2022-01-24T17:53:54Z Host: Linux 5.15.16-200.fc35.x86_64 x86_64 CMake: 3.22.1 CMake generator: Unix Makefiles CMake build tool: /usr/bin/gmake Configuration: Release C/C++: Built as dynamic libs?: yes C++ Compiler: /usr/lib64/ccache/c++ (ver 11.2.1) C++ flags (Release): -Wall -Wextra -fopenmp -std=c++14 -fvisibility=hidden -msse2 -msse3 -mssse3 -fPIC -O3 -DNDEBUG C++ flags (Debug): -Wall -Wextra -fopenmp -std=c++14 -fvisibility=hidden -msse2 -msse3 -mssse3 -fPIC -g C Compiler: /usr/lib64/ccache/cc C flags (Release): -Wall -Wextra -fopenmp -std=c++14 -fvisibility=hidden -msse2 -msse3 -mssse3 -fPIC -O3 -DNDEBUG C flags (Debug): -Wall -Wextra -fopenmp -std=c++14 -fvisibility=hidden -msse2 -msse3 -mssse3 -fPIC -g Linker flags (Release): Linker flags (Debug): ViSP modules: To be built: core gui imgproc io java_bindings_generator klt me sensor ar blob robot visual_features vs vision detection mbt tt tt_mi Disabled: - Disabled by dependency: - Unavailable: java Python (for build): /usr/bin/python Java: ant: NO JNI: /usr/lib/jvm/java/include /usr/lib/jvm/java/include/linux /usr/lib/jvm/java/include Build options: Build deprecated: yes Build with moment combine: no Mathematics: Blas/Lapack: yes - Use MKL: no - Use OpenBLAS: no - Use Atlas: no - Use Netlib: no - Use GSL: yes (ver 2.6) - Use Lapack (built-in): no Use Eigen3: yes (ver 3.3.9) Use OpenCV: yes (ver 4.5.3) Simulator: Ogre simulator: - Use Ogre3D: yes (ver 1.9.0) - Use OIS: yes (ver 1.3.0) Coin simulator: - Use Coin3D: yes (ver 3.1.3) - Use SoWin: no - Use SoXt: no - Use SoQt: no - Use Qt5: no - Use Qt4: no - Use Qt3: no Media I/O: Use JPEG: yes (ver 62) Use PNG: yes (ver 1.6.37) - Use ZLIB: yes (ver 1.2.11) Use OpenCV: yes (ver 4.5.3) Use stb_image (built-in): no Real robots: Use Afma6: no Use Franka: no Use Viper650: no Use Viper850: no Use Kinova Jaco: no Use aria (Pioneer): no Use PTU46: no Use Biclops PTU: no Use Flir PTU SDK: no Use Parrot ARSDK: no -Use ffmpeg: no Use Virtuose: no Use qbdevice (built-in): yes (ver 2.6.0) Use takktile2 (built-in): yes (ver 1.0.0) GUI: Use X11: yes Use GTK: no Use OpenCV: yes (ver 4.5.3) Use GDI: no Use Direct3D: no Cameras: Use DC1394-2.x: yes (ver 2.2.6) Use CMU 1394: no Use V4L2: yes (ver 1.22.1) Use directshow: no Use OpenCV: yes (ver 4.5.3) Use FLIR Flycapture: no Use Basler Pylon: no Use IDS uEye: no RGB-D sensors: Use Realsense: no Use Realsense2: no Use Occipital Structure: no Use Kinect: no - Use libfreenect: no - Use libusb-1: no - Use pthread: yes Use PCL: yes (ver 1.12.0) - Use VTK: yes (ver 9.0.3) F/T sensors: Use atidaq (built-in): no Use comedi: no Use IIT SDK: no Detection: Use zbar: yes (ver 0.23) Use dmtx: yes (ver 0.7.5) Use AprilTag (built-in): yes (ver 3.1.1) - Use AprilTag big family: no Misc: ``` -------------------------------- ### Get librealsense from GitHub Source: https://github.com/lagadic/visp/blob/master/doc/tutorial/unix/tutorial-install-jetson-quasar.dox Clones the librealsense repository and navigates into its directory. ```bash $ cd $VISP_WS/3rdparty $ git clone https://github.com/IntelRealSense/librealsense.git $ cd librealsense ``` -------------------------------- ### Get librealsense from GitHub Source: https://github.com/lagadic/visp/blob/master/doc/tutorial/unix/tutorial-install-ubuntu.dox Clones the librealsense repository into the specified directory. ```bash $ mkdir -p ${VISP_WS}/3rdparty $ cd ${VISP_WS}/3rdparty $ git clone https://github.com/IntelRealSense/librealsense.git $ cd librealsense ``` -------------------------------- ### Get dataset from GitHub Source: https://github.com/lagadic/visp/blob/master/doc/tutorial/unix/tutorial-install-ubuntu.dox Clones the latest version of the ViSP dataset from GitHub. ```bash C:\> cd ${VISP_WS} C:\> git clone https://github.com/lagadic/visp-images.git ``` -------------------------------- ### Get ViSP source code Source: https://github.com/lagadic/visp/blob/master/doc/tutorial/unix/tutorial-install-ubuntu.dox Clones the ViSP source code repository into the workspace. ```shell $ cd ${VISP_WS} $ git clone https://github.com/lagadic/visp.git ``` -------------------------------- ### Build the new example Source: https://github.com/lagadic/visp/blob/master/doc/tutorial/developper/tutorial-add-new-dependency.dox Commands to configure ViSP and build the new example. ```bash $ cd $VISP_WS/visp-build $ cmake ../visp $ make exampleDummy ``` -------------------------------- ### Get OpenJDK info with brew on Mac OSX (symlink instruction) Source: https://github.com/lagadic/visp/blob/master/doc/tutorial/java/tutorial-install-java.dox Example output from 'brew info openjdk' showing the symlink instruction. ```shell $ brew info openjdk For the system Java wrappers to find this JDK, symlink it with sudo ln -sfn /opt/homebrew/opt/openjdk/libexec/openjdk.jdk /Library/Java/JavaVirtualMachines/openjdk.jdk ``` -------------------------------- ### Install Source: https://github.com/lagadic/visp/blob/master/INSTALL.txt Command to install ViSP after compilation. ```bash > make install ``` -------------------------------- ### Pip Install Setup Source: https://github.com/lagadic/visp/blob/master/modules/python/bindings/CMakeLists.txt Configures the setup for installing the Python module using pip. ```cmake if(PYTHON3INTERP_FOUND) configure_file("${CMAKE_CURRENT_SOURCE_DIR}/setup.py.in" "${CMAKE_CURRENT_BINARY_DIR}/setup.py" @ONLY) add_custom_target( visp_python_bindings_install COMMAND ${CMAKE_COMMAND} -E copy_directory "${CMAKE_CURRENT_SOURCE_DIR}/visp" "${CMAKE_CURRENT_BINARY_DIR}/visp" COMMAND ${PYTHON3_EXECUTABLE} -m pip install ${_pip_args} "${CMAKE_CURRENT_BINARY_DIR}" DEPENDS _visp ) endif() ``` -------------------------------- ### Build Instructions Source: https://github.com/lagadic/visp/blob/master/doc/tutorial/bridge/matlab/tutorial-visp-matlab.dox Instructions on how to build the example project from the command line. ```bash cd tutorial/matlab mkdir build && cd build cmake .. -DVISP_DIR= ``` -------------------------------- ### Get OpenJDK info with brew on Mac OSX Source: https://github.com/lagadic/visp/blob/master/doc/tutorial/java/tutorial-install-java.dox Command to get information about the installed OpenJDK version. ```shell $ brew info openjdk ``` -------------------------------- ### Run tutorial-viewer example (Windows) Source: https://github.com/lagadic/visp/blob/master/doc/tutorial/started/tutorial-getting-started.dox This command navigates to the Release directory and runs the 'tutorial-viewer' example. ```shell C:\> cd Release C:\> tutorial-viewer.exe monkey.pgm ``` -------------------------------- ### Quick Install Source: https://github.com/lagadic/visp/blob/master/INSTALL.txt A concise set of commands for a quick installation of ViSP. ```bash > get ViSP source > install CMake (see http://www.cmake.org) > cmake . > make > make install ``` -------------------------------- ### Install recommended 3rd party libraries Source: https://github.com/lagadic/visp/blob/master/doc/tutorial/unix/tutorial-install-jetson-quasar.dox Installs a minimal set of recommended third-party libraries for ViSP. ```bash $ sudo apt-get install libx11-dev liblapack-dev libeigen3-dev libv4l-dev libzbar-dev libpthread-stubs0-dev libjpeg-dev libpng-dev ``` -------------------------------- ### Install ViSP images data Source: https://github.com/lagadic/visp/blob/master/doc/tutorial/package/tutorial-install-ubuntu-package.dox Installs the ViSP images dataset, which is useful for running ViSP examples. ```bash $ sudo apt-get install visp-images-data ``` -------------------------------- ### Run ViSP viewer tutorial Source: https://github.com/lagadic/visp/blob/master/doc/tutorial/docker/tutorial-install-docker.dox Run a ViSP viewer tutorial binary within the Docker container. ```bash vispci@6c8d67579659:~$ cd $HOME/visp-ws/visp-build/tutorial/image vispci@6c8d67579659:~$ ./tutorial-viewer monkey.jpeg A click to quit... ``` -------------------------------- ### Run tutorial-viewer example (Unix) Source: https://github.com/lagadic/visp/blob/master/doc/tutorial/started/tutorial-getting-started.dox This command runs the 'tutorial-viewer' example with an input image. ```shell $ ./tutorial-viewer monkey.pgm ``` -------------------------------- ### Qualisys SDK Build Error Example Source: https://github.com/lagadic/visp/blob/master/doc/tutorial/windows/tutorial-install-win10-msvc16.dox Example of a build error encountered during Qualisys SDK installation, indicating a need for administrative privileges. ```shell C:\visp-ws\3rdparty\qualisys\qualisys_cpp_sdk\build>cmake --build . --config Release --target install Microsoft (R) Build Engine version 16.3.2+e481bbf88 pour .NET Framework Copyright (C) Microsoft Corporation. Tous droits réservés. Checking Build System Building Custom Rule C:/visp-ws/3rdparty/qualisys/qualisys_cpp_sdk/CMakeLists.txt Markup.cpp Network.cpp RTPacket.cpp RTProtocol.cpp Génération de code en cours... qualisys_cpp_sdk.vcxproj -> C:\visp-ws\3rdparty\qualisys\qualisys_cpp_sdk\build\Release\qualisys_cpp_sdk.lib Building Custom Rule C:/visp-ws/3rdparty/qualisys/qualisys_cpp_sdk/CMakeLists.txt RigidBodyStreaming.cpp RigidBodyStreaming.vcxproj -> C:\visp-ws\3rdparty\qualisys\qualisys_cpp_sdk\build\Release\RigidBodyStreaming.exe Building Custom Rule C:/visp-ws/3rdparty/qualisys/qualisys_cpp_sdk/CMakeLists.txt -- Install configuration: "Release" CMake Error at cmake_install.cmake:48 (file): file cannot create directory: C:/Program Files/qualisys_cpp_sdk/lib/qualisys_cpp_sdk. Maybe need administrative privileges. ``` -------------------------------- ### Install recommended 3rd parties for ViSP Source: https://github.com/lagadic/visp/blob/master/doc/tutorial/unix/tutorial-install-raspberry.dox Command to install a minimal set of recommended third-party libraries for ViSP. ```bash $ sudo apt-get install libopencv-dev libx11-dev liblapack-dev libeigen3-dev libv4l-dev \ libzbar-dev libpthread-stubs0-dev libjpeg-dev libpng-dev ``` -------------------------------- ### Uninstall Source: https://github.com/lagadic/visp/blob/master/INSTALL.txt Command to uninstall ViSP. ```bash > make uninstall ``` -------------------------------- ### Create a workspace Source: https://github.com/lagadic/visp/blob/master/doc/tutorial/unix/tutorial-install-ubuntu.dox Sets up the VISP_WS environment variable and creates the workspace directory. ```shell $ echo "export VISP_WS=$HOME/visp-ws" >> ~/.bashrc $ source ~/.bashrc $ mkdir -p ${VISP_WS} ``` -------------------------------- ### Generate Documentation with MathJax Source: https://github.com/lagadic/visp/blob/master/doc/tutorial/unix/tutorial-install-raspberry.dox Command to generate ViSP documentation with MathJax support. ```bash $ cmake ../visp -DUSE_MATHJAX=ON $ make -j4 visp_doc ``` -------------------------------- ### CMake Warning Example Source: https://github.com/lagadic/visp/blob/master/doc/tutorial/unix/tutorial-install-centos.dox A common CMake warning encountered during ViSP installation on CentOS related to libpthread. ```cmake CMake Warning at src/CMakeLists.txt:80 (add_library): Cannot generate a safe runtime search path for target visp because files in some directories may conflict with libraries in implicit directories: runtime library [libpthread.so] in /usr/lib64 may be hidden by files in: //lib64 Some of these libraries may not be found correctly. ``` -------------------------------- ### Install recommended 3rd parties (Ubuntu 20.04 or Debian 11) Source: https://github.com/lagadic/visp/blob/master/doc/tutorial/unix/tutorial-install-ubuntu.dox Installs a set of recommended third-party libraries for newer Ubuntu/Debian versions. ```shell $ sudo apt-get install libopencv-dev libx11-dev liblapack-dev libeigen3-dev libv4l-dev \n libzbar-dev libpthread-stubs0-dev libdc1394-dev nlohmann-json3-dev ``` -------------------------------- ### Build tutorial-viewer example (Unix) Source: https://github.com/lagadic/visp/blob/master/doc/tutorial/started/tutorial-getting-started.dox This command builds the 'tutorial-viewer' example using make. ```shell $ make tutorial-viewer ``` -------------------------------- ### Get information on ViSP package Source: https://github.com/lagadic/visp/blob/master/doc/tutorial/package/tutorial-install-osx-homebrew-package.dox Commands to update Homebrew and get information about the visp package. ```bash $ brew update $ brew info visp ``` -------------------------------- ### Clean Source: https://github.com/lagadic/visp/blob/master/INSTALL.txt Command to clean build artifacts. ```bash > make clean ``` -------------------------------- ### CMake Warning Example Source: https://github.com/lagadic/visp/blob/master/doc/tutorial/windows/tutorial-install-win10-msvc16.dox An example of a CMake warning related to Eigen3 configuration. ```shell CMake Warning at CMakeLists.txt:1156 (message): Eigen3 config file is detected in C:/visp-ws/eigen-3.3.9/build-vc16. Using C:/visp-ws/eigen-3.3.9/build-vc16/Eigen3Config.cmake doesn't allow to use a valid Eigen3 include dir: C://include/eigen3. Modify Eigen3_DIR to point to Eigen3Config.cmake file located in Eigen3 installation folder or turn USE_EIGEN3 OFF. ``` -------------------------------- ### Build ViSP documentation with full documentation enabled Source: https://github.com/lagadic/visp/blob/master/doc/tutorial/unix/tutorial-install-ubuntu.dox Configures ViSP build with ENABLE_FULL_DOC set to ON and then builds the documentation. ```shell $ cmake ../visp -DENABLE_FULL_DOC=ON $ make -j$(nproc) visp_doc ``` -------------------------------- ### Install recommended 3rd parties (Older Ubuntu or Debian) Source: https://github.com/lagadic/visp/blob/master/doc/tutorial/unix/tutorial-install-ubuntu.dox Installs a set of recommended third-party libraries for older Ubuntu/Debian versions. ```shell $ sudo apt-get install libopencv-dev libx11-dev liblapack-dev libeigen3-dev libv4l-dev \n libzbar-dev libpthread-stubs0-dev libdc1394-22-dev ``` -------------------------------- ### Build Error Example Source: https://github.com/lagadic/visp/blob/master/doc/tutorial/python/tutorial-install-python-bindings.dox This is an example of a build error encountered during the installation process, specifically a ModuleNotFoundError for 'yaml'. ```bash File "", line 992, in _find_and_load_unlocked File "", line 241, in _call_with_frames_removed File "", line 1050, in _gcd_import File "", line 1027, in _find_and_load File "", line 992, in _find_and_load_unlocked File "", line 241, in _call_with_frames_removed File "", line 1050, in _gcd_import File "", line 1027, in _find_and_load File "", line 1006, in _find_and_load_unlocked File "", line 688, in _load_unlocked File "", line 883, in exec_module File "", line 241, in _call_with_frames_removed File "/opt/ros/humble/lib/python3.10/site-packages/launch_testing/__init__.py", line 15, in from . import tools File "/opt/ros/humble/lib/python3.10/site-packages/launch_testing/tools/__init__.py", line 18, in from .process import launch_process File "/opt/ros/humble/lib/python3.10/site-packages/launch_testing/tools/process.py", line 17, in import launch File "/opt/ros/humble/lib/python3.10/site-packages/launch/__init__.py", line 17, in from . import actions File "/opt/ros/humble/lib/python3.10/site-packages/launch/actions/__init__.py", line 17, in from .declare_launch_argument import DeclareLaunchArgument File "/opt/ros/humble/lib/python3.10/site-packages/launch/actions/declare_launch_argument.py", line 22, in import launch.logging File "/opt/ros/humble/lib/python3.10/site-packages/launch/logging/__init__.py", line 32, in from ..frontend import expose_substitution File "/opt/ros/humble/lib/python3.10/site-packages/launch/frontend/__init__.py", line 17, in from . import type_utils File "/opt/ros/humble/lib/python3.10/site-packages/launch/frontend/type_utils.py", line 22, in from .entity import Entity File "/opt/ros/humble/lib/python3.10/site-packages/launch/frontend/entity.py", line 22, in from launch.utilities.type_utils import AllowedTypesType File "/opt/ros/humble/lib/python3.10/site-packages/launch/utilities/type_utils.py", line 29, in import yaml ModuleNotFoundError: No module named 'yaml' make[3]: *** [modules/python/test/CMakeFiles/visp_python_bindings_test.dir/build.make:71: modules/python/test/CMakeFiles/visp_python_bindings_test] Error 1 make[2]: *** [CMakeFiles/Makefile2:2278: modules/python/test/CMakeFiles/visp_python_bindings_test.dir/all] Error 2 make[1]: *** [CMakeFiles/Makefile2:2285: modules/python/test/CMakeFiles/visp_python_bindings_test.dir/rule] Error 2 make: *** [Makefile:702: visp_python_bindings_test] Error 2 (venv) $ ``` -------------------------------- ### Listing available make targets Source: https://github.com/lagadic/visp/blob/master/doc/tutorial/unix/tutorial-install-raspberry.dox Command to list available targets with 'make' and filter for ViSP-related targets. ```bash make help | grep visp ``` -------------------------------- ### Compile Source: https://github.com/lagadic/visp/blob/master/INSTALL.txt Command to compile the ViSP library after configuration. ```bash > make ``` -------------------------------- ### Install ViSP html documentation Source: https://github.com/lagadic/visp/blob/master/doc/tutorial/package/tutorial-install-ubuntu-package.dox Installs the ViSP HTML documentation. ```bash $ sudo apt-get install visp-doc ``` -------------------------------- ### Create build directory Source: https://github.com/lagadic/visp/blob/master/doc/tutorial/unix/tutorial-install-ubuntu.dox Creates a directory named 'visp-build' to store build materials. ```shell $ mkdir ${VISP_WS}/visp-build ``` -------------------------------- ### Install cuDNN Runtime Library Source: https://github.com/lagadic/visp/blob/master/doc/tutorial/detection_dnn/tutorial-detection-tensorrt.dox Example command to install cuDNN using dpkg for Ubuntu. ```bash $ sudo dpkg -i libcudnn8_8.2.0.53-1+cuda11.3_amd64.deb ``` -------------------------------- ### CMakeLists.txt Configuration Source: https://github.com/lagadic/visp/blob/master/example/particle-filter/CMakeLists.txt This snippet shows the CMake configuration for the particle filter example, including project setup, dependency finding, and target definition. ```cmake cmake_minimum_required(VERSION 3.10) project(example-kalman) find_package(VISP REQUIRED visp_core visp_gui) set(example_cpp) list(APPEND example_cpp pf-nonlinear-example.cpp) list(APPEND example_cpp pf-nonlinear-complex-example.cpp) foreach(cpp ${example_cpp}) visp_add_target(${cpp}) if(COMMAND visp_add_dependency) visp_add_dependency(${cpp} "examples") endif() endforeach() visp_add_test(pf-nonlinear-example-monothread pf-nonlinear-example -c ${SHORT_OPTION_TO_DISABLE_DISPLAY} --dt 3 --stdev-range 5 --stdev-elev-angle 0.5 --stdev-aircraft-vel 0.2> --gt-X0 -500 --gt-Y0 1000 --gt-vX0 10 --gt-vY0 5 --max-distance-likelihood 50 -N 500 --seed 4224 --nb-threads 1 --ampli-max-X 20 --ampli-max-Y 200 --ampli-max-vX 1 --ampli-max-vY 0.5) visp_add_test(pf-nonlinear-example-multithread pf-nonlinear-example -c ${SHORT_OPTION_TO_DISABLE_DISPLAY} --dt 3 --stdev-range 5 --stdev-elev-angle 0.5 --stdev-aircraft-vel 0.2> --gt-X0 -500 --gt-Y0 1000 --gt-vX0 10 --gt-vY0 5 --max-distance-likelihood 50 -N 500 --seed 4224 --nb-threads -1 --ampli-max-X 20 --ampli-max-Y 200 --ampli-max-vX 1 --ampli-max-vY 0.5) visp_add_test(pf-nonlinear-complex-example-monothread pf-nonlinear-complex-example -c ${SHORT_OPTION_TO_DISABLE_DISPLAY} --max-distance-likelihood 0.5 --ampli-max-X 0.25 --ampli-max-Y 0.25 --ampli-max-theta 0.1 -N 500 --nb-threads 1) visp_add_test(pf-nonlinear-complex-example-multithread pf-nonlinear-complex-example -c ${SHORT_OPTION_TO_DISABLE_DISPLAY} --max-distance-likelihood 0.5 --ampli-max-X 0.25 --ampli-max-Y 0.25 --ampli-max-theta 0.1 -N 500 --nb-threads -1) ``` -------------------------------- ### Install MathJax and build documentation Source: https://github.com/lagadic/visp/blob/master/doc/tutorial/unix/tutorial-install-raspberry.dox Commands to install MathJax and build ViSP documentation, potentially speeding up formula rendering. ```bash $ npm install mathjax ``` -------------------------------- ### Qualisys SDK Build Output Example Source: https://github.com/lagadic/visp/blob/master/doc/tutorial/windows/tutorial-install-win10-msvc17.dox Example output from building the Qualisys SDK with CMake. ```sh C:\visp-ws\3rdparty\qualisys\qualisys_cpp_sdk\build>cmake --build . --config Release --target install Microsoft (R) Build Engine version 16.3.2+e481bbf88 pour .NET Framework Copyright (C) Microsoft Corporation. Tous droits réservés. Checking Build System Building Custom Rule C:/visp-ws/3rdparty/qualisys/qualisys_cpp_sdk/CMakeLists.txt Markup.cpp Network.cpp RTPacket.cpp RTProtocol.cpp Génération de code en cours... qualisys_cpp_sdk.vcxproj -> C:\visp-ws\3rdparty\qualisys\qualisys_cpp_sdk\build\Release\qualisys_cpp_sdk.lib Building Custom Rule C:/visp-ws/3rdparty/qualisys/qualisys_cpp_sdk/CMakeLists.txt RigidBodyStreaming.cpp ``` -------------------------------- ### Running videoReader example Source: https://github.com/lagadic/visp/blob/master/doc/tutorial/unix/tutorial-install-centos.dox Command to run the videoReader example, which may hang on CentOS 7.0 due to a buggy OpenCV version. ```bash ./example/video/videoReader ``` -------------------------------- ### Build and install ViSP libraries Source: https://github.com/lagadic/visp/blob/master/doc/tutorial/unix/tutorial-install-jetson-quasar.dox Commands to build and install ViSP libraries after configuration. ```bash $ cd $VISP_WS/visp-build $ make -j4 $ sudo make install ``` -------------------------------- ### CMakeLists.txt Configuration Source: https://github.com/lagadic/visp/blob/master/example/servo-pioneer/CMakeLists.txt This snippet shows the CMake configuration for the servo-pioneer example, including project setup, finding ViSP packages, and defining executable targets. ```cmake # # ViSP, open source Visual Servoing Platform software. # Copyright (C) 2005 - 2025 by Inria. All rights reserved. # # This software is free software; you can redistribute it and/or modify # it under the terms of the GNU General Public License as published by # the Free Software Foundation; either version 2 of the License, or # (at your option) any later version. # See the file LICENSE.txt at the root directory of this source # distribution for additional information about the GNU GPL. # # For using ViSP with software that can not be combined with the GNU # GPL, please contact Inria about acquiring a ViSP Professional # Edition License. # # See https://visp.inria.fr for more information. # # This software was developed at: # Inria Rennes - Bretagne Atlantique # Campus Universitaire de Beaulieu # 35042 Rennes Cedex # France # # If you have questions regarding the use of this file, please contact # Inria at visp@inria.fr # # This file is provided AS IS with NO WARRANTY OF ANY KIND, INCLUDING THE # WARRANTY OF DESIGN, MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. # # Description: # ViSP configuration file. # ############################################################################# cmake_minimum_required(VERSION 3.10) project(example-servo-pioneer) find_package(VISP REQUIRED visp_core visp_blob visp_vs visp_robot visp_sensor visp_gui) set(example_cpp movePioneer.cpp servoPioneerPoint2DDepth.cpp servoPioneerPoint2DDepthWithoutVpServo.cpp servoPioneerPanSegment3D.cpp sonarPioneerReader.cpp ) foreach(cpp ${example_cpp}) visp_add_target(${cpp}) if(COMMAND visp_add_dependency) visp_add_dependency(${cpp} "examples") endif() endforeach() ``` -------------------------------- ### Show available options Source: https://github.com/lagadic/visp/blob/master/doc/tutorial/tracking/tutorial-tracking-mb-generic-apriltag-live.dox Run the executable with the --help flag to display all available command-line options for the generic tracker. ```sh $ ./tutorial-mb-generic-tracker-apriltag-webcam --help ``` -------------------------------- ### Generate Documentation Source: https://github.com/lagadic/visp/blob/master/INSTALL.txt Command to generate Doxygen HTML documentation. ```bash > make visp_doc ``` -------------------------------- ### Example build command on Windows Source: https://github.com/lagadic/visp/blob/master/doc/tutorial/android/tutorial-create-android-sdk.dox Specific command for building the SDK on Windows. ```bash C:\> mkdir %VISP_WS%\visp-build-android C:\> cd %VISP_WS%\visp\platforms\android C:\> python3 build_sdk.py --config ndk-23.config.py --sdk_path %USERPROFILE%\AppData\Local\Android\Sdk --ndk_path %USERPROFILE%\AppData\Local\Android\Sdk\ndk\23.1.7779620 %VISP_WS%\visp-build-android %VISP_WS%\visp ``` -------------------------------- ### Install recommended 3rd parties Source: https://github.com/lagadic/visp/blob/master/doc/tutorial/unix/tutorial-install-raspberry.dox Command to install recommended third-party libraries for ViSP on Raspberry Pi. ```bash $ sudo apt-get install libopencv-dev libx11-dev liblapack-dev libeigen3-dev libv4l-dev \ libzbar-dev libpthread-stubs0-dev ``` -------------------------------- ### Install MathJax and build documentation Source: https://github.com/lagadic/visp/blob/master/doc/tutorial/windows/tutorial-install-win11-mingw-w64.dox Instructions for installing MathJax and building documentation, potentially speeding up rendering. ```bash npm install -g mathjax-node cmake --build . --config Release --target visp_doc ``` -------------------------------- ### How to run the tutorial Source: https://github.com/lagadic/visp/blob/master/doc/tutorial/misc/tutorial-spc.dox Commands to navigate to the tutorial directory and run the executable with help flag. ```bash $ cd $VISP_WS/visp-build/tutorial/mean-drift $ ./tutorial-meandrift -h ``` -------------------------------- ### Test ViSP data set usage Source: https://github.com/lagadic/visp/blob/master/doc/tutorial/windows/tutorial-install-win10-msvc17.dox Example command to run a ViSP example (displayGDI.exe) after setting up the dataset. ```shell C:\> cd %VISP_WS%\visp-build-vc17\example\device\display\Release C:\> displayGDI.exe ``` -------------------------------- ### Build and install librealsense Source: https://github.com/lagadic/visp/blob/master/doc/tutorial/unix/tutorial-install-jetson-quasar.dox Builds and installs the librealsense library. ```bash $ mkdir build && cd build $ cmake .. -DBUILD_EXAMPLES=ON -DCMAKE_BUILD_TYPE=Release $ make -j4 $ sudo make install ``` -------------------------------- ### Eigen3 Warning Example Source: https://github.com/lagadic/visp/blob/master/doc/tutorial/windows/tutorial-install-win11-msvc18.dox Example of a CMake warning related to Eigen3 configuration if the Eigen3_DIR environment variable is not set correctly. ```sh CMake Warning at CMakeLists.txt:1156 (message): Eigen3 config file is detected in C:/visp-ws/3rdparty/eigen-5.0.1/build-vc18. Using C:/visp-ws/3rdparty/eigen-5.0.1/build-vc18/Eigen3Config.cmake doesn't allow to use a valid Eigen3 include dir: C://include/eigen3. Modify Eigen3_DIR to point to Eigen3Config.cmake file located in Eigen3 installation folder or turn USE_EIGEN3 OFF. ``` -------------------------------- ### Install additional recommended 3rd party libraries Source: https://github.com/lagadic/visp/blob/master/doc/tutorial/unix/tutorial-install-jetson-quasar.dox Installs more recommended third-party libraries, including camera interface and image format support. ```bash $ sudo apt-get install libx11-dev liblapack-dev libeigen3-dev libv4l-dev libzbar-dev libpthread-stubs0-dev libdc1394-22-dev ``` -------------------------------- ### Example error during Python test building Source: https://github.com/lagadic/visp/blob/master/doc/tutorial/python/tutorial-install-python-bindings.dox This is an example of an error that may occur when building Python tests on Ubuntu 22.04 with ros-2 humble installed. ```sh ... [100%] Built target visp_python_bindings [100%] Installing dependencies to test Python bindings... Collecting numpy (from -r $VISP_WS/visp/modules/python/test/requirements.txt (line 1)) Downloading numpy-1.26.4-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.metadata (61 kB) ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 61.0/61.0 kB 1.3 MB/s eta 0:00:00 Collecting pytest (from -r $VISP_WS/visp/modules/python/test/requirements.txt (line 2)) ```