Warning: this project is deprecated (aka broken)

What is this repository for?

A 3D table tennis software, developed by Teseo Schneider. There are two versions of the software:

• the v1, which is in the root folder and runs with the Kinect 1 (the "old" one)
• the v2, which is in the v2 folder and runs with the Kinect 2, so only on Windows 8 and up.

How do I get set up?

This works on Windows only. You need:

• C++ compiler
• Qt5
• OpenCV
• Kinect SDK or libfreenect2 (see below)

Note: as of September 2021, the latest Nvidia driver that supports stereo 3D is the 425.31, be sure to not use a more recent one!

• Install Visual Studio (the community version is free) to obtain the C++ compiler. Select "Desktop development"
• Install the Kinect SDK:
  • for the v1, install the official Kinect SDK v1.7
  • for the v2, install the official Kinect SDK v2. If you are on Windows 7, you can try using libfreenect2 via vcpkg
• Download Qt5 from the official website. Choose the Open Source version, install it in C:\
• Download OpenCV from their Sourceforge page and extract in C:\
• Set the environment variable QT_PATH to the installation of Qt (e.g. C:\Qt\5.12.11\msvc2019)
• Add the Qt and OpenCV bin folders (e.g. C:\Qt\5.12.11\msvc2019\bin and C:\opencv\build\x64\vc15\bin) to PATH and reboot your machine

Compiling

v1

• Open the cmake GUI
• Under "Where is the source code", select the root folder of the project
• Under "Where to build the binaries" select the bin folder in the root directory
• Click "Configure" and choose your version of Visual Studio
• Click "Generate" to generate the Visual Studio solution
• Click "Open Project" to open it
• In Visual Studio, choose "Release" instead of "Debug"
• Under "Build" choose "Build Solution"
• Open bin\Release\3DTableTennis.exe
• If you have DLL errors, delete them and run windeployqt bin\Release\3DTableTennis.exe

v2

• Open the tableTennis.sln file from the v2 folder
• In Visual Studio, choose "Release" instead of "Debug"
• Under "Build" choose "Build solution"
• Open v2\release\tableTennis.exe
• If you have DLL errors, delete them and run windeployqt v2\release\tableTennis.exe
• If the system complains about a missing glew32.dll copy it in the v2\release\ folder from v2\3rdParty\glew\bin\Release\Win32

Run @ USI

See these instructions