PhosphorOverlay Namespace Reference

Classes
class	ShellHost
class	ShellState
struct	SlotEntry

Functions
PHOSPHOROVERLAY_EXPORT PhosphorLayer::Role	makePerInstanceRole (const PhosphorLayer::Role &base, QStringView screenId, quint64 generation)
	Build a per-instance PhosphorLayer::Role by appending -{screenId}-{generation} to base's scope prefix.

Function Documentation

makePerInstanceRole()

PHOSPHOROVERLAY_EXPORT PhosphorLayer::Role PhosphorOverlay::makePerInstanceRole	(	const PhosphorLayer::Role &	base,
		QStringView	screenId,
		quint64	generation
	)

Build a per-instance PhosphorLayer::Role by appending -{screenId}-{generation} to base's scope prefix.

Single-source for the policy "per-instance scope prefix-matches the base role's prefix" so the SurfaceAnimator's longest-prefix lookup always resolves the base role's registered config.

Pre-existing failure modes this prevents:

• Build the per-instance literal from scratch (e.g. typo), or
• Pass a different base role and re-type the literal, then later rename the family role. Either case made the longest-prefix match silently miss and the surface fell back to the library's empty default config.

Parameters

base	Named base role (e.g. PassiveShell pattern in PZ).
screenId	Effective screen id (physical or virtual).
generation	Monotonic per-process counter, e.g. from PhosphorSurfaces::SurfaceManager::nextScopeGeneration().