|
@@ -3,17 +3,32 @@
|
|
|
|
|
|
## How to start
|
|
|
|
|
|
-First run cmake to create a Makefile
|
|
|
+First create a build folder
|
|
|
```bash
|
|
|
-cmake .
|
|
|
+mkdir build && cd build
|
|
|
+```
|
|
|
+Then run cmake to create a Makefile
|
|
|
+```bash
|
|
|
+cmake ..
|
|
|
```
|
|
|
|
|
|
-Then run make to build the project
|
|
|
+Run make to build the project
|
|
|
```bash
|
|
|
make
|
|
|
```
|
|
|
|
|
|
-Execute the built file
|
|
|
+Execute the compiled project (use sudo when on macOS, see *known issue(s)*)
|
|
|
```bash
|
|
|
./3d-scanner
|
|
|
-```
|
|
|
+```
|
|
|
+
|
|
|
+
|
|
|
+## known issue(s)
|
|
|
+
|
|
|
+On Mac there can occure either segmentation faults or a realsense error, that the program is waiting too long for frames, when running the executable.
|
|
|
+Somehow it will work again if you just execute the 3d-scanner-startup-helper often enough (this is basically the realsense hello-world example).
|
|
|
+This will also fail a lot with a segmentation faults but after a while it will work again. At least as long as the camera is connected, when reconnecting the error usually appears again.
|
|
|
+I am not sure if this Error is Mac specific or wheater I am doing something wrong. However I did not manage to resolve it properly.
|
|
|
+If you have any Idea what the reason could be, feel free to contact me.
|
|
|
+
|
|
|
+Another inconvenience I discovered on Mac is, that the executable can only be executed using `sudo`, otherwise it will always fail with a segmentation fault.
|