Wtf is ES3D for?
This is an old C++, Qt & OpenCV prototype that scans a live webcam feed for vertices and exports them to .xyz format (compatible with meshlab). It includes a few filters to better adapt the camera input to the edge detection algorithms like gamma and exposure, it also takes screenshots!
System requirements & dependencies
Installation
Last revised: 12/05/2022
1. Download and compile OpenCV v4+
wget -O opencv.zip https://github.com/opencv/opencv/archive/4.x.zip
unzip opencv.zip & cd opencv/
mkdir -p build && cd build
# Make sure to configure OpenCV with Qt support!
cmake -D CMAKE_BUILD_TYPE=RELEASE -D CMAKE_INSTALL_PREFIX=/usr/local -D OPENCV_GENERATE_PKGCONFIG=ON -D WITH_TBB=ON -D WITH_V4L=ON -D WITH_QT=ON -D WITH_OPENGL=ON ..
cmake --build .
sudo make install
2. Install Qt v5+
The binary from the official sit should do.
git clone {{dotfiles_git_link}}
mv dotfiles/awesome ~/.config/awesome/
mv dotfiles/terminal ~/.
3. Open the included es3d.pro file in QtCreator or compile it by calling qmake + make
F.A.Q. & Troubleshooting
What was the motivation behind this project?
The scanner was made to help a robot navigate a 3D environment from a webcam feed. A second program would read the scanners
coordinates and guide the machine accordingly. It was also used to take screenshots.
Will it ever be updated?
Because the synergy between Qt and OpenCV used to be terribly documented, I updated the code to Qt5 and OpenCV3. This is the last
update.
EDIT [06/10/2021] UPDATED TO RUN ON QT 5.12 & OPENCV 4.5
I'm having trouble compiling
Make sure to compile opencv from source with Qt support (disabled by default). The following cmake configure should work:
cmake -D CMAKE_BUILD_TYPE=RELEASE -D CMAKE_INSTALL_PREFIX=/usr/local -D OPENCV_GENERATE_PKGCONFIG=ON -D WITH_TBB=ON -D WITH_V4L=ON -D WITH_QT=ON -D WITH_OPENGL=ON ..
The included .pro QtCreator file uses pkg-config to include the opencv headers and libraries, though not all of them are required. Manually including opencv and removing troublesome
modules should work. Then select a qt 5 version kit in when confifguring the project in QtCreator. Presently, Qt 6+ has issues compiling with the multimedia module, but any version 5 kit should work.
My webcam doesn't appear on the selection list
Make sure its not currently used by another process and that it is being correctly recognized.
» lsusb
Bus 001 Device 003: ID 046d:082d Logitech, Inc. HD Pro Webcam C920
What are the dependencies?
q Qt5+ // GUI and file managing
q OpenCV // Webcam input feed and matrices
A big thank you to their respective authors.
What is the project's license? Do I have to pay or credit you in any way?
The project is MIT licensed and free.
