File indexing completed on 2024-09-01 03:55:02

 /*
     This file is part of the KDE games lskat program
     SPDX-FileCopyrightText: 2006 Martin Heni <kde@heni-online.de>
 
     SPDX-License-Identifier: LGPL-2.0-or-later
 */
 
 #ifndef ABSTRACT_DISPLAY_H
 #define ABSTRACT_DISPLAY_H
 
 // Qt includes
 #include <QGraphicsItem>
 #include <QGraphicsScene>
 #include <QGraphicsView>
 #include <QHash>
 #include <QList>
 
 // KF includes
 #include "lskat_debug.h"
 
 // local includes
 
 // Forward declaration
 class Deck;
 class CardSprite;
 class ThemeManager;
 
 /**
  * Abstract display engine.
  */
 class AbstractDisplay : public QObject
 {
     Q_OBJECT
 
 public:
     /**
      * Constructor for the engine
      * @param deck The card deck
      * @param scene The graphics scene to work with
      * @param theme The theme manager
      * @param advancePeriod The advance period [ms]
      * @param parent The parent object
      */
     AbstractDisplay(Deck *deck, QGraphicsScene *scene, ThemeManager *theme, int advancePeriod, QGraphicsView *parent);
 
     /**
      * Destructor.
      */
     ~AbstractDisplay() override;
 
     /**
      * Set a new deck object.
      * @param deck The deck
      */
     void setDeck(Deck *deck);
 
     /**
      * Reset the display. Clear all sprites etc.
      */
     virtual void reset();
 
     /**
      * Start the display.
      */
     virtual void start() = 0;
 
     /**
      * Play a card on the display. The card is moved from its current position
      * to the card deposit.
      * @param cardNumber  The card number [0-7 ]
      * @param playerNumber  The player number [0-1]
      * @param phase Movement phase (1st part, 2nd part, etc) [optional]
      */
     virtual void play(int cardNumber, int playerNumber, int phase) = 0;
 
     /**
      * Turn a card on the display. The card is flipped backside
      * to frontside.
      * @param cardNumber The card number [0-7]
      */
     virtual void turn(int cardNumber) = 0;
 
     /**
      * Remove the given card from the display.
      * @param winnerPosition  The position of the winner (0,1)
      * @param cardNumber The number of the card
      * @param delta Card offset from target position (0,1,2,...)
      */
     virtual void remove(int winnerPosition, int cardNumber, int delta) = 0;
 
     /**
      * Retrieve the graphics scene of this display.
      * @return The QGraphicsScene of this display.
      */
     QGraphicsScene *scene() {return  mScene;}
 
 public Q_SLOTS:
     /**
      * Convert the mouse position to a card number for one of the players.
      * @param mouse        The mouse coordinates [screen coordinates]
      * @param playerNumber The resulting player number [0-1]
      * @param cardNumber   The resulting card number [0-7]
      */
     virtual void convertMousePress(const QPoint &mouse, int &playerNumber, int &cardNumber) = 0;
 
     /**
      * Load all card sprites.
      */
     virtual void createCardSprites();
 
 protected:
     /** The card deck */
     Deck *mDeck;
     /** The work canvas */
     QGraphicsScene *mScene;
     /** The graphics view */
     QGraphicsView *mView;
     /** Canvas advance period [ms]*/
     int mAdvancePeriod;
     /** Text sprite list */
     QList<QGraphicsItem *> mSprites;
     /** Store the card sprite indexed by the card value */
     static QHash<int, CardSprite *> mCards;
     /** Theme manager */
     ThemeManager *mTheme;
 };
 
 #endif