metal: make post_commit_margin configurable

toml-spec/spec/spec.generated.json

@@ -653,6 +653,10 @@
         "gfx-api": {
           "description": "If specified, sets the graphics API to use for this device.\n",
           "$ref": "#/$defs/GfxApi"
+        },
+        "flip-margin-ms": {
+          "type": "number",
+          "description": "If specified, sets the flip margin of this device.\n\nThis is duration between the compositor initiating a page flip and the output's\nvblank event. This determines the minimum input latency. The default is 1.5 ms.\n\nNote that if the margin is too small, the compositor will dynamically increase it.\n"
         }
       },
       "required": [

toml-spec/spec/spec.generated.md

@@ -1266,6 +1266,17 @@ The table has the following fields:
 
   The value of this field should be a [GfxApi](#types-GfxApi).
 
+- `flip-margin-ms` (optional):
+
+  If specified, sets the flip margin of this device.
+  
+  This is duration between the compositor initiating a page flip and the output's
+  vblank event. This determines the minimum input latency. The default is 1.5 ms.
+  
+  Note that if the margin is too small, the compositor will dynamically increase it.
+
+  The value of this field should be a number.
+
 
 <a name="types-DrmDeviceMatch"></a>
 ### `DrmDeviceMatch`

toml-spec/spec/spec.yaml

@@ -944,6 +944,16 @@ DrmDevice:
       required: false
       description: |
         If specified, sets the graphics API to use for this device.
+    flip-margin-ms:
+      kind: number
+      required: false
+      description: |
+        If specified, sets the flip margin of this device.
+        
+        This is duration between the compositor initiating a page flip and the output's
+        vblank event. This determines the minimum input latency. The default is 1.5 ms.
+        
+        Note that if the margin is too small, the compositor will dynamically increase it.
 
 
 GfxApi: