File Camera（文件相机）

Zivid文件相机允许用户在没有物理相机的情况下测试zivid相机的输出。此功能使用一个事先获取的点云。使用文件相机可以：

  • 在Zivid Studio中查看点云或使用文件相机可视化示例对其进行可视化

  • 调整过滤器和颜色设置以检查它们对点云和2D RGB图像的影响

  • 无需始终连接物理相机即可处理您的代码

  • 在没有物理相机的情况下测试Zivid API

警告

不要更改采集设置或engine类型，因为这些设置必须与用于采集点云的设置相同。

有多个文件相机选项可供选择。每个文件相机都在相应相机型号的主要应用之一中演示了一个用例。因此，您可以根据您需要的相机型号或应用来选择文件相机。可用的文件相机如下所示。

如何访问和使用Zivid文件相机

下载 Sample Data（示例数据） 后，您可以通过两种方式访问文件相机。

通过 Zivid示例 访问Zivid文件相机

API允许您通过引用文件相机的路径来连接到类似于物理相机的文件相机。建立文件相机连接后，使用方法与物理相机类似。

跳转到源码

源码

const auto fileCamera =
    userInput ? fileCameraPath : std::string(ZIVID_SAMPLE_DATA_DIR) + "/FileCameraZivid2M70.zfc";
跳转到源码

源码

fileCamera = Environment.GetFolderPath(Environment.SpecialFolder.CommonApplicationData) + "/Zivid/FileCameraZivid2M70.zfc";
跳转到源码

源码

default=get_sample_data_path() / "FileCameraZivid2M70.zfc",

跳转到源码

源码

auto camera = zivid.createFileCamera(fileCamera);
跳转到源码

源码

var camera = zivid.CreateFileCamera(fileCamera);
跳转到源码

源码

camera = app.create_file_camera(file_camera)

可以在拍摄之前调整过滤器和颜色设置。

警告

采集设置应如下所示进行初始化。注意不要更改采集设置或engine。

跳转到源码

源码

const auto settings =
    Zivid::Settings{ Zivid::Settings::Acquisitions{ Zivid::Settings::Acquisition{} },
                     Zivid::Settings::Processing::Filters::Smoothing::Gaussian::Enabled::yes,
                     Zivid::Settings::Processing::Filters::Smoothing::Gaussian::Sigma{ 1.5 },
                     Zivid::Settings::Processing::Filters::Reflection::Removal::Enabled::yes,
                     Zivid::Settings::Processing::Filters::Reflection::Removal::Experimental::Mode::global,
                     Zivid::Settings::Processing::Color::Balance::Red{ 1 },
                     Zivid::Settings::Processing::Color::Balance::Green{ 1 },
                     Zivid::Settings::Processing::Color::Balance::Blue{ 1 } };
跳转到源码

源码

var settings = new Zivid.NET.Settings
{
    Acquisitions = { new Zivid.NET.Settings.Acquisition { } },
    Processing = { Filters = { Smoothing = { Gaussian = { Enabled = true, Sigma = 1.5 } },
                               Reflection = { Removal = { Enabled = true, Experimental = { Mode = ReflectionFilterModeOption.Global} } } },
                   Color = { Balance = { Red = 1.0, Green = 1.0, Blue = 1.0 } } }
};
跳转到源码

源码

settings = zivid.Settings()
settings.acquisitions.append(zivid.Settings.Acquisition())
settings.processing.filters.smoothing.gaussian.enabled = True
settings.processing.filters.smoothing.gaussian.sigma = 1
settings.processing.filters.reflection.removal.enabled = True
settings.processing.filters.reflection.removal.experimental.mode = "global"
settings.processing.color.balance.red = 1.0
settings.processing.color.balance.green = 1.0
settings.processing.color.balance.blue = 1.0

通过 Zivid Studio 访问Zivid文件相机

从终端启动Zivid Studio并访问文件相机。

ZividStudio --file-camera=C:/ProgramData/Zivid/FileCameraZivid2M70.zfc

ZividStudio --file-camera=/usr/share/Zivid/data/FileCameraZivid2M70.zfc

当Zivid Studio打开时，在捕获之前选择手动设置选项。然后，您可以调整过滤器和颜色设置，在每次要应用新的设置时进行捕获，来查看它们对点云的影响。

警告

注意不要更改采集设置或engine。

小技巧

打开反射过滤器可以去除漂浮的噪点。

下面的视频展示了如何在Zivid Studio中访问和使用文件相机。

版本历史

SDK

变更

2.9.0

为当前的相机型号添加了文件相机。