Presets（预设值）
Presets（预设值）是Zivid SDK的一部分，即一组预先调整好的设置。我们有两种类型的预设：
3D 预设值
2D 预设值
3D 预设值包含了2D 和 3D 捕获设置，可与所有捕获功能一起使用。2D 预设值仅包含 2D 设置，只能用于 2D 捕获。
预设值与 SDK 版本相结合。这意味着如果您升级或降级SDK，预设值中的参数可能会发生变化。因此，如果您想在应用程序中使用预设值，建议保存 .yml 文件并使用 API 中的加载函数加载它。
const auto settingsFile = "Settings.yml";
std::cout << "Loading settings from file: " << settingsFile << std::endl;
const auto settingsFromFile = Zivid::Settings(settingsFile);
var settingsFile = "Settings.yml";
Console.WriteLine("Loading settings from file: " + settingsFile);
var settingsFromFile = new Zivid.NET.Settings(settingsFile);
警告
预设值与SDK版本相对应，在不同的SDK版本之间可能有所变更。
您可以在下面找到有关类别的一般假设、预设下载链接、示例场景和基准测试结果的更多信息。建议在应用中尝试不同的预设，以找到最适合您的预设。
3D 预设值
预设值旨在简化相机参数的调整，在大多数情况下无需手动调整。它们专门针对以下类别进行了调整：
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 预设的动态范围较小，但捕获速度明显更快。
以下是每个子类别的示例。
|
|
Typical Consumer Goods Fast scene |
Typical Consumer Goods Quality scene |
预设值的评测
Details about configurationsDisplay Options
Capture 2D + 3D
2+R High-end NVIDIA High-end Intel Low-end Intel 2D 3D 2D 3D 2D 3D Consumer Goods Settings Consumer Goods Fast Consumer Goods Quality
Details about configurationsDisplay Options
Capture 2D + 3D
2+ High-end NVIDIA High-end Intel Low-end Intel 2D 3D 2D 3D 2D 3D Consumer Goods Settings Consumer Goods Fast Consumer Goods Quality
Details about configurationsDisplay Options
Capture 2D + 3D
2 High-end NVIDIA High-end Intel Low-end Intel 2D 3D 2D 3D 2D 3D Consumer Goods Settings
Parcels（包裹）
Parcels（包裹分拣预设值）的目标是覆盖物流中心内的所有类型的物体，例如盒子、塑料袋和包裹。假设采用高端硬件设置，捕获时间通常在 200-400 毫秒之间。通常良好的数据覆盖比精确的数据更重要。
Parcels 分为 Fast 和 Quality 。 Fast 预设适用于动态范围有限的场景，例如纸板箱、纸箱和信封，并提供快速捕获。 Quality 预设适用于更具挑战性的场景，包括塑料袋和深色反光包裹。
Parcels 分为 Matte 和 Reflective 。 Matte 预设适用于动态范围有限的场景，例如纸板箱、纸箱和信封。 Reflective 预设适用于更具挑战性的场景，包括塑料袋和深色箱子。
以下是预设涵盖的场景示例。
|
|
Typical Parcels Fast / Matte scene |
Typical Parcels Quality / Reflective scene |
预设值的评测
Details about configurationsDisplay Options
Capture 2D + 3D
2+R High-end NVIDIA High-end Intel Low-end Intel 2D 3D 2D 3D 2D 3D Parcels Settings Parcels Fast Parcels Quality
Details about configurationsDisplay Options
Capture 2D + 3D
2+ High-end NVIDIA High-end Intel Low-end Intel 2D 3D 2D 3D 2D 3D Parcels Settings Parcels Fast Parcels Quality
Details about configurationsDisplay Options
Capture 2D + 3D
2 High-end NVIDIA High-end Intel Low-end Intel 2D 3D 2D 3D 2D 3D Parcels Settings
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 适用于具有闪亮和反光部分并因此需要大量动态范围的场景。
以下是预设涵盖的场景示例。
|
|
|
Typical Manufacturing Diffuse scene |
Typical Manufacturing Semi-Specular scene |
Typical Manufacturing Specular scene |
点云显示了典型制造 微小特征 场景的示例。
预设值的评测
Details about configurationsDisplay Options
Capture 2D + 3D
2+R High-end NVIDIA High-end Intel Low-end Intel 2D 3D 2D 3D 2D 3D Manufacturing Settings Manufacturing Diffuse Manufacturing Semi-Specular Manufacturing Specular Manufacturing Small Features
Details about configurationsDisplay Options
Capture 2D + 3D
2+ High-end NVIDIA High-end Intel Low-end Intel 2D 3D 2D 3D 2D 3D Manufacturing Settings Manufacturing Diffuse Manufacturing Semi-Specular Manufacturing Specular Manufacturing Small Features
Details about configurationsDisplay Options
Capture 2D + 3D
2 High-end NVIDIA High-end Intel Low-end Intel 2D 3D 2D 3D 2D 3D Manufacturing Settings
Inspection（检测）
Inspection（检测预设值）涵盖工业维护 Inspection 中的典型对象。这可以是从检查焊接应用到车轮和 3D 打印零件的任何事物。假设采用高端硬件设置，捕获时间通常在 1000-3000 毫秒之间。重要的是点云数据包含尽可能少的噪声。
Inspection（检测预设值）分为 Default 和 Small Features 。 Default 预设适用于具有需要高动态范围的反射部分的场景。 Small Features 预设适用于具有小而详细特征的反光部件的场景，例如 PCB 板上的组件。
Inspection（检测预设值）分为 Close 和 Far 。这是指工作距离，近端距离为 ~350 mm，远端距离为 ~600 mm。
以下是预设涵盖的场景示例。
|
|
Typical Inspection Default / Far scene |
Typical Inspection Small Features / Close scene |
预设值的评测
Details about configurationsDisplay Options
Capture 2D + 3D
2+R High-end NVIDIA High-end Intel Low-end Intel 2D 3D 2D 3D 2D 3D Inspection Settings Inspection Default Inspection Small Features
Details about configurationsDisplay Options
Capture 2D + 3D
2+ High-end NVIDIA High-end Intel Low-end Intel 2D 3D 2D 3D 2D 3D Inspection Settings Inspection Default Inspection Small Features
Details about configurationsDisplay Options
Capture 2D + 3D
2 High-end NVIDIA High-end Intel Low-end Intel 2D 3D 2D 3D 2D 3D Inspection Settings
2D 预设值
High Resolution（高分辨率）
High Resolution（高分辨率）预设值优先考虑图像细节和分辨率。如果您愿意牺牲拍摄速度来获得出色的效果，请选择此预设值。它的设计遵循以下原则：
全分辨率
低增益值
Low Resolution（低分辨率）
Low Resolution（低分辨率）预设值平衡了质量和速度，能够提供更快的捕获速度，同时保持中等程度的细节。此预设值的设计包括：
适中的采集时间
降低了分辨率以实现更快的处理速度
预设值的评测
Display Options
2D
| ET=ExposureTime | 2+R | |||||
|---|---|---|---|---|---|---|
| ET | High-end NVIDIA | High-end Intel | Low-end Intel | |||
| HighRes Settings 2D | ||||||
| HighRes Color | 10 ms | |||||
| HighRes Grayscale | 10 ms | |||||
| LowRes Settings 2D | ||||||
| LowRes Color | 1 ms | |||||
| LowRes Grayscale | 1 ms | |||||
以下是使用 Zivid 2+ MR130 进行 2D 捕获的示例，分别采用了高分辨率彩色、低分辨率彩色和低分辨率灰度 2D 预设值。
High Resolution Color |
|
Low Resolution Color |
|
Low Resolution Grayscale |
|
版本历史
SDK |
变更 |
|---|---|
2.14 |
所有相机均添加了 2D 预设值，并为 2+ MR60、MR130 和 LR110 相机添加了 3D 预设值。 |
2.10 |
添加了 Zivid 2+ 相机系列的 3D 预设值，并为所有相机添加了 3D 预设值，以适应环境光（电网）频率。 |
2.9 |
添加了 3D 预设值。 |