快速捕获教程

本教程展示了使用 Zivid SDK 连接 Zivid 相机、捕获点云并保存的最快方法。

介绍

本教程介绍了使用 Zivid SDK 捕获点云的最基本方法。

先决条件

• 安装 Zivid 软件 。

• 对于 Python：安装 zivid-python

初始化

调用 Zivid SDK 中的任何 API 都需要初始化 Zivid 应用程序并在程序运行时使其保持活动状态。

C++

源码

Zivid::Application zivid;

C＃

源码

var zivid = new Zivid.NET.Application();

Python

源码

app = zivid.Application()

连接

连接相机：

C++

源码

auto camera = zivid.connectCamera();

C＃

源码

var camera = zivid.ConnectCamera();

Python

源码

camera = app.connect_camera()

配置

从 YML 文件加载捕获设置：

C++

source

const auto settings = Zivid::Settings(settingsPath);

C＃

源码

var settings = new Zivid.NET.Settings(settingsFile);

Python

源码

settings = zivid.Settings.load(user_options.settings_path)

捕获

捕获点云：

C++

源码

const auto frame = camera.capture2D3D(settings);

C＃

源码

using (var frame = camera.Capture2D3D(settings))

Python

源码

frame = camera.capture_2d_3d(settings)

保存

保存

将点云保存为 ZDF 文件：

C++

源码

const auto dataFile = "Frame.zdf";
frame.save(dataFile);

C＃

源码

var dataFile = "Frame.zdf";
frame.Save(dataFile);

Python

源码

data_file = "Frame.zdf"
frame.save(data_file)

导出

将点云导出为 .ply 格式：

C++

源码

const auto dataFilePLY = "PointCloud.ply";
frame.save(dataFilePLY);

C＃

源码

var dataFilePLY = "PointCloud.ply";
frame.Save(dataFilePLY);

Python

源码

data_file_ply = "PointCloud.ply"
frame.save(data_file_ply)

对于其他导出选项，请参阅 点云 以获取支持的格式列表

应用

C++

源码

const auto pointCloud = frame.pointCloud();
const auto data = pointCloud.copyData<Zivid::PointXYZColorRGBA_SRGB>();

C＃

源码

var pointCloud = frame.PointCloud;
var pointCloudData = pointCloud.CopyPointsXYZColorsRGBA_SRGB();

Python

源码

point_cloud = frame.point_cloud()
xyz = point_cloud.copy_data("xyz")
rgba = point_cloud.copy_data("rgba_srgb")

小技巧

1. 您可以从 Zivid Studio 导出预设设置到 YML

2. 您可以在 Zivid Studio 中打开并查看 Frame.zdf 文件 。

结论

本教程展示了使用 Zivid SDK 连接相机、捕获和保存图像的最基本的方法。

如需了解更深入的教程，请查看完整的 捕获教程。