Physical and virtual screen topology, panel reservations, and the canonical org.phosphor_works.Placement.Screen D-Bus surface.
Owns the mapping from "here's a cursor position" to "here's the screen ID you should route the next event to." Tracks physical screens as reported by QScreen, user-defined virtual sub-regions within each physical screen, and panel reservations from taskbars, docks, and status bars that eat part of the usable geometry. Exposes all of it on the canonical org.phosphor_works.Placement.Screen D-Bus interface so downstream consumers stay compositor-agnostic.
The library is split so the screen-topology core does not drag QtDBus into pure-compute consumers:
| CMake target | Links | Linked by |
|---|---|---|
| PhosphorScreens::Core | Qt6::Core + Qt6::Gui | Domain libraries (zones, snap/tile engines, placement) that need POD topology types + identity but never touch the bus or the live manager. |
| PhosphorScreens::Runtime | ::Core + Qt6::Core + Qt6::Gui (+ PhosphorWayland privately) | Consumers that need the live ScreenManager (physical-screen tracking via Wayland). |
| PhosphorScreens::PhosphorScreens | ::Runtime + Qt6::DBus + PhosphorProtocol::Types | The daemon and anything that needs the D-Bus surface (DBusScreenAdaptor, PlasmaPanelSource, ScreenResolver). |
| Type | Purpose |
|---|---|
| PhosphorScreens::ScreenManager | Physical + virtual topology state with change signals as screens come and go. |
| PhosphorScreens::ScreenResolver | Point-to-screen lookup that accepts an optional D-Bus endpoint override. |
| PhosphorScreens::IPanelSource | Pluggable panel-reservation source per desktop (Plasma, GNOME, wlr). |
| PhosphorScreens::PlasmaPanelSource | Bundled IPanelSource for org.kde.plasmashell reservations. |
| PhosphorScreens::VirtualScreenDef | One rectangular sub-region of a physical screen with its own screen ID. |
| PhosphorScreens::VirtualScreenSwapper | D-Bus-addressable directional virtual-screen swaps (left, right, up, down). |
| PhosphorScreens::DBusScreenAdaptor | Canonical org.phosphor_works.Placement.Screen D-Bus surface. |
| PhosphorScreens::IConfigStore | Persisted virtual-screen configuration. InMemoryConfigStore is the default for tests. |