Presets（预设值）

Part of the Zivid SDK is the presets, a set of pre-tuned settings. We have two types of presets:

  • 3D presets

  • 2D presets

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

预设值与 SDK 版本相结合。这意味着如果您升级或降级SDK，预设值中的参数可能会发生变化。因此，如果您想在应用程序中使用预设值，建议保存 .yml 文件并使用 API 中的加载函数加载它。

跳转到源码

source

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

source

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

source

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

警告

预设值与SDK版本相对应，在不同的SDK版本之间可能有所变更。

您可以在下面找到有关类别的一般假设、预设下载链接、示例场景和基准测试结果的更多信息。建议在应用中尝试不同的预设，以找到最适合您的预设。

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（检测）

在每个类别中，您可以找到各种不同的预设值。这些是由场景复杂性、工作距离或其中对象的典型材料属性类型区别而来的。不同的相机型号根据它们的常见应用也有不同的预设值。

Consumer Goods（消费品）

Consumer goods（消费品设置）涵盖您在运营中心的 Piece Picking 或商品拣选应用中能够找到的所有商品。这通常包括数千种形状和尺寸各异的不同物体 (SKU)。假设采用高端硬件设置，捕获时间通常在 400-1000 毫秒之间。人们认为拥有足够的数据点通常比拥有较少但精确的数据点更重要。有关设置指导、最佳相机安装和拍照策略的更多信息，请参阅我们的 单品拣选教程 。

Consumer goods（消费品设置）分为 Fast 和 Quality 。 Quality 预设具有宽广的动态范围，可为多种对象提供良好的数据，包括透明、深色、明亮、反光对象。 Fast 预设可显着加快捕获速度，但与 Quality 相比，对象表面覆盖范围会减少。

Consumer goods（消费品设置）分为 Fast 和 Quality 。 Quality 预设具有宽广的动态范围，可为各种物体（包括明亮和反光物体以及深色盒子）提供良好的数据。 Fast 预设的动态范围较小，但捕获速度明显更快。

以下是每个子类别的示例。

fig_fast_scene

fig_quality_scene

Typical Consumer Goods Fast scene

Typical Consumer Goods Quality scene
预设值的评测

Parcels（包裹）

Parcels（包裹分拣预设值）的目标是覆盖物流中心内的所有类型的物体，例如盒子、塑料袋和包裹。假设采用高端硬件设置，捕获时间通常在 200-400 毫秒之间。通常良好的数据覆盖比精确的数据更重要。

Parcels 分为 Fast 和 Quality 。 Fast 预设适用于动态范围有限的场景，例如纸板箱、纸箱和信封，并提供快速捕获。 Quality 预设适用于更具挑战性的场景，包括塑料袋和深色反光包裹。

Parcels 分为 Matte 和 Reflective 。 Matte 预设适用于动态范围有限的场景，例如纸板箱、纸箱和信封。 Reflective 预设适用于更具挑战性的场景，包括塑料袋和深色箱子。

以下是预设涵盖的场景示例。

fig_matte_scene

fig_reflective_scene

Typical Parcels Fast / Matte scene

Typical Parcels Quality / Reflective scene
预设值的评测

Manufacturing（制造业）

Manufacturing（制造业预设值）涵盖了工业 Bin Picking 或 Machine tending 中常见的所有类型的对象。它可以是任何东西，从塑料和橡胶零件到闪亮的金属圆柱体，在尺寸、颜色和材料上都有显着的变化。这些应用的典型情况是料箱通常仅包含一种类型的零件。假设采用高端硬件设置，捕获时间通常在 400-1500 毫秒之间。人们认为，数据较少但准确的数据比相反的数据更重要。

Manufacturing（制造业预设值）分为四个子类别： Diffuse 、 Semi-Specular 、 Specular 和 Small Features 。 Diffuse 适用于没有反射或高动态范围要求的相对简单的场景。 Semi-Specular 适用于具有一些反射的场景，因此需要更高的动态范围。 Specular 适用于具有闪亮和反光部分并因此需要大量动态范围的场景。 Small Features 适用于具有反光部件的场景，同时这些部件具有小而详细的特征，例如 M5 螺栓的螺纹。 Small Features 预设的预期捕获时间为 1900-2200 毫秒。

Manufacturing （制造业预设值）分为三个子类别： Diffuse 、 Semi-Specular 和 Specular 。 Diffuse 适用于没有反射或高动态范围的相对简单的场景。 Semi-Specular 适用于具有一些反射的场景，因此需要更高的动态范围。 Specular 适用于具有闪亮和反光部分并因此需要大量动态范围的场景。

以下是预设涵盖的场景示例。

fig_diffuse_scene

fig_semi_specular_scene

fig_specular_scene

Typical Manufacturing Diffuse scene

Typical Manufacturing Semi-Specular scene

Typical Manufacturing Specular scene

点云显示了典型制造 微小特征 场景的示例。

预设值的评测

Inspection（检测）

Inspection（检测预设值）涵盖工业维护 Inspection 中的典型对象。这可以是从检查焊接应用到车轮和 3D 打印零件的任何事物。假设采用高端硬件设置，捕获时间通常在 1000-3000 毫秒之间。重要的是点云数据包含尽可能少的噪声。

Inspection（检测预设值）分为 Default 和 Small Features 。 Default 预设适用于具有需要高动态范围的反射部分的场景。 Small Features 预设适用于具有小而详细特征的反光部件的场景，例如 PCB 板上的组件。

Inspection（检测预设值）分为 Close 和 Far 。这是指工作距离，近端距离为 ~350 mm，远端距离为 ~600 mm。

以下是预设涵盖的场景示例。

fig_far_scene

fig_close_scene

Typical Inspection Default / Far scene

Typical Inspection Small Features / Close scene
预设值的评测

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.

High Resolution Color

high_res_color

Low Resolution Color

low_res_color

Low Resolution Grayscale

low_res_grayscale

版本历史

SDK

变更

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.