#ifndef PLAYER_H
#define PLAYER_H
/*
   This file is part of the KDE games lskat program
   Copyright (c) 2006 Martin Heni <kde@heni-online.de>

   This library is free software; you can redistribute it and/or
   modify it under the terms of the GNU Library General Public
   License as published by the Free Software Foundation; either
   version 2 of the License, or (at your option) any later version.

   This library is distributed in the hope that it will be useful,
   but WITHOUT ANY WARRANTY; without even the implied warranty of
   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
   Library General Public License for more details.

   You should have received a copy of the GNU Library General Public License
   along with this library; see the file COPYING.LIB.  If not, write to
   the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
   Boston, MA 02110-1301, USA.
*/

// Qt includes
#include <QObject>
#include <QVector>

// KDE includes
#include <kdebug.h>
#include <kconfig.h>

// Local includes
#include "deck.h"

// Forward declaration
class AbstractInput;

using namespace CardDeck;


/** A player of the game.
 */
class Player : public QObject
{
  Q_OBJECT

  public:
    /** Constructor for the player
     *  @param id     The player number
     *  @param parent The parent object
     */
    explicit Player(int id, QObject* parent=0);

    /** Destructor 
     */
     virtual ~Player();

     /** Retrive the player numner.
       * @return The id.
       */
     int id() {return mId;}

    /** Retrive card value at given logical position
     *  @param playerNumber (0..max number of cards of player)
     *  @return Card number
     */
    int getCard(int playerNumber);

    /** Remove a card from the given position. Typically if the
     *  card was played.
     *  @param cardPosition (0..max number of cards of player)
     */
    void deleteCard(int cardPosition);

    /** Add a card to the given position. Typically if the
     *  card was played back.
     *  @param cardPosition (0..max number of cards of player)
     *  @param card The actual card
     */
    void addCard(int cardPosition, int card);

    /** Set this player to start a turn 
    */
    void startTurn();

    /** Set this player to stop a turn 
    */
    void stopTurn();
    
    /** Deal a number of cards to this player 
     *  @param amount The amount of cards
     */
    void deal(int amount); 

    /** Increases the number of moves one for this player.
     *  @param amount Increase by this amount (default 1)
     */
    void increaseMovesWon(int amount = 1);

    /** Retrive the number of won moves for this player.
     * @return The amount of won moves for this player.
     */
    int noOfMovesWon();
    
    /** Adds a card which is one in a move to this player.
     *  Also  increase this players point by the points
     *  of the card. Note, this method has to be called with both
     *  cards of a move!
     * @param card The card to store
     */
    void addWonCard(int card);

    /** Retrieve a card won by this player.
     *  @param no The number of the card. Can be 0..2*noOfMovesWon().
     *  @return The card.
     */
    int getWonCard(int no);

    /** Retrive the amount of points this player has.
     *  @return The amount of points (0-120).
     */
    int points();

    /** Set the points of the player.
     *  Emits the signal signalUpdatePoints(int)
     *  @param points The points.
     */
    void setPoints(int points);
    
    /** Retrive the name of the player.
     *  @return The player's name.
     */
    QString name();

    /** Set the name of the player.
     *  Emits the signal signalUpdateName(int)
     *  @param name The new name.
     */
    void setName(const QString &name);

    /** Add a number of won games to the overall 
      * player statistic.
      * @param amount The amount of won games
      */
    void addWonGame(int amount);

    /** Retrieve the number of won games.
      * @return The number of games won.
      */
    int wonGames();

    /** Add a number of games to the overall 
      * player statistic.
      * @param amount The amount of games
      */
    void addGame(int amount);

    /** Retrieve the number of games.
      * @return The overall number of games.
      */
    int games();

    /** Add a score to the overall 
     *  player statistic.
     *  @param amount The score amount
     */
    void addScore(int amount);

    /** Retrieve the overall score.
      * @return The score.
      */
    int score();

    /** Retrieve the input device of the player 
     *  @return The input device.
     */
    AbstractInput* input();

    /** Set the input for this player.
     *  @param input The input device.
     */
     void setInput(AbstractInput* input);

     /** Set the deck for drawing cards.
      *  @param deck The deck
      */
     void setDeck(Deck* deck); 

     /** Refresh GUI by emitting a signal.
     */
     void refresh();

     /** Clear the all time statistics of this player.
      */
     void clear(); 

     /** Set the trump to the player 
      *  @param trump The trump suite
      */
     void setTrump(Suite trump); 

     /** Retrieve the trump.
       * @return The trump suite.
       */
     Suite trump();

     /** Saves the properties 
      * @param config The config group object.
      */
     void save(KConfigGroup& config);

     /** Read properties.
      * @param config The config group object.
      */
     void load(KConfigGroup& config);

  signals:
    /** Notify change of player data.
     *  @param p This player
     */
    void signalUpdate(Player* p);

  private:
    // Players input device 
    AbstractInput* mInput;
    // Card deck 
    Deck* mDeck;
    // Our cards 
    QVector<int> mCards;
    // Our won cards 
    QList<int>   mWonCards;
    // Our points 
    int mPoints;
    // Our id 
    int mId;
    // Number of moves won in the current game 
    int mMovesWon;
    // The current trump 
    Suite mTrump;

    // These attributes need to be saved
    // Our name
    QString mName;
    // Overall games won for this player 
    int mGamesWon;
    // Overall score for this player 
    int mScore;
    // Overall number of games for this player 
    int mNumberOfGames;
};

#endif
