Qt Quick 3D Physics API の Tech Preview からの変更点

Qt 6.5.0 リリースから、Qt Quick 3D Physics モジュールは技術プレビューではなくなりました。API のフィードバックとレビューの結果、ソースと互換性のない変更が行われました。

変更の大部分は、他のAPIとの一貫性を保ち、より説明的な名前にするための型とプロパティの名前の変更です。最も顕著な名前の変更は、DynamicsWorld をPhysicsWorld に変更したことです。

最も重要な動作の変更は、kinematic bodies の処理です。キネマティック・ボディの位置/向きの変更は、Node プロパティ（position,rotation など）を使用するのではなく、新しいプロパティを使用することで行われるようになりました：kinematicPosition kinematicEulerRotation 、kinematicRotation 、kinematicPivot 。この変更の理由は、キネマティックボディの視覚的な動きをシミュレーションの他の部分と同期させるためです。

DynamicRigidBody.density プロパティは、負の値（およびゼロ）を特別なケースとして扱わなくなりました。代わりに、Density に代わって、massMode の2つの新しい列挙値があります：

enableTriggerReports プロパティはsendTriggerReports に名前が変更されました。さらに、物理オブジェクトがトリガーボディに入ったときに、receiveTriggerReports を設定することで通知できるようになりました。

以下は、すべてのAPI変更の完全なリストです：

• CollisionShape:
  • enableDebugView の名前がenableDebugDraw
• 抽象ベースタイプCollisionNode の名前をPhysicsNode
  • enableTriggerReportsをsendTriggerReports 。receiveTriggerReports
• CharacterController
  • speed の名前をmovement
• ConvexMeshShape
  • の名前をmeshSource に変更した。source
• HeightFieldShape
  • の名前をheightMap に変更した。source
• TriangleMeshShape
  • の名前をmeshSource に変更した。source
• PhysicsWorld ( からリネーム)DynamicsWorld
  • forceDebugView からforceDebugDraw
  • minTimestep/maxTimestep をminimumTimestep/ にリネーム。maximumTimestep
  • シーンノードを削除
  • 追加scene
  • 追加viewport
• DynamicRigidBody
  • axisLockLinearX/Y/Z プロパティを、ビットフィールドを取る単一のプロパティlinearAxisLock に変更。
  • axisLockAngularX/Y/Z プロパティを、ビットフィールドを取る単一のプロパティangularAxisLock に変更。
  • 新しいプロパティkinematicPosition,kinematicEulerRotation,kinematicRotation, を追加。kinematicPivot
  • Density enum 値をDefaultDensity/CustomDensity に変更し、負の値の特殊ケーシングを削除。
  • linearVelocity プロパティをメソッドsetLinearVelocity に置き換えた。
  • angularVelocity プロパティをsetAngularVelocity メソッドに置き換えた。