6#include "phosphortiles_export.h"
57 Q_PROPERTY(QString
name READ
name CONSTANT)
101 return [](
const QString&) {
130 virtual QString
name()
const = 0;
505 static QRect
innerRect(const QRect& screenGeometry,
int outerGap);
Algorithm-layer constants for the autotile/tile primitives.
void setAppIdResolver(std::function< QString(const QString &)> resolver)
Inject a resolver that maps an opaque instance id to its live app class.
Definition TilingAlgorithm.h:87
virtual bool supportsMemory() const noexcept
Whether this algorithm maintains persistent state across retiles.
virtual bool supportsSplitRatio() const
Check if algorithm supports split ratio adjustment.
TilingAlgorithm(const TilingAlgorithm &)=delete
virtual void onWindowRemoved(TilingState *state, int windowIndex)
Called when a window is removed from the tiling before retile.
virtual void onWindowAdded(TilingState *state, int windowIndex)
Called when a window is added to the tiling before retile.
virtual void prepareTilingState(TilingState *state) const
Prepare the TilingState before calculateZones() is called.
virtual int minimumWindows() const
Get minimum number of windows for meaningful tiling.
TilingAlgorithm(QObject *parent=nullptr)
static QRect innerRect(const QRect &screenGeometry, int outerGap)
Compute the usable area after subtracting uniform outer gap from screen edges.
std::function< QString(const QString &)> m_appIdResolver
Definition TilingAlgorithm.h:491
virtual bool centerLayout() const
Whether this algorithm uses a center layout.
~TilingAlgorithm() override=default
virtual QVector< QRect > calculateZones(const TilingParams ¶ms) const =0
Calculate zone geometries for N windows.
virtual bool supportsLifecycleHooks() const noexcept
Whether this algorithm implements any lifecycle hooks.
TilingAlgorithm & operator=(const TilingAlgorithm &)=delete
virtual void onWindowResized(TilingState *state, const ResizeEvent &resize)
Called when a tiled window finished an interactive resize.
virtual bool isScripted() const noexcept
Whether this algorithm is a user-provided scripted algorithm.
virtual qreal defaultSplitRatio() const
Get default split ratio for this algorithm.
QString registryId() const
The id this algorithm is registered under.
Definition TilingAlgorithm.h:115
virtual bool isUserScript() const noexcept
Whether this scripted algorithm was loaded from a user directory.
virtual QString overlapStacking() const noexcept
Stacking direction for overlap layouts.
virtual bool supportsSingleWindow() const noexcept
Whether this algorithm lays out the single-window case itself.
void setRegistryId(const QString &id)
Registry-internal setter.
Definition TilingAlgorithm.h:121
void configurationChanged()
Emitted when algorithm parameters change.
virtual bool hasCustomParam(const QString &name) const
Check if a named custom parameter is declared by this algorithm.
virtual QString description() const =0
Description of the algorithm behavior.
virtual bool supportsResizeHook() const noexcept
Whether this algorithm reacts to interactive window resizes.
QString m_registryId
Definition TilingAlgorithm.h:496
virtual QVariantList customParamDefList() const
Get custom parameter definitions as a QVariantList for QML.
virtual QString zoneNumberDisplay() const noexcept
How zone numbers should be displayed in previews.
virtual int defaultMaxWindows() const
Get default maximum number of windows for this algorithm.
virtual int masterZoneIndex() const
Get the index of the "master" zone (if applicable).
virtual bool supportsMinSizes() const noexcept
Whether this algorithm supports per-window minimum size constraints.
virtual bool supportsCustomParams() const noexcept
Whether this algorithm declares custom parameters.
virtual bool retilesOnFocusChange() const noexcept
Whether the layout must be recomputed when focus moves.
virtual bool producesOverlappingZones() const
Whether this algorithm intentionally produces overlapping zones.
virtual bool supportsMasterCount() const
Check if algorithm supports variable master count.
virtual QString name() const =0
Human-readable name of the algorithm.
std::function< QString(const QString &)> appIdResolver() const
Access the current resolver.
Definition TilingAlgorithm.h:96
virtual bool supportsScriptState() const noexcept
Whether this algorithm persists an opaque per-screen script-state bag (TilingState::scriptState) acro...
Tracks tiling state for a single screen.
Definition TilingState.h:40
Definition AutotileEngine.h:52
::PhosphorLayout::EdgeGaps EdgeGaps
Definition TilingParams.h:25
Describes an interactive resize that triggered a retile.
Definition TilingParams.h:51
Parameters for zone calculation.
Definition TilingParams.h:84