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. | |
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.
| WindowHeight PhosphorScrollEngine::StashedTile::height |
| 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.
| 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.
| 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.
| 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.
| QString PhosphorScrollEngine::StashedTile::windowId |