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

Per-window open-behaviour overrides resolved from window rules (openColumnWidth / openTabbed / openColumnPlacement). More...

#include <PhosphorScrollEngine/ScrollEngineTypes.h>

Public Attributes

std::optional< qreal > widthFraction
std::optional< qreal > heightFraction
 Work-area height fraction (openWindowHeight rule), committed as a Fixed pixel intent against the live work area after the insert.
std::optional< bool > tabbed
std::optional< bool > consume
 True: join the focused column instead of opening a new one.
std::optional< bool > maximized
 True: the new column opens at the full work-area width (openMaximized rule).
std::optional< bool > focused
 Per-window override of IScrollSettings::scrollingFocusNewWindows (openFocused rule).
std::optional< QString > tabGroup
 Named tab group (openTabGroup rule), trimmed and non-empty when engaged.

Detailed Description

Per-window open-behaviour overrides resolved from window rules (openColumnWidth / openTabbed / openColumnPlacement).

Unset fields fall through to the engine's config-backed defaults — config stays the authoritative base, rules layer on top.

Member Data Documentation

◆ consume

std::optional<bool> PhosphorScrollEngine::ScrollOpenParams::consume

True: join the focused column instead of opening a new one.

◆ focused

std::optional<bool> PhosphorScrollEngine::ScrollOpenParams::focused

Per-window override of IScrollSettings::scrollingFocusNewWindows (openFocused rule).

Consumed by windowOpened's focus arm, not by the insert itself; the engine's FLOAT exits ignore it (a floated open keeps the compositor's own focus verdict).

◆ heightFraction

std::optional<qreal> PhosphorScrollEngine::ScrollOpenParams::heightFraction

Work-area height fraction (openWindowHeight rule), committed as a Fixed pixel intent against the live work area after the insert.

◆ maximized

std::optional<bool> PhosphorScrollEngine::ScrollOpenParams::maximized

True: the new column opens at the full work-area width (openMaximized rule).

Outranks widthFraction and the template blueprint — a maximized open IS a width verdict, the stronger one.

It only reaches a column that this open CREATES, which is what the three width-dropping arrival shapes have in common: a consume open (the openColumnPlacement rule or an IntoActiveColumn insert position) joins an existing column and keeps the HOST's width, since resizing the host would resize every sibling in the stack, and a strip-stash restore rebuilds the column's remembered width. widthFraction is dropped by the same three, for the same reason.

◆ tabbed

std::optional<bool> PhosphorScrollEngine::ScrollOpenParams::tabbed

◆ tabGroup

std::optional<QString> PhosphorScrollEngine::ScrollOpenParams::tabGroup

Named tab group (openTabGroup rule), trimmed and non-empty when engaged.

The open joins, as a tab, a column holding a window whose own resolved params carry the same name; an engaged name outranks the app-keyed IScrollSettings::scrollingGroupSameAppAsTabs default and never falls back to it. A consume open outranks both.

◆ widthFraction

std::optional<qreal> PhosphorScrollEngine::ScrollOpenParams::widthFraction

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