From b415f64f55715687a971ac19fe0b1729c3b104a8 Mon Sep 17 00:00:00 2001
From: Victoria Brekenfeld <victoria@system76.com>
Date: Fri, 8 Nov 2024 14:46:32 +0100
Subject: [PATCH] output-management: Add more detailed vrr configuration

---
 .../cosmic-output-management-unstable-v1.xml  | 56 +++++++++++++++++--
 1 file changed, 52 insertions(+), 4 deletions(-)

diff --git a/unstable/cosmic-output-management-unstable-v1.xml b/unstable/cosmic-output-management-unstable-v1.xml
index 8ab18522ba..ec8cce541a 100644
--- a/unstable/cosmic-output-management-unstable-v1.xml
+++ b/unstable/cosmic-output-management-unstable-v1.xml
@@ -33,7 +33,7 @@
     it's best to be forward compatible.
   </description>
 
-  <interface name="zcosmic_output_manager_v1" version="1">
+  <interface name="zcosmic_output_manager_v1" version="2">
     <description summary="Output configuration manager">
         This interface provides extension points for wlr-output-management types.
     </description>
@@ -90,7 +90,7 @@
     </request>
   </interface>
 
-  <interface name="zcosmic_output_head_v1" version="1">
+  <interface name="zcosmic_output_head_v1" version="2">
     <description summary="Output extension object">
         Extension to zwlr_output_head_v1.
 
@@ -129,6 +129,38 @@
         in the head object anymore.
       </description>
     </request>
+
+    <!-- version 2 additions -->
+
+    <event name="adaptive_sync_available" since="2">
+      <description summary="is adaptive_sync available for this head">
+        This events describes if adaptive_sync is available for this head.
+
+        It is only sent if the output is enabled.
+      </description>
+      <arg name="available" type="uint" enum="adaptive_sync_availability"/>
+    </event>
+
+    <enum name="adaptive_sync_availability" since="2">
+      <entry name="unsupported" value="0" summary="adaptive sync is not supported"/>
+      <entry name="requires_modeset" value="1" summary="automatic adaptive_sync is unavailable"/>
+      <entry name="supported" value="2" summary="adaptive sync is supported in all states"/>
+    </enum>
+
+    <event name="adaptive_sync_ext" since="2">
+      <description summary="current adaptive_sync state">
+        This events describes the adaptive_sync state of this head.
+
+        It is only sent if the output is enabled.
+      </description>
+      <arg name="state" type="uint" enum="adaptive_sync_state_ext"/>
+    </event>
+
+    <enum name="adaptive_sync_state_ext" since="2">
+      <entry name="disabled" value="0" summary="adaptive sync is disabled"/>
+      <entry name="automatic" value="1" summary="adaptive sync will be actived automatically"/>
+      <entry name="always" value="2" summary="adaptive sync is forced to be always active"/>
+    </enum>
   </interface>
 
   <interface name="zcosmic_output_configuration_v1" version="1">
@@ -191,13 +223,14 @@
     </request>
   </interface>
 
-  <interface name="zcosmic_output_configuration_head_v1" version="1">
+  <interface name="zcosmic_output_configuration_head_v1" version="2">
     <description summary="Output configuration head extension object">
         Extension to zwlr_output_configuration_head_v1.
 
         Adds additional/alternative parameters to the original zwlr_output_configuration_head_v1.
 
-        Once the original `zwlr_output_configuration_head_v1` is destroyed this object will also be destroyed.
+        Once the original `zwlr_output_configuration_head_v1` is destroyed this object will
+        become inert and all requests except `release` will be ignored.
     </description>
 
     <request name="set_scale_1000">
@@ -221,5 +254,20 @@
         until it is destroyed.
       </description>
     </request>
+
+    <!-- version 2 additions -->
+
+    <request name="set_adaptive_sync_ext" since="2">
+      <description summary="set adaptive sync state">
+        This request requests a new adaptive sync state.
+
+        This request is meant to be used in place of `zwlr_output_configuration_head_v1::set_adaptive_sync`.
+        Using `set_adaptive_sync` and `set_adaptive_sync_ext` at once will thus raise an `already_set` error on the
+        original `zwlr_output_configuration_head_v1`.
+
+        Any request conflicting with `set_adaptive_sync` will also conflict with `set_adaptive_sync_ext`.
+      </description>
+      <arg name="state" type="uint" enum="zcosmic_output_head_v1.adaptive_sync_state_ext"/>
+    </request>
   </interface>
 </protocol>