video: allow configuring the output brightness

toml-spec/spec/spec.generated.json

@@ -423,6 +423,22 @@
         }
       ]
     },
+    "Brightness": {
+      "description": "The brightness setting of an output.\n",
+      "anyOf": [
+        {
+          "type": "string",
+          "description": "The default brightness setting.\n",
+          "enum": [
+            "default"
+          ]
+        },
+        {
+          "type": "number",
+          "description": "The brightness in cd/m^2.\n"
+        }
+      ]
+    },
     "Color": {
       "type": "string",
       "description": "A color.\n\nThe format should be one of the following:\n\n- `#rgb`\n- `#rrggbb`\n- `#rgba`\n- `#rrggbba`\n"
@@ -1168,6 +1184,10 @@
         "transfer-function": {
           "description": "The transfer function of the output.\n",
           "$ref": "#/$defs/TransferFunction"
+        },
+        "brightness": {
+          "description": "The brightness of the output.\n\nThis setting has no effect unless the vulkan renderer is used.\n",
+          "$ref": "#/$defs/Brightness"
         }
       },
       "required": [

toml-spec/spec/spec.generated.md

@@ -575,6 +575,34 @@ This table is a tagged union. The variant is determined by the `type` field. It
     The value of this field should be a [DrmDeviceMatch](#types-DrmDeviceMatch).
 
 
+<a name="types-Brightness"></a>
+### `Brightness`
+
+The brightness setting of an output.
+
+Values of this type should have one of the following forms:
+
+#### A string
+
+The default brightness setting.
+
+The string should have one of the following values:
+
+- `default`:
+
+  The default brightness setting.       
+  
+  The behavior depends on the transfer function:
+  
+  - `default`: The maximum brightness of the output.
+  - `PQ`: 203 cd/m^2
+
+
+#### A number
+
+The brightness in cd/m^2.
+
+
 <a name="types-Color"></a>
 ### `Color`
 
@@ -2561,6 +2589,14 @@ The table has the following fields:
 
   The value of this field should be a [TransferFunction](#types-TransferFunction).
 
+- `brightness` (optional):
+
+  The brightness of the output.
+  
+  This setting has no effect unless the vulkan renderer is used.
+
+  The value of this field should be a [Brightness](#types-Brightness).
+
 
 <a name="types-OutputMatch"></a>
 ### `OutputMatch`

toml-spec/spec/spec.yaml

@@ -1641,6 +1641,13 @@ Output:
       required: false
       description: |
         The transfer function of the output.
+    brightness:
+      ref: Brightness
+      required: false
+      description: |
+        The brightness of the output.
+        
+        This setting has no effect unless the vulkan renderer is used.
 
 
 Transform:
@@ -2794,3 +2801,25 @@ TransferFunction:
       description: The default transfer function (usually sRGB).
     - value: pq
       description: The PQ transfer function.
+
+
+Brightness:
+  kind: variable
+  description: |
+    The brightness setting of an output.
+  variants:
+    - kind: string
+      description: | 
+        The default brightness setting.
+      values:
+        - value: default
+          description: |
+            The default brightness setting.       
+            
+            The behavior depends on the transfer function:
+            
+            - `default`: The maximum brightness of the output.
+            - `PQ`: 203 cd/m^2
+    - kind: number
+      description: |
+        The brightness in cd/m^2.