Vehicles: Add braking, add change rate, rename current to target

Author: aaronfranke

extensions/2.0/OMI_vehicle_body/README.md

@@ -170,13 +170,28 @@ The actual control scheme is implementation-defined. It may be <kbd>W</kbd> and
 
 Aside from `"useThrottle"` determining how input affects activation, there is also the matter of how throttle affects the vehicle's thrust. If `"maxSpeed"` is non-negative, the throttle should be a ratio of that speed, with the thrust adjusting so that the vehicle meets the target speed. Otherwise, the throttle should be a ratio of the thrust power, allowing the throttle to control the ratio of the vehicle's acceleration power.
 
+### glTF Object Model
+
+The following JSON pointers are defined representing mutable properties defined by this extension, for use with the glTF Object Model including extensions such as `KHR_animation_pointer` and `KHR_interactivity`:
+
+| JSON Pointer                                              | Object Model Type |
+| --------------------------------------------------------- | ----------------- |
+| `/nodes/{}/extensions/OMI_vehicle_body/angularActivation` | `float3`          |
+| `/nodes/{}/extensions/OMI_vehicle_body/linearActivation`  | `float3`          |
+| `/nodes/{}/extensions/OMI_vehicle_body/gyroTorque`        | `float3`          |
+| `/nodes/{}/extensions/OMI_vehicle_body/maxSpeed`          | `float`           |
+| `/nodes/{}/extensions/OMI_vehicle_body/angularDampeners`  | `boolean`         |
+| `/nodes/{}/extensions/OMI_vehicle_body/linearDampeners`   | `boolean`         |
+| `/nodes/{}/extensions/OMI_vehicle_body/useThrottle`       | `boolean`         |
+
 ### JSON Schema
 
 See [schema/node.OMI_vehicle_body.schema.json](schema/node.OMI_vehicle_body.schema.json).
 
 ## Known Implementations
 
-- Godot Engine
+- Basis VR: https://github.com/BasisVR/Basis/pull/442
+- Godot Engine: https://github.com/omigroup/omi-godot/tree/main/addons/omi_extensions/vehicle
 
 ## Resources:
 

extensions/2.0/OMI_vehicle_body/schema/node.OMI_vehicle_body.schema.json

@@ -36,7 +36,7 @@
         },
         "maxSpeed": {
             "type": "number",
-            "description": "If non-negative, the speed in meters per second at which the vehicle should stop driving acceleration further.",
+            "description": "If non-negative, the speed in meters per second at which the vehicle should stop driving acceleration further. If throttle is used, activation is a ratio of this speed if positive, or a ratio of thrust power if negative.",
             "default": -1.0
         },
         "pilotSeat": {
@@ -56,7 +56,7 @@
         },
         "useThrottle": {
             "type": "boolean",
-            "description": "If true, the vehicle should use a throttle for forward movement. If maxSpeed is non-negative, the throttle should be a ratio of that speed, otherwise it should be a ratio of thrust power.",
+            "description": "If true, the vehicle should use a throttle for linear movement. If maxSpeed is non-negative, the throttle should be a ratio of that speed, otherwise it should be a ratio of thrust power.",
             "default": false
         },
         "extensions": { },

extensions/2.0/OMI_vehicle_hover_thruster/README.md

@@ -128,7 +128,6 @@
     ],
     "materials": [
         {
-            "extensions": {},
             "name": "HovercraftMaterial",
             "pbrMetallicRoughness": {
                 "baseColorFactor": [1, 1, 1, 1],
@@ -177,31 +176,31 @@
             "extensions": {
                 "OMI_vehicle_hover_thruster": { "hoverThruster": 0 }
             },
-            "name": "HoverThrusterBL",
+            "name": "HoverThrusterRearLeft",
             "rotation": [-0.42660024762154, -0.33944433927536, -0.17670360207558, 0.81949108839035],
             "translation": [1.2, -0.25, -2.1]
         },
         {
             "extensions": {
                 "OMI_vehicle_hover_thruster": { "hoverThruster": 0 }
             },
-            "name": "HoverThrusterBR",
+            "name": "HoverThrusterRearRight",
             "rotation": [-0.42660024762154, 0.33944433927536, 0.176703602075577, 0.81949108839035],
             "translation": [-1.2, -0.25, -2.1]
         },
         {
             "extensions": {
                 "OMI_vehicle_hover_thruster": { "hoverThruster": 0 }
             },
-            "name": "HoverThrusterFL",
+            "name": "HoverThrusterFrontLeft",
             "rotation": [0.176703602075577, 0.81949108839035, 0.426600247621536, -0.33944433927536],
             "translation": [1.2, -0.25, 2.1]
         },
         {
             "extensions": {
                 "OMI_vehicle_hover_thruster": { "hoverThruster": 0 }
             },
-            "name": "HoverThrusterFR",
+            "name": "HoverThrusterFrontRight",
             "rotation": [-0.17670360207558, 0.81949108839035, 0.426600247621536, 0.33944433927536],
             "translation": [-1.2, -0.25, 2.1]
         },

extensions/2.0/OMI_vehicle_hover_thruster/examples/hovercraft.gltf

@@ -4,29 +4,52 @@
     "title": "OMI_vehicle_hover_thruster Hover Thruster Parameters",
     "type": "object",
     "properties": {
-        "currentForceRatio": {
+        "gimbalChangeRate": {
             "type": "number",
-            "description": "The ratio of the maximum hover energy the hover thruster is using for propulsion.",
-            "default": 0.0
+            "description": "The rate at which the hover thruster can change its gimbal angles, measured in radians per second (rad/s). If negative, the hover thruster instantly changes to the desired gimbal.",
+            "default": 1.0
         },
-        "currentGimbalRatio": {
-            "type": "array",
-            "description": "The ratio of the maximum gimbal angles the hover thruster is rotated to.",
-            "items": {
-                "type": "number"
-            },
-            "minItems": 2,
-            "maxItems": 2,
-            "default": [0.0, 0.0]
+        "hoverEnergyChangeRate": {
+            "type": "number",
+            "description": "The rate at which the hover thruster can change its applied hover energy, measured in Newton-meters per second (N⋅m/s) or kilograms meters squared per second cubed (kg⋅m²/s³) in SI base units. If negative or not specified, the hover thruster instantly changes to the desired hover energy.",
+            "default": -1.0
         },
-        "maxHoverEnergy": {
+        "linearGimbalAdjustRatio": {
             "type": "number",
-            "description": "The maximum hover energy force in Newton-meters (N⋅m or kg⋅m²/s²) that the hover thruster can provide. Required."
+            "description": "The maximum ratio of how a vehicle's linear activation should adjust the hover thruster's gimbal.",
+            "default": 0.5,
+            "maximum": 1.0,
+            "minimum": 0.0
         },
         "maxGimbal": {
             "type": "array",
             "description": "The maximum angle the hover thruster can gimbal or rotate in radians.",
-            "default": 0.0
+            "default": 0.0,
+            "maximum": 3.1415925,
+            "minimum": 0.0
+        },
+        "maxHoverEnergy": {
+            "type": "number",
+            "description": "The maximum hover energy force in Newton-meters (N⋅m or kg⋅m²/s²) that the hover thruster can provide. Required.",
+            "minimum": 0.0
+        },
+        "targetHoverRatio": {
+            "type": "number",
+            "description": "The ratio of the maximum hover energy the hover thruster is targeting for propulsion. MUST NOT be negative. Values greater than 1.0 have implementation-defined behavior.",
+            "default": 0.0,
+            "minimum": 0.0
+        },
+        "targetGimbalRatio": {
+            "type": "array",
+            "description": "The ratio of the maximum gimbal angles the hover thruster is targeting to be rotated to. MUST NOT have a length greater than 1.0.",
+            "items": {
+                "type": "number",
+                "maximum": 1.0,
+                "minimum": -1.0
+            },
+            "minItems": 2,
+            "maxItems": 2,
+            "default": [0.0, 0.0]
         },
         "extensions": { },
         "extras": { }