Camera SDK for Linux

An overview of the Linux version of the Camera SDK.

Overview

The Camera SDK for Linux provides hardware controls (cameras and hubs) and access to the most fundamental frame data, such as grayscale images and 2D object information, from each camera. Using the Camera SDK for Linux, you can develop your own image processing applications that utilize the capabilities of the OptiTrack cameras in either Ubuntu or Fedora.

The Camera SDK for Linux is a free tool available on the OptiTrack download site.

Note: 3D tracking features are not directly supported with Camera SDK but they are featured via the Motive API. For more information on the Camera SDK, visit our website.

The Camera SDK for Linux is compatible only with the same released version of Motive. For instance, if you are using Motive 3.4.0, download and use the Camera SDK version 3.4.0.

Features

• Camera hardware controls

• Receiving frame data and 2D object data from each camera

• Sample applications with source code

Contents

Unzip the Camera SDK for Linux from the OptiTrack downloads site. The

• (\CameraSDK\lib) Includes native C++ application library.

• (\CameraSDK\include) Includes header files for the SDK. Usage of each class is commented within the header files.

• (\CameraSDK\samples) Includes sample projects that employ the Camera SDK for Linux, including the CameraViewerApp. Source code for these applications are included for additional references.

Installation

Install Qt, Cmake and libjpeg on the Linux computer.

Ubuntu

ubuntu: sudo apt update && sudo apt install -y libjpeg-dev cmake qt6-base-dev

Fedora

sudo dnf update && sudo dnf install -y libjpeg-turbo-devel cmake qt6-qtbase-devel

Build the Executable

linuxBuild.sh

The sample file linuxBuild.sh is located in \CameraSDK\samples\CameraViewerApp.

Change the mode of the file to allow the user to read, write, and execute the file:

chmod +x linuxBuild.sh

Network Settings

Set the network port used for the camera system to use link local only. Go to:

Settings > Network > Wired Settings (port for cameras) > IPv4 > Ipv4Method.

Set the value to Link-Local Only.

Color Camera Installation

Additional software is required to include Prime Color Camera functionality.

Ubuntu

sudo apt install ffmpeg -y

Fedora

sudo dnf install ffmpeg ffmpeg-devel -y

Fedora users may be required to enable RPM fusion.

For the free version:

sudo dnf install https://download1.rpmfusion.org/free/fedora/rpmfusion-free-release-$(rpm -E %fedora).noarch.rpm

For the non-free version:

sudo dnf install https://download1.rpmfusion.org/nonfree/fedora/rpmfusion-nonfree-release-$(rpm -E %fedora).noarch.rpm

Run the Executable

Run the linuxBuild.sh file from the CameraViewerApp directory.

./linuxBuild.sh <Path-to-camera-sdk-path> 

To include Prime Color Cameras in the data capture, build using the flag --ffmpeg:

./linuxBuild.sh <Path-to-camera-sdk-path> --ffmpeg