Quick Capture Tutorial

This tutorial describes the most basic way to use the Zivid SDK to capture point clouds.

For Python and Matlab see:

PythonMatlab

Zivid Quick Capture Tutorial for Python

Prerequisites

• Install Zivid Software.

Initialize

Before calling any of the APIs in the Zivid SDK, we have to start up the Zivid Application. This is done through a simple instantiation of the application.

C++C#

Zivid::Application zivid;

Connect

C++C#

auto camera = zivid.connectCamera();

Configure

C++C#

const auto suggestSettingsParameters = Zivid::CaptureAssistant::SuggestSettingsParameters{
    Zivid::CaptureAssistant::SuggestSettingsParameters::AmbientLightFrequency::none,
    Zivid::CaptureAssistant::SuggestSettingsParameters::MaxCaptureTime{ std::chrono::milliseconds{ 1200 } }
};

std::cout << "Running Capture Assistant with parameters:\n" << suggestSettingsParameters << std::endl;
auto settings = Zivid::CaptureAssistant::suggestSettings(camera, suggestSettingsParameters);

Capture

C++C#

const auto frame = camera.capture(settings);

Save

C++C#

const auto *dataFile = "Frame.zdf";
frame.save(dataFile);

The API detects which format to use. See Point Cloud for a list of supported formats.

Tip

You can open and view Frame.zdf file in Zivid Studio.

Conclusion

This tutorial shows the most basic way to use the Zivid SDK to connect to, capture, and save from the Zivid camera.

For a more in-depth tutorial check out the complete Capture Tutorial.