Phosphor
Qt6 / Wayland library suite for window-management tools
Loading...
Searching...
No Matches
PhosphorScrollEngine::StashedTile Struct Reference

The mode-round-trip strip stash value types (ScrollEngine::m_stripStash). More...

#include <PhosphorScrollEngine/ScrollStashTypes.h>

Public Attributes

QString windowId
WindowHeight height
bool minimized = false
 Carried for serialization fidelity only — the restore paths do not re-apply it (the effect re-reports live minimize state).
bool windowedFullscreen = false
 Windowed fullscreen, carried through stash/serialize and RE-APPLIED on exact-id claims only (unlike minimized above; the fuzzy appId claim deliberately does not — see restoreFromStripStash): the flag is strip-owned state the compositor mirrors, so a restart must hand it back or the client stays fullscreen-configured with nothing on record saying so.
bool stagedFromPersistence = false
 True while THIS tile was staged from the persisted blob and has not been claimed.
int unclaimedSessions = 0
 Consecutive logins THIS tile was staged without ever being claimed.

Detailed Description

The mode-round-trip strip stash value types (ScrollEngine::m_stripStash).

Namespace-level rather than nested in ScrollEngine; semantics and lifetime are documented on the engine's m_stripStash member, and StashedTile::stagedFromPersistence below carries the cross-session lease contract.

Member Data Documentation

◆ height

WindowHeight PhosphorScrollEngine::StashedTile::height

◆ minimized

bool PhosphorScrollEngine::StashedTile::minimized = false

Carried for serialization fidelity only — the restore paths do not re-apply it (the effect re-reports live minimize state).

It reads false for every tile a production daemon ever stashes: its source is Tile::minimized, and the only writer of that flag is ScrollStrip::setWindowMinimized, which is a TEST SEAM (the daemon models minimize as a float, so a minimized window is not a strip tile at all). The field exists so the strip model's minimized domain stays round-trippable if the daemon ever drives it directly; see the seam note on setWindowMinimized.

◆ stagedFromPersistence

bool PhosphorScrollEngine::StashedTile::stagedFromPersistence = false

True while THIS tile was staged from the persisted blob and has not been claimed.

Per tile, not per entry: a key co-tenanted by a returning app and a dead one must age the dead tile out while the returning one keeps claiming, and a claim on one tile must not expose an unclaimed co-tenant to the aliveness sweep.

A staged tile names LAST session's window id, which by design appears in no live alive-set: the cross-session claim in restoreFromStripStash matches on the appId prefix precisely because the per-instance half of the id is regenerated every launch. pruneStaleWindows' sweep must therefore not read "absent from the alive set" as "closed" while this holds, or the very first prune after login (the effect fires one at bring-up, right after the daemon stages the snapshot) would erase it and undo the structure/focus/anchor restore. Cleared on claim, at which point the tile is anchored in THIS session's id space and the sweep is meaningful. A tile whose app never relaunches is aged out by the unclaimedSessions lease below instead.

◆ unclaimedSessions

int PhosphorScrollEngine::StashedTile::unclaimedSessions = 0

Consecutive logins THIS tile was staged without ever being claimed.

Incremented at serialize while stagedFromPersistence holds; a claim zeroes it; restoreStripState drops a tile that has gone kMaxUnclaimedSessions logins unclaimed. The aging exists because pruneStaleWindows fires exactly ONCE per session (at bring-up, while the TILE is still sweep-exempt), so no sweep can ever reach a persisted tile whose app never relaunches — without the lease it would be re-staged forever and eventually hand an unrelated same-app window a long-dead slot.

◆ windowedFullscreen

bool PhosphorScrollEngine::StashedTile::windowedFullscreen = false

Windowed fullscreen, carried through stash/serialize and RE-APPLIED on exact-id claims only (unlike minimized above; the fuzzy appId claim deliberately does not — see restoreFromStripStash): the flag is strip-owned state the compositor mirrors, so a restart must hand it back or the client stays fullscreen-configured with nothing on record saying so.

◆ windowId

QString PhosphorScrollEngine::StashedTile::windowId

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