TilingParams.h

Go to the documentation of this file.

// SPDX-FileCopyrightText: 2026 fuddlesworth
// SPDX-License-Identifier: LGPL-2.1-or-later
 
#pragma once
 
#include <phosphortiles_export.h>
 
// EdgeGaps is the per-side gap shape shared between manual layout and tiling;
// it lives in libs/phosphor-layout-api so neither side has to depend on the
// other's headers.
#include <PhosphorLayoutApi/EdgeGaps.h>
 
#include <QRect>
#include <QSize>
#include <QString>
#include <QVariantMap>
#include <QVector>
 
#include <functional>
 
namespace PhosphorTiles {
 
// Shorthand for the shared shape — re-declared here (rather than relying on a
// transitive include of core/constants.h) so this header is self-contained.
using EdgeGaps = ::PhosphorLayout::EdgeGaps;
 
class TilingState;
 
struct WindowInfo
{
    QString appId; 
    bool focused = false; 
    QString windowId; 
};
 
struct ResizeEvent
{
    int index = -1; 
    QRect oldRect; 
    QRect newRect; 
    // At most one edge per axis is ever set: left XOR right, top XOR bottom.
    // Both edges of an axis moving together is a translation (move), not a
    // resize, and reports neither. Hooks may rely on this mutual exclusion.
    bool left = false; 
    bool right = false; 
    bool top = false; 
    bool bottom = false; 
};
 
struct TilingScreenInfo
{
    QString id; 
    bool portrait = false; 
    qreal aspectRatio = 0.0; 
};
 
struct TilingParams
{
    int windowCount = 0; 
    QRect screenGeometry; 
    const TilingState* state = nullptr;
    int innerGap = 0; 
    EdgeGaps outerGaps; 
    QVector<QSize> minSizes = {}; 
 
    // ── Enriched context (v2) ──────────────────────────────────────────
    QVector<WindowInfo> windowInfos; 
    int focusedIndex = -1; 
    TilingScreenInfo screenInfo; 
    QVariantMap customParams; 
 
    QVector<QRect> currentGeometries;
 
    static TilingParams forPreview(int count, const QRect& rect, const TilingState* state)
    {
        TilingParams p;
        p.windowCount = count;
        p.screenGeometry = rect;
        p.state = state;
        return p;
    }
};
 
PHOSPHORTILES_EXPORT QVector<WindowInfo> buildWindowInfos(const TilingState* state, int windowCount,
                                                          const std::function<QString(const QString&)>& appIdResolver,
                                                          int& focusedIndex);
 
} // namespace PhosphorTiles