変更履歴
4.0.0
2026年10月5日
API
パス失敗診断を追加しました。
Motion::Planner::pathの呼び出しが失敗したときに追加の診断情報を取得するには、Motion::PathRequest::diagnoseFailuresを有効にしてください。Motion::ReplaceableToolとMotion::ToolGeometryを追加しました。Motion::Planner::setReplaceableToolは、ツールのメッシュを直接受け取る従来のオーバーロードに代わり、Motion::ReplaceableToolを受け取るようになりました。Goalsを、新しいMotion::ConfigurationGoalを保持するMotion::ConfigurationGoalsに置き換えました。これは、fromConfigurationsに代わり、コンフィグレーションまたはゴールのリストから暗黙的に構築されるようになりました。ゴールは、jointConfigurationsに代わり、Motion::ConfigurationGoals::goalsで読み取れるようになりました。Motion::Planner::computeInverseKinematicsは、ポーズのリストの代わりに、新しいMotion::PoseGoalを保持するMotion::PoseGoalsを受け取るようになりました。ポーズのリストは引き続き暗黙的に変換されますが、C++ では、波括弧で囲んだポーズのリストにはもう 1 組の波括弧が必要になりました。Motion::Meshは作成後に変更できなくなりました。transformInPlaceとbottomCenterTransformInPlaceを削除しましたので、代わりにコピーを返すMotion::Mesh::transformとMotion::Mesh::bottomCenterTransformを使用してください。setColorは、コピーを返すMotion::Mesh::withColorに置き換えました。
C++
Motion::Meshはコピーできるようになりました。
Python
zivid_pythonmotionホイールは Python 3.12 にも対応するようになりました。Python 3.10 は 2026 年 10 月にサポートが終了します。本リリースでは Python 3.10 のサポートは非推奨となり、将来のリリースで削除される可能性があります。
UserConfiguration.yml
フィールドは
GenerationセクションとRuntimeセクションにグループ化されるようになりました。各関心領域の退避方向を
Runtime/RegionsOfInterestに移動し、IdによってGeneration/Workspace/RegionsOfInterestと対応付けました。Runtime配下のフィールドを変更しても、セルデータを再生成する必要がなくなりました。移動中のロボットツールの向きを設定する
Generation/ConstrainedMovementセクションを追加しました。Generation/AttachmentsおよびGeneration/AdaptivePart配下のSelfCollisionCheckLinksは、リンクの番号付けが 1 から始まるようになりました。既存のファイルでは、各リンクに 1 を加算してください。SelfCollisionCheckLinksに同じリンクが 2 回記載されている場合、またはロボットに存在しないリンクが記載されている場合、セルの読み込みが失敗します。StaticEnvironmentSafetyDistanceとDynamicEnvironmentSafetyDistanceを、Runtime/PreferredMinClearance/StaticEnvironmentとRuntime/PreferredMinClearance/DynamicEnvironmentに名称変更しました。プランナーは可能な限りこのクリアランスを維持しますが、保証はされません。
全般
Zivid Motion は、CUDA 12.0 に対応した NVIDIA ドライバー、つまりドライバーバージョン 525.60.13 以降を必要とするようになりました。
プランナーの呼び出し、プランナーの起動、セルデータの生成が高速化し、メモリ使用量が削減されました。
いくつかのバグを修正しました。
3.2.0
2026年9月1日
API
Visualizer が表示するロボットコンフィグレーションを設定する
Motion::Visualizer::setRobotConfigurationを追加しました。Motion::packageApiLogは、作成するアーカイブに API ログ自体を含めるようになったため、記録したセッションを再現するために Zivid が必要とするものはそのアーカイブだけで済みます。アーカイブはログの隣に<name>.zipとして作成されるようになり、ログを含めていなかった従来の<name>-resources.zipを置き換えます。
UserConfiguration.yml
ロボットのメーカーを表す
RobotBrandを追加しました。
全般
各種パフォーマンスの改善。
バグ修正
Motion::Planner::pathは、ゴールには到達できるがそこに至るパスがない場合、ゴールがブロックされているのではなく、パスがブロックされていると報告するようになりました。エクスポートされた API ログは、記録された障害物とともに再生されるようになりました。
いくつかの軽微なバグを修正しました。
3.1.0
2026年8月12日
API
並進と roll、pitch、yaw 角からポーズを構築する
Motion::Pose::fromXyzRpyを追加しました。2 つのポーズを合成する
Motion::Pose::composeを追加しました。ディスク上のファイルからメッシュを読み込む実験的な
Motion::Experimental::loadMesh関数を追加しました。
C++
Motion::Tcp、Motion::Waypoint、Motion::Planner用のストリーム演算子を追加しました。
Python
zivid_pythonmotionホイールは、以前の Python バージョンごとに 1 つのホイールを配布する方式に代わり、サポートするすべての Python バージョンに対応するようになりました。zivid_pythonmotionホイールは NumPy への依存関係を宣言するようになりました。
RuntimeConfiguration.yml
スレッドプールのサイズを決定する際に Zivid Motion がユーザー用に空けておく CPU スレッド数を上書きする
Performance/FreeCpuThreadsを追加しました。この数は、これまでは 2 に固定されていました。
全般
セルパッケージのインストール時に、Motion のリソースディレクトリが存在しない場合は作成されるようになりました。
生成されたデータなしでパッケージ化する場合でも、セルのパッケージ化に元の URDF ファイルとメッシュファイルが含まれるようになりました。
いくつかのバグを修正しました。
3.0.0
2026年7月2日
API
Motion::Pose、Motion::Configuration、Motion::Path、Motion::Triangleは、従来の typedef に代わり、具象型になりました。PointXYZとVectorXYZの typedef を削除しました。代わりにMotion::Vector3fを使用してください。TransformedBoxをMotion::BottomCenteredTransformedBoxに名称変更し、そのメンバーbottomCenteredTransformをtransformに名称変更しました。Motion::Planner::computeInverseKinematicsは、単一のポーズを受け取りオプションのコンフィグレーションを返す方式ではなく、ポーズのリストを受け取りGoalsを返すようになりました。PathRequest.goalConfigurationsを、新しいGoals型を使用するMotion::PathRequest::goalsに置き換えました。Motion::Profileは小文字になりました(Testing/Production→testing/production)。Motion::Trianglesまたは形状(Motion::Mesh::createBox、Motion::Mesh::createCylinder、Motion::Mesh::createSphere)から構築される、新しいMotion::Meshクラスを追加しました。Motion::Mesh::transformとMotion::Mesh::transformInPlaceを追加しました。Motion::Mesh::bottomCenterTransformとMotion::Mesh::bottomCenterTransformInPlaceを追加しました。複数のメッシュを 1 つに統合する実験的な
Motion::Experimental::merge関数を追加しました。
Motion::Planner::setCarriedObjectとMotion::Planner::setReplaceableToolは、引数としてMotion::Meshを受け取るようになりました。他のすべてのオーバーロードは削除されました。Motion::Planner::setObstaclesは、引数としてMotion::Meshのリストを受け取るようになりました。Motion::Trianglesを受け取る従来のオーバーロードは削除されました。プランナーの状態を復元し、以前にエクスポートした API ログを再生する
Motion::Planner::replayApiLogを追加しました。Motion::PoseとMotion::Matrix4x4クラス、およびそれらの間の変換を追加しました。Goals型とGoals::fromConfigurationsを追加しました。
C++
Motion::Applicationは、ヘッダーのバージョンとライブラリのバージョンが一致することを検証するようになりました。
Python
Obstacle.PointCloud、Obstacle.Colors、Trianglesは numpy 配列から直接構築できるようになり、大規模な点群と三角形メッシュに対してより高性能なインターフェースを提供します。BlendRadiusとColorRGBAがクラスとして公開されるようになりました。zivid_pythonmotionホイールをインポートすると、そのバージョンがインストール済みの C++ ライブラリと一致しない場合に警告が表示されるようになりました。
バグ修正
Motion::Planner::pathは、すべてのゴールコンフィグレーションが無効な場合にエラー結果を返すようになりました。
Python
PathRequestコンストラクタの引数の順序を修正し、位置引数による構築が機能するようにしました。
2.0.0
2026年3月31日
API
Zivid Motion API の初回一般公開リリースです。