クイック キャプチャ チュートリアル

This tutorial shows the fastest way to connect to a Zivid camera, capture a point cloud, and save it using the Zivid SDK.

はじめに

このチュートリアルでは、 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()

接続

Connect to the camera:

C++

source

auto camera = zivid.connectCamera();

C#

source

var camera = zivid.ConnectCamera();

Python

source

camera = app.connect_camera()

設定

Load capture settings from a YML file:

C++

source

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

C#

source

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

Python

source

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

キャプチャ

Capture a point cloud:

C++

source

const auto frame = camera.capture2D3D(settings);

C#

source

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

Python

source

frame = camera.capture_2d_3d(settings)

保存

保存

Save the point cloud to a ZDF file:

C++

ソース

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

C#

source

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

Python

source

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

エクスポート

Export the point cloud to the .ply format:

C++

source

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

C#

source

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

Python

source

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

その他のエクスポートオプションについては、サポートされているフォーマットの一覧について 点群 を参照してください。

活用

C++

source

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

C#

source

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

Python

source

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

Tip

1. プリセット設定は Zivid Studio から YML 形式でエクスポートできます。

2. Frame.zdf ファイルは Zivid Studio で開いて表示できます。

まとめ

このチュートリアルでは、 Zivid SDK を使用して Zivid カメラに接続し、キャプチャし、保存する最も基本的な方法を示します。

より詳細なチュートリアルについては、完全な キャプチャチュートリアル を参照してください。