PhosphorCompositor::TilingStateHelpers Namespace Reference

Compositor-agnostic tiling-family state accessors and pure helpers. More...

Classes
struct	TilingWindowState
	Bundles per-window state maps for cleanup operations. More...

Functions
QString	screenForTiledWindow (const BorderState &border, const QString &windowId)
	The screen a tiled window is tracked on, or empty if it is not tiled.
bool	isTiledWindow (const BorderState &border, const QString &windowId)
void	cleanupClosedWindowState (const QString &windowId, BorderState &border, TilingWindowState &state)
	Clean up all state tracking for a closed window.
void	addTiledOnScreen (BorderState &border, const QString &screenId, const QString &windowId)
	Add a window to a screen's tiled bucket. Idempotent.
bool	removeTiledOnScreen (BorderState &border, const QString &screenId, const QString &windowId)
	Remove a window from a specific screen's tiled bucket.
void	removeFromOtherScreens (BorderState &border, const QString &windowId, const QString &keepScreenId)
	Remove a window from every screen's tiled bucket EXCEPT keepScreenId (cross-screen transfer: a window is tile-managed by one screen at a time, so re-recording on a new screen first strips any stale sibling claim).
bool	removeFromAllScreens (BorderState &border, const QString &windowId)
	Remove a window from every screen's tiled bucket.
QSet< QString >	tiledOnScreen (const BorderState &border, const QString &screenId)
	Detached copy of the set of tiled windows on a given screen (QHash::value copy, not a reference).

Detailed Description

Compositor-agnostic tiling-family state accessors and pure helpers.

These functions operate on BorderState and other pure data structures without touching any compositor APIs. Shared by all compositor plugins.

Function Documentation

addTiledOnScreen()

void PhosphorCompositor::TilingStateHelpers::addTiledOnScreen ( BorderState &  border, const QString &  screenId, const QString &  windowId  )

inline

Add a window to a screen's tiled bucket. Idempotent.

cleanupClosedWindowState()

void PhosphorCompositor::TilingStateHelpers::cleanupClosedWindowState ( const QString &  windowId, BorderState &  border, TilingWindowState &  state  )

inline

Clean up all state tracking for a closed window.

Removes the window from all QSet/QHash state maps. Does NOT handle D-Bus calls or compositor-specific cleanup.

isTiledWindow()

bool PhosphorCompositor::TilingStateHelpers::isTiledWindow ( const BorderState &  border, const QString &  windowId  )

inline

removeFromAllScreens()

bool PhosphorCompositor::TilingStateHelpers::removeFromAllScreens ( BorderState &  border, const QString &  windowId  )

inline

Remove a window from every screen's tiled bucket.

Returns true if any bucket contained it.

removeFromOtherScreens()

void PhosphorCompositor::TilingStateHelpers::removeFromOtherScreens ( BorderState &  border, const QString &  windowId, const QString &  keepScreenId  )

inline

Remove a window from every screen's tiled bucket EXCEPT keepScreenId (cross-screen transfer: a window is tile-managed by one screen at a time, so re-recording on a new screen first strips any stale sibling claim).

removeTiledOnScreen()

bool PhosphorCompositor::TilingStateHelpers::removeTiledOnScreen ( BorderState &  border, const QString &  screenId, const QString &  windowId  )

inline

Remove a window from a specific screen's tiled bucket.

Returns true if it was present. Erases the bucket if it becomes empty.

screenForTiledWindow()

QString PhosphorCompositor::TilingStateHelpers::screenForTiledWindow ( const BorderState &  border, const QString &  windowId  )

inline

The screen a tiled window is tracked on, or empty if it is not tiled.

Membership and screen come from the SAME entry here, so they cannot disagree. That matters wherever a consumer needs both facts: the sibling per-window screen map is written under a narrower condition than tiled-membership is, so a window can be a tiled member that map has no entry for, and a consumer requiring both then silently gets "unknown".

tiledOnScreen()

QSet< QString > PhosphorCompositor::TilingStateHelpers::tiledOnScreen ( const BorderState &  border, const QString &  screenId  )

inline

Detached copy of the set of tiled windows on a given screen (QHash::value copy, not a reference).

Empty if none.