Access the Pictomic Turntables' SDKs with gears and SDK representation in a tech-themed image.

Access the Pictomic Turntables' SDKs

How To Articles › Turntables


Applies to: Windows, macOS, Linux | Last Updated: Mar 29, 2021

What you’ll do: Access the Pictomic Turntables' SDKs for your OS/compiler, configure include/lib paths, install FTDI drivers (if needed), and run the included example (in C++) (IconasysTurntableTest.cpp).

1. Overview

The Pictomic Turntable SDK lets developers build custom applications that control Pictomic turntables programmatically. Each SDK package includes platform-specific libraries, header files, and an example source file: IconasysTurntableTest.cpp.

2. Step 1: Download the Turntable SDK

Download the SDK package that matches your operating system, architecture, and compiler. The links below are provided as-is.

SDK Downloads (selected)

Note: Multiple SDK versions exist for Linux (including older builds). Use the package that matches your architecture/compiler requirements.

3. Step 2: Configure Your C++ Build

After unzipping the SDK, configure your project to include the SDK header paths and link against the SDK libraries.

Add C++ include directories

  • include (from the SDK zip/tar package)
  • include/ShutterStream (from the SDK zip/tar package)

Add linker library search path

  • lib (from the SDK zip/tar package)

Example included: The SDK package includes IconasysTurntableTest.cpp showing how to call Turntable SDK functions from C++.

4. Step 3: Install FTDI Turntable Drivers

Install FTDI drivers only if Visere Captura is not already working with your turntable. If Visere Captura can control the turntable, the drivers are already installed and you can skip this step.

Driver downloads

5. Step 4: Linux Setup & “Turntable not opened” Fix

On Linux, run the controller app (or your SDK app) with appropriate permissions. If standard user permissions are restricted, use sudo or configure USB permissions for your user.

Run the turntable controller

sudo ./IconasysTurntableController

If you see: “Turntable not opened”

The Linux kernel may have loaded a different driver for the FTDI USB device. Unload the drivers and try again:

sudo rmmod ftdi_sio
sudo rmmod usbserial

6. Step 5: Build & Run the Example App

Build the included example (IconasysTurntableTest.cpp) using your compiler/IDE after setting the include and lib paths. Then run your compiled binary.

Run the example (Linux)

sudo IconasysTurntableTest

Runtime library note (Linux): Your app may build successfully but fail to start if it cannot locate dependent libraries. See the next section for Qt requirements and runtime library setup.

7. Step 6: Qt Requirements (Linux Only)

On Linux, the Turntable SDK relies on the Qt framework (LGPL). Download the Qt version used by the Turntable SDK here:

Qt 5.11.3 (linux-gcc-7.3.0) distribution

Additional build steps (Linux + Qt)

  • Add Qt include to your compiler include directories
  • Add Qt lib to your linker library search paths

Resolve missing libraries at runtime

You can provide library locations in either of these ways:

  1. Use LD_LIBRARY_PATH: include the SDK lib paths and the Qt lib paths.
  2. Copy libraries next to your executable:
    • The required libraries from the SDK lib folder
    • Qt libraries: libQt5Core.so.5, libQt5Gui.so.5, libQt5Network.so.5, libQt5Qml.so.5, libQt5Quick.so.5

UI note (Linux): No native UI is provided. If you need UI functionality, you’ll need to implement it in your application.

Need Help?

If you’re unable to access or use the Turntable SDK after following the steps above, please contact the Pictomic support team.

When reaching out, include the following information:

  • Operating system and version
  • CPU architecture (x86_64, ARM, etc.)
  • Compiler and version
  • Turntable model
  • SDK version and download link used
  • Any error messages (for example: Turntable not opened)

Email: support@pictomic.com

Back to blog

Leave a comment

Please note, comments need to be approved before they are published.