このページは機械翻訳であり、まだ人による確認が行われていません。

Zivid SDK の相互運用性

Zivid SDK と Zivid Motion を同じアプリケーション内で併用するには、Zivid SDK の点群座標を Zivid Motion に渡す前にミリメートルからメートルに変換してください。C++ では、 Application を Motion::Application より先にインスタンス化する必要もあります。これらの統合手順は現時点では手動で行う必要がありますが、両 SDK 間のより緊密な相互運用性は将来的に計画されています。

Zivid Motion と Zivid SDK を組み合わせた完全なサンプルアプリケーションについては、 Zivid ポイントクラウドからの障害物 サンプルを参照してください。


単位:ミリメートルとメートル

ご了承ください:

  • Zivid SDK の点群座標はミリメートル単位です。

  • Zivid Motion のジオメトリと障害物の座標はメートル単位です。

SDK の点群データからモーション障害物を作成する前に、必ず座標をミリメートルからメートルに変換してください。

const Zivid::Matrix4x4 millimetersToMetersTransform{ {
    { 0.001f,    0.f,    0.f, 0.f },
    {    0.f, 0.001f,    0.f, 0.f },
    {    0.f,    0.f, 0.001f, 0.f },
    {    0.f,    0.f,    0.f, 1.f },
} };
frame.pointCloud().transform(millimetersToMetersTransform);
millimeters_to_meters_transform = np.diag([0.001, 0.001, 0.001, 1])
frame.point_cloud().transform(millimeters_to_meters_transform)

C++ 統合の詳細

アプリケーションのインスタンス化順序

同じ C++ プロセス内で Zivid SDK と Zivid Motion を使用する場合、初期化エラーを回避するために、先に Application を作成し、次に Motion::Application アプリケーションを作成してください。

以下の順序で使用してください。

Zivid::Application zividApp;
Zivid::Motion::Application motionApp;

データ型変換

SDK と Motion の型は、同じ概念を表す場合でも異なる C++ の型です。

例えば:

  • PointXYZ は SDK のポイント型です。

  • Zivid::Motion::Vector3f は Motion のポイント型です。

SDK の点群データからモーション障害物を作成する際に、明示的に変換を行う:

// Ensure that the point cloud is in meters, not millimeters, before copying the XYZ data.
// Also, make sure to use an unorganized point cloud, as Motion always expects unorganized point clouds.
const auto xyzData = unorganizedPointCloud.copyPointsXYZ();
std::vector<Zivid::Motion::Vector3f> points;
points.reserve(xyzData.size());
for(const auto &p : xyzData)
{
    points.emplace_back(Zivid::Motion::Vector3f{ p.x, p.y, p.z });
}
planner.setObstacles({ Zivid::Motion::Obstacle::fromPointCloud("point_cloud_obstacle", points) });

Python 統合の詳細

Python では、相互運用性はより簡単です。

  • Zivid SDK と Zivid Motion はどちらも、NumPy 互換データと自然に連携します。

  • ミリメートルからメートルへの変換を除けば、特別なデータ変換手順は必要ありません。

  • zivid.Application() と zividmotion.Application() の間に、インスタンス化の順序制限はありません。