Toolbar

The toolbar is located at the top of Zivid Studio. It consists of drop-down menus to handle files, control the GUI, configure cameras and get information about the Zivid software.

../../_images/studio-toolbar-all.png

File

Zivid Studio offers various saving options for point clouds, color images, and settings to disk.

Save/Export Point Cloud

To save the point cloud in file ZDF format:

  • Click on FileSave

  • Navigate to the location where you want to save the point cloud

  • Write down the file name

  • Click Save

Note

ZDF is the native Zivid file format that includes point cloud, color image, and depth image data, and is the preferred file format for the Zivid Customer Success Team.

To export to one of our supported point cloud formats, unordered or ordered Polygon (PLY), ASCII (XYZ), or Point Cloud Data (PCD) [1] file format:

  • Click on FileExport

  • Navigate to the location where you want to save the point cloud

  • Write down the file name

  • Click Save

Open Point Cloud

Opening a point cloud in Zivid Studio is only supported for ZDF file format:

  • Click on FileOpen

  • Navigate to the location of your ZDF file

  • Click Open

You can also drag and drop a ZDF file into Zivid Studio.

Save Color Image

You can also save the 2D color image in one of our supported image formats, PNG, BMP and JPG. For all formats, you can choose between sRGB and linear RGB color space.

  • Click on FileSave Color Image

  • Navigate to the location where you want to save the color image

  • Write down the file name

  • Select image format type and color space

  • Click Save

Save Depth Map

You can also save the colored depth map in PNG format.

  • Click on FileSave Depth Map

  • Navigate to the location where you want to save the depth map

  • Write down the file name

  • Click Save

Export Settings

It is possible to save all settings to disk.

  • Click on FileExport Capture Settings

  • Navigate to the location where you want to save the settings

  • Write down the file name

  • Click Save

Import Settings

To import the settings in Zivid Studio:

  • Click on FileImport Capture Settings

  • Navigate to the location of your settings file

  • Click Open

You can also drag and drop a YML file into Zivid Studio to import the settings.

View

Histogram

To show the 2D image histogram:

  • Click on ViewHistogram

  • Swap between Linear and Logarithmic to change scales

../../_images/studio-histogram.png

Read more about the Histogram.

Information

To open the information panel:

  • Click ViewInformation or Information in the bottom right corner

It is available only after you load a point cloud from a ZDF file or capture a point cloud or a color image.

The top part of the Information panel shows Acquisition Time, Capture Time, and Point Cloud / Color Image Size.

../../_images/studio-dropdowns-and-information.png

The bottom part shows the settings that were used in the capture. It is possible to save these settings to a file or apply them for use in the next capture.

../../_images/studio-information-panel-settings.png

Cameras

All Cameras

To open the Cameras menu:

  • Click on CamerasAll Cameras

This will list all discovered cameras and their serial numbers, models, IP addresses and statuses.

../../_images/studio-cameras-menu-multiple.png

The status-field allows the following actions:

  • Connect to connect to the camera if it is available

  • Disconnect to disconnect from the camera if it is connected

  • Update to update the firmware of the camera if it is available but needs a firmware update

  • Remove to remove the camera from the list if it is no longer found

You can change the network configuration of any discovered camera by clicking Configure. This will open the camera network configuration.

../../_images/studio-cameras-configure.png

Here you can set the camera to use DHCP or a specific static IP address, and apply the configuration to the camera by clicking Apply. The status of the camera may change after applying the network configuration.

Tools

Infield Correction

To open the Infield Correction tool:

  • Click on ToolsInfield Correction

../../_images/infield-in-studio.png

Infield Correction functionality overview

  • Last correction shows the last date and time an infield correction was written to the camera.

  • Capture & Measure captures to determine the local dimension trueness error of the point cloud where the Zivid calibration board is placed.

  • Current Camera Metrics shows the local dimension trueness error for the last capture taken with Capture & Measure, as well as the average and the maximum for all the captures.

  • Current trueness shows the local dimension trueness error for the last capture taken with Capture & Measure.

  • Average trueness shows the average of the local dimension trueness errors for all the captures taken with Capture & Measure so far.

  • Maximum trueness shows the maximum of the local dimension trueness errors for all the captures taken with Capture & Measure so far.

  • Expected Post-Correction Metrics shows the estimated post-correction error within 1σ statistical uncertainty over the working distances the images were captured at.

  • Save Correction to Camera writes to the camera the parameters for improving the accuracy of the point cloud determined from the captures of the Zivid calibration board taken with Capture & Measure.

  • Reset Camera Correction removes any infield correction that has been applied in previous correct instances. It is not required to do a reset before doing a new infield correction.

Learn more about Infield Correction.

Version History

SDK

Changes

2.13.0

Cameras menu is added to the toolbar.

2.12.0

Save depth map is added and acquisition time is added to the information panel.