phosphor-screens

Physical and virtual screen topology resolver.

The seam between "here's a cursor position" and "here's the screen ID you should route the next event to". ScreenManager tracks physical screens, user-defined virtual sub-regions within them, and panel reservations via a pluggable IPanelSource per desktop. ScreenResolver maps a global point to its effective screen and virtual screen. VirtualScreenSwapper handles D-Bus-addressable directional virtual-screen swaps. DBusScreenAdaptor exposes the whole surface on the canonical org.plasmazones.Screen interface so downstream consumers stay compositor-agnostic.

Full API →

Key types

ScreenManager
Physical and virtual screen topology state with change signals.
ScreenResolver
Point-to-screen lookup; accepts an optional D-Bus endpoint override.
VirtualScreenSwapper
D-Bus-addressable directional virtual-screen swaps (left/right/up/down).
IPanelSource
Pluggable panel-reservation source per desktop; the Plasma source ships built in.
DBusScreenAdaptor
Canonical org.plasmazones.Screen D-Bus surface.

Dependencies

See also

phosphor-identity
VirtualScreenId is the stable screen handle.
phosphor-protocol
Service / interface names come from ServiceConstants.

References