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.
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 File → Save
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 File → Export
Navigate to the location where you want to save the point cloud
Write down the file name
Select the file format type and color space
Click Save
Open Point Cloud / File Camera
Opening a point cloud in Zivid Studio is only supported for ZDF file format. A file camera can be opened in Zivid Studio in the ZFC file format.
Click on File → Open
Navigate to the location of your ZDF / ZFC file
Click Open
You can also drag and drop a ZDF / ZFC file into Zivid Studio, or double-click it.
Save Color Image / Depth Map / SNR Map / Normal Map
You can 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. The Depth Map, SNR Map and Normal Map can only be saved in PNG format.
Click on File → Save Color Image / Save Depth Map / Save SNR Map / Save Normal Map
Navigate to the location where you want to save the image
Write down the file name
Click Save
Export Settings
It is possible to save all settings to disk.
Click on File → Export 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 File → Import 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 View → 2D Color Image Histogram
Swap between Linear and Logarithmic to change scales
Information
To open the information panel:
Click View → Information 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.
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.
3D Axis Indicator
A 3D axis indicator is displayed in the bottom left corner of the point cloud view. To disable/enable it, click on View → 3D Axis Indicator.
Show 4x4 Aruco Markers
To highlight any 4x4 Aruco markers in the point cloud, click on View → Show 4x4 Aruco Markers.
Cameras
All Cameras
To open the Cameras menu:
Click on Cameras → All Cameras
This will list all discovered cameras and their serial numbers, models, IP addresses and statuses.
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.
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 Tools → Infield Correction
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.14.0 |
Save Normal map and SNR map is added to File, and 3D Axis Indicator and Aruco markers are added to View. |
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. |