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()の間に、インスタンス化の順序制限はありません。