/**********************************************************************
 *
 *   FreeDoko a Doppelkopf-Game
 *    
 *   Copyright (C) 2001-2004  by Diether Knof and Borg Enders
 *
 *   This program is free software; you can redistribute it and/or 
 *   modify it under the terms of the GNU General Public License as 
 *   published by the Free Software Foundation; either version 2 of 
 *   the License, or (at your option) any later version.
 *
 *   This program 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 General Public License for more details. 
 *   You can find this license in the file 'gpl.txt'.
 *
 *   You should have received a copy of the GNU General Public License
 *   along with this program; if not, write to the Free Software
 *   Foundation, Inc., 59 Temple Place, Suite 330, Boston, 
 *   MA  02111-1307  USA
 *
 *  Contact:
 *    Diether Knof dknof@gmx.de
 *    Borg Enders  borg@borgsoft.de
 *
 *********************************************************************/

#ifndef CLASS_PLAYER_HEADER
#define CLASS_PLAYER_HEADER

#include "../basistypes.h"

#include "../card/hand.h"
#include "../card/sorted_hand.h"
#include "../game/reservation.h"


class PlayersDb;
class GamePoints;
class Game;

/**
 **
 ** the base class for a player (human or ai)
 **
 ** @author	Borg Enders
 ** @author	Diether Knof
 **
 **/
class Player {
  friend class Party;
  friend class Game;
  public:

  enum Type {
    UNSET = 0,
    HUMAN = 0x10,
    AI = 0x100,
    AI_DUMMY = 0x101
  }; // enum Type

  public:    
  // create a player of the given type
  static Player* new_(Type const& type);
  // create a player of the given type with data from 'player'
  static Player* new_(Type const& type, Player const& player);
  // create a player with the infos from 'filename'
  static Player* new_(string const& filename);
  // create a player with the infos from 'istr'
  static Player* new_(istream& istr);

  public:
  // constructor
  Player(Type const& type);
  // copy the player
  Player(Player const&);
  // copy the player
  Player& operator=(const Player&);
  // clone the player
  virtual Player* clone() const;

  // destructor
  virtual ~Player();


  // save the player in the given file
  bool save(string const& filename) const;
  // output of the player
  virtual ostream& out(ostream& ostr) const;


  // the game of the player
  class Game const& game() const;
  // the game of the player
  class Game& game();
  // set the game
  class Game& game_set(Game& game);



  // type

  // the type
  Type const& type() const;
  // set the type
  Type const& type_set(Type const& type);


  // name

  // the name
  string const name() const;
  // set the name
  string const name_set(string const& name);
  // the value of the name (empty, if the default name is taken)
  string const& name_value() const;
  // the default name of the player type
  static string default_name(Type const& type);


  // no

  // the number of the player
  // ToDo: split for party/game (p.e. when playing with five players)
  unsigned no() const;
  unsigned no_set(unsigned const no);


  // hand

  // the hand
  Hand const& hand() const;
  // the hand
  Hand& hand();
  // the hand
  SortedHand const& sorted_hand() const;
  // the hand
  SortedHand& sorted_hand();
  // whether the player has swines
  bool swines_has() const;
  // whether the player has hyperswines
  bool hyperswines_has() const;


  // team and teaminfo

  // the team
  Team team() const;
  // the teaminfo of 'player'
  Team const& teaminfo(Player const& player) const; 
  // update the teaminfo
  // (compare with the teaminfo of the game and check the current trick
  virtual void teaminfo_update();

  // announcement (self and other)

  // the announcement the player has made (take from 'game')
  Announcement const& announcement() const;


  // the number of tricks of the player (take from 'game')
  unsigned number_of_tricks() const;
  // the number of trickpoints
  unsigned points_in_trickpile() const;

  // sort the hand
  Hand const& hand_sort();
  // mix the hand
  Hand const& hand_mix();
  // set the hand
  virtual Hand const& hand_set(Hand const& hand);

  protected: // Game
  // whether the player is re
  bool isre() const;

  // the game request an announcement
  virtual Announcement announcement_request() const;
  // a player has made an announcement
  virtual void announcement_made(Announcement const& announcement,
				 Player const& player);

  // 'player' shifts 'cardno' cards
  virtual void poverty_shift(Player const& player, unsigned const cardno);
  // the player 'player' has denied the poverty trumps
  virtual void poverty_take_denied(Player const& player);
  // all players have denied to take the cards
  virtual void poverty_take_denied_by_all();
  // the player 'player' has accepted the poverty trumps
  // and has returned 'cardno' cards with 'trumpno' trumps
  virtual void poverty_take_accepted(Player const& player,
				     unsigned const cardno,
				     unsigned const trumpno);
  // 'player' shifts cards
  virtual Hand poverty_shift();
  // returns whether 'player' accepts the poverty
  virtual bool poverty_take_accept(unsigned const cardno);
  // the player changes the cards of the poverty
  virtual Hand poverty_cards_change(Hand const& cards);
  // the poverty player gets 'cards'
  virtual void poverty_cards_get_back(Hand const& cards);

  // return a partner for a genscher
  virtual Player const* genscher_partner();
  // a player has announced a genscher
  virtual void genscher(Player const& player, Player const& partner);


  // a new game is started
  virtual void new_game(Game& game);
  // returns the reservation of the plyaer
  virtual Reservation reservation_get( bool isDuty = false );
  public:
  // returns the default reservation of the plyaer
  virtual Reservation reservation_get_default() const;
  protected:
  // get a card (but do not remove it from the hand, that makes 'game')
  virtual Card card_get();
  public:
  // the card is played by the player
  virtual void card_played(Card const& card, Player const& player);
  protected:
  // the trick is full
  virtual void trick_full(Trick const& trick);

  /// auswerten eines abgeschlossenen Spieles
  virtual void evaluate( GamePoints& g );

  private:
  // the game (NULL, if not in a game)
  Game* game_p;

  // the type
  Type type_p;
  // name of this player
  string name_p;
  // the playernumber
  unsigned no_p;

  // the hand
  Hand hand_p;
  // the sorted hand
  SortedHand sorted_hand_p;
  protected:  

  // statistics about the player
  PlayersDb* db_;


  public:
  // Team of all players known by this player
  vector<Team> teaminfo_p;
}; // class Player

// output of the player
ostream& operator<<(ostream& ostr, Player const& player);

// the name of the player type
string name(Player::Type const& type);
// output of the player type in the stream
ostream& operator<<(ostream& ostr, Player::Type const& type);

bool operator==(Player const& player1, Player const& player2);
bool operator!=(Player const& player1, Player const& player2);

#endif // #ifndef CLASS_PLAYER_HEADER
