Presets

The Zivid SDK ships presets, sets of pre-tuned settings for common application categories, so you do not have to tune capture settings manually. There are two types of presets:

3D presets: contain the 2D and 3D capture settings and can be used with all capture functions.
2D presets: consist of the 2D settings only and can only be used for 2D captures.

Presets are coupled with an SDK version, so the parameters in a preset may change if you upgrade or downgrade the SDK. If you want to use a preset in an application, save the .yml file and load it using the load function from the API, rather than depending on the preset staying the same across SDK versions.

C++

const auto settingsFile = "Settings.yml";
std::cout << "Loading settings from file: " << settingsFile << std::endl;
const auto settingsFromFile = Zivid::Settings(settingsFile);

C#

var settingsFile = "Settings.yml";
Console.WriteLine("Loading settings from file: " + settingsFile);
var settingsFromFile = new Zivid.NET.Settings(settingsFile);

Python

settings_file = "Settings.yml"
print(f"Loading settings from file: {settings_file}")
settings_from_file = zivid.Settings.load(settings_file)

Each preset category below lists its general assumptions, download links to the presets, an example scene, and benchmarking results. Try out different presets within your application to find the preset best suited for you.

3D Presets

The presets are designed to simplify the tuning of camera parameters and in most cases eliminate the need for manual adjustments. They are specifically tuned for the following categories:

Consumer Goods
Parcels
Manufacturing
Inspection
Depalletization

Within each category, you will find various presets. These are separated by scene complexity, working distance or by the typical type of material property of objects within that. Different cameras have different presets based on what they are commonly used for.

Consumer Goods

Consumer goods cover all items you will find in a Piece Picking or Item Picking application in a fulfillment center. This usually includes thousands of different objects (SKUs) in a wide range of shapes and sizes. Capture time often lies between 400-1000 ms assuming a high-end hardware set-up. It is assumed that having enough data points is often more important than having fewer but precise ones. For more information about settings guidance, optimal camera mounting, and capture strategies, see our in-depth Piece Picking Tutorial.

Below are examples of each subcategory.

Parcels

Parcels aim to cover all types of objects in logistics centers, such as boxes, plastic bags, and packages. Capture time usually lies between 200-400 ms assuming a high-end hardware set-up. It is assumed that it is more important to have good data coverage than precise data.

Below are examples of scenes that the presets cover.

Typical Parcels Quality / Reflective scene

Manufacturing

Manufacturing presets cover all types of objects commonly found in industrial Bin Picking or Machine tending. This can be anything from plastic and rubber parts to shiny metallic cylinders, with notable variations in size, color, and material. Typical for these applications is that the bin often contains only one type of part. Capture time is generally between 400-1500 ms assuming a high-end hardware set-up. It is assumed that it is more important with less, but accurate, data than the opposite.

Below are examples of scenes that the presets cover.

Typical Manufacturing Semi-Specular scene

The point cloud shows an example of a typical Manufacturing Small Features scene.

Inspection

Inspection presets cover typical objects in industrial Maintenance Inspection. This can be anything from inspection welding applications to wheels and 3D printed parts. Capture time is generally between 1000-3000 ms assuming a high-end hardware set-up. What is important is that the point cloud data contains as little noise as possible.

Below are examples of scenes that the presets cover.

Typical Inspection Small Features / Close scene

Depalletization

Depalletization presets cover typical objects in industrial depalletization. This can be anything from simple matte cardboard boxes to plastic wrapped bottles and cans. Capture time is generally between 500-2000 ms assuming high-end hardware set-up. Point cloud coverage on all items is what is most important.

2D Presets

High Resolution

The High Resolution presets prioritizes image detail and resolution. Choose this preset if you are willing to sacrifice capture speed to achieve excellent results. It is designed with the following principles:

Full resolution
Low gain

Low Resolution

The Low Resolution preset balances quality and speed, offering a quicker capture while maintaining a moderate level of detail. This preset is designed with:

Moderate acquisition time
Lower resolution for faster processing

Below are examples of a 2D capture taken with Zivid 2+ MR130 using High Resolution Color, Low Resolution Color, and Low Resolution Grayscale 2D presets.

Version History

SDK	Changes
2.17	Presets for Zivid 3 XL250 are added.
2.14	2D Presets are added for all cameras and 3D presets for 2+ MR60, MR130, and LR110 camera.
2.10	3D Presets for Zivid 2+ camera family are added and 3D presets for all cameras, adapted for ambient light (grid) frequency.
2.9	3D Presets are added.