Flowbit Server SDK
The SDK is a self-contained tree you copy to a PC and build against. It captures synchronized colour and depth from the cameras, groups multi-camera frames by capture time, and optionally runs 3D object segmentation through a separate detector service.
What the SDK is
The SDK is a self-contained tree you copy to a PC and build against. It captures synchronized colour and depth from the cameras, groups multi-camera frames by capture time, and optionally runs 3D object segmentation through a separate detector service.
Language: C++ · Platforms: Windows x64, Ubuntu 22.04, Ubuntu 24.04
The tree ships example sources, not prebuilt executables. The viewers and any application you write are compiled on the machine that will run them, against the exported package.
What's in the package
NOTE
There is no detector in this tree. The SDK is detector-agnostic: it talks to a 2D detector service over HTTP and does not ship, link to, or depend on any detection model. For the segmentation feature,
viewer_opengl_segment, download the detector separately and run it alongside the server. See Set up the detection system.
Choose the right platform tree
WARNING
The compiled libraries are platform-specific, so the SDK is exported as three separate trees — Windows x64, Ubuntu 22.04 and Ubuntu 24.04 — and you must use the one matching this machine.
The two Ubuntu trees are not interchangeable: their
.soare built against that release's system libraries, most importantly GStreamer (22.04 ships 1.20, 24.04 ships 1.24) and glibc, so a 22.04 tree will not load on 24.04 or the reverse.The folder layout and instructions are identical for all three — only the compiled binaries differ.
Your machine | Package | Download |
|---|---|---|
Windows x64 |
| |
Ubuntu 22.04 |
| |
Ubuntu 24.04 |
|
On Ubuntu, run lsb_release -d if you are not sure which release you have. Unpack the archive anywhere you can write to. That folder is <prefix> throughout this section.
Release and Debug builds
This export ships both Release and Debug builds of the SDK libraries. Build your application or the viewers in whichever configuration you want to link against — find_package(flowbit-server) picks the matching set per configuration automatically. The debug libraries carry a d suffix (for example flowbitserversystemd.dll) so the two sets never collide. A Release-only export simply omits the …/debug/ folders.
The four libraries
Module | Provides |
|---|---|
| System, config and logging |
|
|
|
|
| Optional: the 3D fusion half of segmentation. It calls the detector service over HTTP and lifts the masks into world space |
SDK prerequisites
You also need the NVIDIA CUDA runtime matching the build, and a GPU of RTX 3060 or newer, compute capability 8.6 or above.
Windows | Ubuntu 22.04 / 24.04 | |
|---|---|---|
Compiler | Visual Studio 2019 or 2022 |
|
CMake | ≥ 3.18 | ≥ 3.18 |
GStreamer | MSVC x86_64, 1.18–1.24, with |
|
mDNS | Bonjour |
|
GL / X11 | — |
|
Python (detector only) | 3.10+ |
|
WARNING
GStreamer must be on
PATHat runtime, not only at build time — the viewers load its plugins dynamically. On Windows, if...\1.0\msvc_x86_64\binis not onPATH, the viewer cannot decode the stream.