ribbonlayoutsolver.h

Go to the documentation of this file.

#ifndef RIBBONLAYOUTSOLVER_H
#define RIBBONLAYOUTSOLVER_H
 
#include <QVector>
#include <QtGlobal>
 
namespace openswmmvis::ui {
 
enum class RibbonMode {
    Collapsed = 0,   
    Compact   = 1,   
    Full      = 2,   
};
 
struct RibbonGroupWidths {
    int  full        = 0;
    int  compact     = 0;
    int  collapsed   = 0;
    bool collapsible = true;   
 
    int widthFor(RibbonMode m) const
    {
        switch (m) {
        case RibbonMode::Full:      return full;
        case RibbonMode::Compact:   return compact;
        case RibbonMode::Collapsed: return collapsed;
        }
        return full;
    }
};
 
inline int ribbonRowWidth(const QVector<RibbonGroupWidths> &groups,
                          const QVector<RibbonMode> &modes, int spacing)
{
    int width = 0;
    for (int i = 0; i < groups.size(); ++i) {
        width += groups.at(i).widthFor(modes.at(i));
        if (i > 0)
            width += spacing;
    }
    return width;
}
 
inline QVector<RibbonMode> solveRibbonModes(int availableWidth,
                                            const QVector<RibbonGroupWidths> &groups,
                                            int spacing)
{
    QVector<RibbonMode> modes(groups.size(), RibbonMode::Full);
    if (groups.isEmpty())
        return modes;
    if (ribbonRowWidth(groups, modes, spacing) <= availableWidth)
        return modes;
    for (int i = groups.size() - 1; i >= 0; --i) {
        modes[i] = RibbonMode::Compact;
        if (ribbonRowWidth(groups, modes, spacing) <= availableWidth)
            return modes;
    }
    for (int i = groups.size() - 1; i >= 0; --i) {
        if (!groups.at(i).collapsible)
            continue;
        modes[i] = RibbonMode::Collapsed;
        if (ribbonRowWidth(groups, modes, spacing) <= availableWidth)
            return modes;
    }
    return modes;
}
 
inline QVector<RibbonMode> applyRibbonHysteresis(const QVector<RibbonMode> &previous,
                                                 int availableWidth,
                                                 const QVector<RibbonGroupWidths> &groups,
                                                 int spacing, int deadBand = 32)
{
    const QVector<RibbonMode> candidate =
        solveRibbonModes(availableWidth, groups, spacing);
    if (previous.size() != groups.size())
        return candidate;
    const QVector<RibbonMode> held =
        solveRibbonModes(availableWidth - deadBand, groups, spacing);
    QVector<RibbonMode> result = candidate;
    for (int i = 0; i < groups.size(); ++i) {
        if (candidate.at(i) > previous.at(i))   // promotion requested
            result[i] = qMax(previous.at(i), held.at(i));
    }
    return result;
}
 
}   // namespace openswmmvis::ui
 
#endif // RIBBONLAYOUTSOLVER_H