Presets（预设值）
Presets（预设值）是Zivid SDK的一部分，是一系列预先调整好的设置。这些预设值旨在简化相机参数的调整，并且是 捕获助手 的替代方法。Capture Assistant会尝试根据时间预算优化任何场景的曝光设置，而预设值则是针对以下类别而专门调整的曝光设置：
Consumer Goods（消费品）
Parcels（包裹）
Manufacturing（制造业）
Inspection（检测）
在每个类别中，您可以找到各种不同的预设值。这些是由场景复杂性、工作距离或其中对象的典型材料属性类型区别而来的。不同的相机型号根据它们的常见应用也有不同的预设值。
At the bottom of this page you will also find ambient light adapted presets and presets for Halcon.
预设值与 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版本之间可能有所变更。
您可以在下面找到有关类别的一般假设、预设下载链接、示例场景和基准测试结果的更多信息。建议在应用中尝试不同的预设，以找到最适合您的预设。
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 |
预设值的评测
Parcels（包裹）
Parcels（包裹分拣预设值）的目标是覆盖物流中心内的所有类型的物体，例如盒子、塑料袋和包裹。假设采用高端硬件设置，捕获时间通常在 200-400 毫秒之间。通常良好的数据覆盖比精确的数据更重要。
Parcels 分为 Fast 和 Quality 。 Fast 预设适用于动态范围有限的场景，例如纸板箱、纸箱和信封，并提供快速捕获。 Quality 预设适用于更具挑战性的场景，包括塑料袋和深色反光包裹。
可用的预设值：
可用的预设值：
Parcels 分为 Matte 和 Reflective 。 Matte 预设适用于动态范围有限的场景，例如纸板箱、纸箱和信封。 Reflective 预设适用于更具挑战性的场景，包括塑料袋和深色箱子。
可用的预设值：
可用的预设值：
以下是预设涵盖的场景示例。
|
|
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 适用于具有闪亮和反光部分并因此需要大量动态范围的场景。
以下是预设涵盖的场景示例。
|
|
|
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。
可用的预设值：
以下是预设涵盖的场景示例。
|
|
Typical Inspection Default / Far scene |
Typical Inspection Small Features / Close scene |
预设值的评测
环境光适应
环境光适应预设可以在下面下载。
Halcon
Halcon 不支持加载 .yml 文件，因此无法直接使用预设值。如需在 Halcon 中使用 Zivid 预设值，请下载下面所需预设值的 JSON 文件，并使用 Halcon procedure read_zivid_json_params 加载它。
有关如何加载设置和捕获的示例，请参见 CaptureWithSettingsFromJSON 。
版本历史
SDK |
变更 |
|---|---|
2.10 |
添加了 Zivid 2+ 相机系列的预设，以及适应环境光（电网）频率的所有相机的预设。 |
2.9 |
添加了预设值。 |