Phosphor
Qt6 / Wayland library suite for window-management tools
Loading...
Searching...
No Matches
PhosphorProtocol::Service::DropProxyKey Namespace Reference

Keys of the drop-proxy JSON a shell registers on org.phosphor_works.Placement.WindowDrag (registerDropProxy). More...

Functions

constexpr QLatin1String Rect ("rect")
 The miniature's bounding rect on its screen.
constexpr QLatin1String Cells ("cells")
 Array of cells, one per drawn zone, each {id, rect}.
constexpr QLatin1String Id ("id")
 A cell's target: the snapping zone id, braces included, as the layout interfaces spell it.

Detailed Description

Keys of the drop-proxy JSON a shell registers on org.phosphor_works.Placement.WindowDrag (registerDropProxy).

The Phosphor shell's placement map is a miniature of a snapping screen's zones; registering it as a drop proxy lets a real compositor drag that lands on the miniature resolve to the full-size zone under the cursor. The shell builds the object (phosphor-shell-libs/libs/phosphor-shell/src/placementmapparser.cpp), the daemon (plasmazones/src/dbus/windowdragadaptor/dropproxy.cpp) parses it. Every rect is [x, y, w, h] in the registering screen's LOGICAL pixels, the units the compositor lays windows out in (not the output's device pixels, which differ on a scaled output), with the screen's top-left corner as the origin.

Function Documentation

◆ Cells()

QLatin1String PhosphorProtocol::Service::DropProxyKey::Cells ( "cells" )
inlineconstexpr

Array of cells, one per drawn zone, each {id, rect}.

◆ Id()

QLatin1String PhosphorProtocol::Service::DropProxyKey::Id ( "id" )
inlineconstexpr

A cell's target: the snapping zone id, braces included, as the layout interfaces spell it.

◆ Rect()

QLatin1String PhosphorProtocol::Service::DropProxyKey::Rect ( "rect" )
inlineconstexpr

The miniature's bounding rect on its screen.

A cursor outside it is not over the proxy at all.