Software | Core 2.3 | Linux Minimal Client
Note: This article applies to both Prime 3 Haptic XR Gloves and Prime 3 Mocap Gloves
Note: This article applies to both Quantum Mocap Metagloves and Quantum XR Metagloves.
Introduction
A version of our SDK Minimal Client example app is provided with our Linux SDK. It serves as an example of setting up the essentials and how to interact with our SDK.
For more detailed information about the minimal client, please refer to the SDK minimal client documentation or for more advanced use, check out the SDK client documentation.
Compiling
For compiling the app, we have three different options:
- Make
- Visual Studio Code
- Visual Studio (Cross Compile)
Make sure you have your prerequisite packages installed and set up according to the installation guide.
Make
A Make file is present within the SDKMinimalCLient_Linux folder inside the MANUS SDK package. The example can be compiled using the following command:
This creates a SDKMinimalClient.out file within the project root that can be run.
Visual Studio Code
A VScode workspace file is provided with the SDK package. Once opened, you should be able to run the app directly from VScode, and it will create a SDKMinimalClient.cpp.out file within the project root.
Open the SDKMinimalClient.cpp file and press F5 to start debugging. It should compile and run the project.
Visual Studio on Windows (remote cross compilation)
Cross-compiling using Visual Studio requires you to have a Linux system to connect to. This can be whatever you prefer; our preference goes out to a Docker container.
We've provided a Dockerfile inside the SDKMinimalClient_Linux SDK package. Please refer to our installation guide on how to use it.
Visual Studio Remote Connection
To connect Visual Studio to your remote machine, follow the steps outlined in the official Microsoft documentation. If you have your environment set up through docker, use localhost as the host and 5000 for the port, and for username and password, use whatever you replaced it with in the Dockerfile.
Additional Include Directories
Ensure that you configure Visual Studio to include any additional include directories and linker settings:
- Add the location of the MANUS headers to C/C++ > General > Additional Include Directories. For example ~/manus/Include.
Additional Dependencies
- Add the location of the libManusSDK.so file and directory to Linker > Input > Additional Dependencies. For example ~/manus/Lib/libManusSDK.so.
You should now be able to compile the example using Visual Studio.
