How to adjust your Structure Core to see black and shiny objects.

Structure Core is highly customizable with its built-in settings. If you download the Structure SDK (Cross-Platform) you will have access to our Core Playground sample app that will allow you to change these settings, infrared exposure and gain being among these, to help scan things that otherwise might be difficult, like black objects. 

To download the Structure SDK (Cross-platform) and use Core Playground, you'll need to first sign up for our Developer Portal, found here:

After you have signed up, you'll have access to be able to download the Structure SDK (Cross-Platform).

Below are step by step guides on how to build Core Playground on your computer.


The SDK includes a shell script that automatically invokes the build tools. 

Please open the Terminal Applications and run the following Command within the Structure SDK (Cross-Platform) folder.

$ Scripts/

A Makefile build system will be generated in  Builds/macos-CONFIG-x86_64/. Pass --help to see available options.

Alternatively, invoke  cmake and make directly within Terminal:

$ cd [location of the SDK]/StructureSDK-CrossPlatform-0.7.1
$ mkdir build
$ cd build
$ cmake -G'Unix Makefiles' -DCMAKE_BUILD_TYPE=Release ..
$ make Samples

Or generate an Xcode build system:

$ mkdir build
$ cd build
$ cmake -G'Xcode' ..
$ open StructureSDK-CrossPlatform.xcodeproj


To generate the Visual Studio solution, first open Command Prompt:

> cd [location of the SDK]/StructureSDK-CrossPlatform-0.7.1
> mkdir build
> cd build
> cmake -G"Visual Studio 15 2017 Win64" ..

Then open  build\StructureSDK-CrossPlatform.sln in Visual Studio or use CMake's build tool mode:

> cmake --build . --target Samples --config Release

Once built, the sample apps may be run from the  Apps directory.

If a Unix-like environment such as Git Bash (part of Git for Windows) or MSYS2 is installed, the included build script may be used instead.

$ Scripts/

A Visual Studio build system will be generated in  Builds\windows-x86_64

Pass  --help to see available options.

Within both Windows and Mac, once built, the Core Playground Sample app will within the newly created folder, Apps. 

After Core Playground has been built and launched, you'll have access to all of the internal settings designed into Structure Core. We suggest you use the following settings, at first, before hitting the play button in the top left corner of the screen. 

  • Turn on Streaming for Visible, Infrared, and Depth.
  • Turn up Infrared Exposure to, at least, 0.020 sec.
  • Turn up Infrared Gain to 3.

You can see a video of how a Structure Core sees a shiny black object with different settings below:

Did this answer your question? Thanks for the feedback There was a problem submitting your feedback. Please try again later.