select_zone.h

Go to the documentation of this file.

 
#ifndef SELECTZONE_H
#define SELECTZONE_H
 
#include "card_zone.h"
 
#include <QSet>
#include <optional>
 
class QGraphicsRectItem;

class SelectZone : public CardZone
{
    Q_OBJECT
public:
    static SelectZone *findOwningSelectZone(const QGraphicsItem *card);
 
    SelectZone(CardZoneLogic *logic, QGraphicsItem *parent = nullptr);
    ~SelectZone() override;
    void onCardAdded(CardItem *addedCard) override;

    void escapeClipForHover(QGraphicsItem *card);
    void restoreClipAfterHover(QGraphicsItem *card);
 
private:
    QPointF selectionOrigin;
    QSet<CardItem *> cardsInSelectionRect;
    QGraphicsRectItem *cardClipContainer = nullptr;
 
protected:
    // -- Layout computation --

    struct StackLayoutParams
    {
        int cardCount;         
        qreal totalHeight;     
        qreal cardHeight;      
        qreal desiredOffset;   
        qreal minOffset = 0.0; 
        bool allowBottomOverflow = false;
    };

    struct ZoneLayout
    {
        qreal effectiveOffset; 
        qreal start;           
    };

    static constexpr qreal MIN_CARD_VISIBLE = 10.0;

    static ZoneLayout computeZoneLayout(const StackLayoutParams &params);

    StackLayoutParams buildStackParams(qreal minOffset = 0.0) const;

    int calcDropIndexFromY(qreal dropY, qreal minOffset = 0.0) const;

    void layoutCardsVertically(const StackLayoutParams &params);
 
    // -- Clip container --
    // The clip container mechanism is available for future zones that need visual clipping
    // (e.g., zones too short to fit a full card). To enable: call setupClipContainer() in the
    // zone's constructor, and set allowBottomOverflow=true in layout params.

    void restoreStaleEscapedCards();

    void setupClipContainer(std::optional<qreal> zValue = std::nullopt);

    void updateClipRect();
 
    void mouseMoveEvent(QGraphicsSceneMouseEvent *event) override;
    void mousePressEvent(QGraphicsSceneMouseEvent *event) override;
    void mouseReleaseEvent(QGraphicsSceneMouseEvent *event) override;
};
 
#endif