Modules/Graphics/README.md
Шурупов Илья Викторович c06f12103e Replace GLFW with a native Wayland window backend
Graphics now talks to the compositor directly through wayland-client and
xdg-shell instead of GLFW and libdecor. Wayland is the only supported
platform for now.

Architecture:
- WaylandConnection binds the globals (xdg_wm_base, wl_seat, data device,
  viewporter, fractional scale, cursor shape, text-input-v3,
  xdg-decoration) and runs a prepared-read poll loop.
- WaylandWindow owns the surface and toplevel, applies configures
  (size, maximized, tiled, activated), fractional scale through a
  viewport, the window geometry and input region, and starts compositor
  move and resize.
- WaylandSeat handles the pointer (cursor shapes, wheel), the keyboard
  (xkbcommon keymap, compose, key repeat on a timerfd in the same poll),
  the clipboard and IME commits.
- VulkanContext no longer knows about the windowing system: a
  VulkanSurfaceSource supplies instance extensions, the surface and the
  framebuffer extent, and the swapchain switches to premultiplied alpha
  when the surface supports it.
- WindowInputDispatcher feeds EventHandler and input observers;
  ImGuiPlatform replaces imgui_impl_glfw on top of it, including
  cursors, clipboard and the IME rectangle.

The window draws its own frame. WindowFrame holds the geometry: a
transparent shadow margin around the content, rounded corners, an input
region and edge hit-testing for resizing. After the UI and ImGui, a
separate nanovg pass cuts the corners, strokes the outline and paints
the shadow behind the content. Maximized or tiled windows drop the
margin; without compositor alpha the window stays opaque and square but
still resizes from its edges.

Window gains minimize, toggleMaximize, beginMove, beginResize,
showWindowMenu, setCursor, clipboard and text input. Applications keep
their existing API.

Without libdecor, a resize configure reaches the next drawn frame in
1.9 ms median (3.6 ms worst) over a scripted maximize/restore loop;
animated frames stay paced at the display refresh and the idle gallery
uses about 1% of a core.
2026-10-14 22:35:53 +03:00

1.5 KiB

Graphics

Native Wayland window, Vulkan presentation, nanovg canvas and ImGui debug UI. Wayland is the only supported platform.

Window backend

  • WaylandConnection binds the globals: xdg_wm_base, wl_seat, wl_data_device_manager, wp_viewporter, wp_fractional_scale_v1, wp_cursor_shape_v1, zwp_text_input_v3 and xdg-decoration.
  • WaylandWindow owns the surface and toplevel, applies configures (size, maximized, tiled, activated), fractional scale through a viewport, the window geometry and input region, and starts compositor move/resize.
  • WaylandSeat handles pointer (cursor shapes, wheel), keyboard (xkbcommon keymap, compose, key repeat through a timerfd in the same poll), clipboard (text/plain;charset=utf-8) and IME commits from text-input-v3.
  • WindowFrame is the pure geometry of the client-side frame: shadow margin, content rect, input region and edge hit-testing. It is unit-tested.
  • WindowInputDispatcher turns backend input into EventHandler events and forwards it to observers such as ImGuiPlatform, which feeds ImGui IO.

Frame

The surface is the content plus a transparent shadow margin. Each frame draws the UI in content coordinates, then ImGui, then a separate nanovg pass that cuts the rounded corners, strokes the outline and paints the shadow behind the content. The swapchain uses premultiplied alpha when the surface supports it.

Tests

TestGraphics covers frame geometry and key mapping without a display.