What a matched open-placement rule directs for an opening window. More...

#include <phosphor-snap-engine/include/PhosphorSnapEngine/PlacementDirective.h>

Public Attributes
QList< int >	zoneOrdinals {}

QString	targetScreenId {}

int	targetDesktop = 0

QStringList	zoneNames {}

Detailed Description

What a matched open-placement rule directs for an opening window.

A small DTO crossing the daemon ↔ snap-engine boundary: the daemon resolves the window's matched rules and fills this in, the engine acts on it. It lives in its own lightweight header so both the engine's public API and the daemon's resolver declaration can reference it by value without pulling in the full SnapEngine definition.

zoneOrdinals — the SnapToZone ordinal list (1-based).
zoneNames — the SnapToZone zone-name list. Each name resolves to the lowest-numbered zone of that name (case-insensitive, trimmed) in the placement layout, so a name-keyed rule follows the zone across layouts that number it differently. Names and ordinals union into one span. Both lists empty means no SnapToZone rule matched; the engine then has nothing to snap.
targetScreenId — the RouteToScreen target monitor (canonical screen-id form). When non-empty the zones resolve on THAT screen and the window is moved there, restoring the per-monitor pinning the retired per-layout app rules carried. Empty means resolve on the window's opening screen (a ScreenId match leaf only SCOPES a rule; RouteToScreen is what ROUTES it).
targetDesktop — the RouteToDesktop target virtual desktop (1-based; 0 = no desktop routing). When set the zones resolve against THAT desktop's layout for the placement screen and the snap commits in that desktop's context, so a combined "snap to zone N + open on desktop M" rule places the window into zone N of desktop M's layout (not the desktop it opened on).

Member Data Documentation

◆ targetDesktop

int PhosphorSnapEngine::PlacementDirective::targetDesktop = 0

◆ targetScreenId

QString PhosphorSnapEngine::PlacementDirective::targetScreenId {}

◆ zoneNames

QStringList PhosphorSnapEngine::PlacementDirective::zoneNames {}

◆ zoneOrdinals

QList<int> PhosphorSnapEngine::PlacementDirective::zoneOrdinals {}

The documentation for this struct was generated from the following file:

phosphor-snap-engine/include/PhosphorSnapEngine/PlacementDirective.h