Wayland backend

src/conf.rs

@@ -101,6 +101,22 @@ pub enum WebGLVersion {
     WebGL2,
 }
 
+/// On Wayland, specify how to draw client-side decoration (CSD) if server-side decoration (SSD) is
+/// not supported (e.g., on GNOME).
+///
+/// Defaults to ServerWithLibDecorFallback
+#[derive(Clone, Copy, Debug, Default, PartialEq, Eq, Hash)]
+pub enum WaylandDecorations {
+    /// If SSD is not supported, will try to load `libdecor` to draw CSD. This is the default
+    /// choice.
+    #[default]
+    ServerWithLibDecorFallback,
+    /// If SSD is not supported, draw a light gray border.
+    ServerWithMiniquadFallback,
+    /// If SSD is not supported, no CSD will be drawn.
+    ServerOnly,
+}
+
 /// Platform-specific settings.
 #[derive(Clone, Copy, Debug, PartialEq, Eq, Hash)]
 pub struct Platform {
@@ -143,14 +159,16 @@ pub struct Platform {
     /// - TODO: Document(and check) what does it actually mean on android. Transparent window?
     pub framebuffer_alpha: bool,
 
-    /// When using Wayland, this controls whether to draw the default window decorations.
-    pub wayland_use_fallback_decorations: bool,
+    /// On Wayland, specifies how to draw client-side decoration (CSD) if server-side decoration (SSD) is
+    /// not supported (e.g., on GNOME).
+    pub wayland_decorations: WaylandDecorations,
 
-    /// Set the `WM_CLASS` window property on X11
+    /// Set the `WM_CLASS` window property on X11 and the `app_id` on Wayland. This is used
+    /// by gnome to determine the window icon (together with an external `.desktop` file).
     // in fact `WM_CLASS` contains two strings "instance name" and "class name"
     // for most purposes they are the same so we just use class name for simplicity
     // https://unix.stackexchange.com/questions/494169/
-    pub linux_x11_wm_class: &'static str,
+    pub linux_wm_class: &'static str,
 }
 
 impl Default for Platform {
@@ -163,8 +181,8 @@ impl Default for Platform {
             blocking_event_loop: false,
             swap_interval: None,
             framebuffer_alpha: false,
-            wayland_use_fallback_decorations: true,
-            linux_x11_wm_class: "miniquad-application",
+            wayland_decorations: WaylandDecorations::default(),
+            linux_wm_class: "miniquad-application",
         }
     }
 }
@@ -203,8 +221,8 @@ pub struct Conf {
     /// - On macOS, Dock/title bar icon
     /// - TODO: Favicon on HTML5
     /// - TODO: Taskbar/title bar icon on Linux (depends on WM)
-    /// - Note: on gnome (with X11), icon is determined using `WM_CLASS` (can be set under
-    /// `Platform`) and an external `.desktop` file
+    /// - Note: on gnome, icon is determined using `WM_CLASS` (can be set under [`Platform`]) and
+    ///   an external `.desktop` file
     pub icon: Option<Icon>,
 
     /// Platform-specific hints (e.g., context creation, driver settings).