summaryrefslogtreecommitdiffstats
path: root/kpoker/player.h
diff options
context:
space:
mode:
authortoma <toma@283d02a7-25f6-0310-bc7c-ecb5cbfe19da>2009-11-25 17:56:58 +0000
committertoma <toma@283d02a7-25f6-0310-bc7c-ecb5cbfe19da>2009-11-25 17:56:58 +0000
commitc90c389a8a8d9d8661e9772ec4144c5cf2039f23 (patch)
tree6d8391395bce9eaea4ad78958617edb20c6a7573 /kpoker/player.h
downloadtdegames-c90c389a8a8d9d8661e9772ec4144c5cf2039f23.tar.gz
tdegames-c90c389a8a8d9d8661e9772ec4144c5cf2039f23.zip
Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features.
BUG:215923 git-svn-id: svn://anonsvn.kde.org/home/kde/branches/trinity/kdegames@1054174 283d02a7-25f6-0310-bc7c-ecb5cbfe19da
Diffstat (limited to 'kpoker/player.h')
-rw-r--r--kpoker/player.h220
1 files changed, 220 insertions, 0 deletions
diff --git a/kpoker/player.h b/kpoker/player.h
new file mode 100644
index 00000000..7d3988cf
--- /dev/null
+++ b/kpoker/player.h
@@ -0,0 +1,220 @@
+/*
+ * 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 should have received a copy of the GNU General Public License
+ * along with this program; if not, write to the Free Software
+ * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
+ */
+
+
+#ifndef PLAYER_H
+#define PLAYER_H
+
+// QT includes
+#include <qstring.h>
+
+// KDE includes
+#include <krandomsequence.h>
+#include <kdebug.h>
+
+// own includes
+#include "poker.h"
+
+
+// ================================================================
+// Player classes
+
+
+class PokerPlayer
+{
+ public:
+ PokerPlayer();
+ ~PokerPlayer();
+
+ /**
+ * Calculates the money which the computer will bet
+ *
+ * use @ref changeBet() for human players
+ * @param bet The minimum bet that the player has to bet. probably the same as the bet the human player has bet before
+ * @param mayRaise Specifies if the player may raise
+ * @return The player's bet
+ **/
+ int bet(int bet, bool mayRaise = true);
+
+ /**
+ * Same as @ref bet() but should bet a little bit more if the cards are good enough (they were already exchanged)
+ **/
+ int raise(int raise);
+
+ /**
+ * This method changes the player's bet by betChange
+ * @param Specifies the change
+ * @return true if successful, false if not
+ **/
+ bool changeBet(int betChange);
+
+ /**
+ * Only used by computer players
+ *
+ * Calculates which cards shall be exchanged
+ * @param skip[] Will be set true if the card shall be exchanged (if the 1st card shall be exchanged so skip[0] will be true)
+ **/
+ void exchangeCards(bool skip[]);
+
+ /**
+ * This method will return all cards to the pile which means that all cards will be set to 0 (=deck)
+ **/
+ void giveCardsBack();
+
+ /**
+ * Returns a card to the pile
+ * @param cardNr specifies the card which will be returned to the pile
+ **/
+ void giveCardBack(int cardNr);
+
+ /**
+ * Begins a new round
+ **/
+ void newRound();
+
+ /**
+ * Sets the player's cash to newCash
+ * @param newCash The new cash
+ **/
+ void setCash(int newCash) { m_money = newCash; }
+
+ /**
+ * This makes the player human
+ **/
+ void setHuman() { m_isHuman = true; }
+
+ /**
+ * Sets a new name
+ * @param newName The new name of the player
+ **/
+ void setName(const QString &newName) { m_name = newName; }
+
+ /**
+ * Informs the player that he is out (or is not out anymore)
+ * @param newOut true if player is out or false if player is back to the game
+ **/
+ void setOut(bool newOut) { isOut = newOut; }
+
+ /**
+ * Takes a card
+ * @param nr The number of the card (0 = first card)
+ * @param value The card itself
+ **/
+ void takeCard(int nr, int value) {
+#if 0
+ const char *suitnames[] = {"C_", "D_", "S_", "H_"};
+ if (value > 0)
+ kdDebug() << "Got card " << suitnames[(value - 1) % 4]
+ << (value - 1) / 4 + 2 << endl;
+#endif
+ m_hand.setCard(nr, (CardValue) value);
+ }
+
+ /**
+ * Informs the player about new rules
+ * @param min The minimum possible bet
+ * @param max The maximum possible bet
+ **/
+ void setBetDefaults(int min, int max) { minBet = min; maxBet = max; }
+
+ /**
+ * @param cardNr The number of the card (0 = first card)
+ * @return The card
+ **/
+ CardValue getCard(int cardNr) const { return m_hand.getCard(cardNr);}
+
+ PokerHand &getHand() { return m_hand; }
+
+ /**
+ * @return The money of the player
+ **/
+ int getCash() const { return m_money; }
+
+ /**
+ * @return How much the player has bet
+ **/
+ int getCurrentBet() const { return currentBet; }
+
+ /**
+ * Returns the found card at nr
+ *
+ * The found cards specify the best cards the player has, e.g. if the player has one pair both cards will be found here
+ * @param nr The number of the wanted foundCard
+ * @return The found card number nr
+ **/
+ bool getFoundCard(int nr) const { return m_hand.getFoundCard(nr); }
+
+ /**
+ * @return If the player is human or not
+ **/
+ bool getHuman() const { return m_isHuman; }
+
+ /**
+ * @return The name of the player
+ **/
+ QString getName() const { return m_name; }
+
+ // FIXME: Rename to hasFolded?
+ /**
+ * @return True if the player is out or false if not
+ **/
+ bool out() { return isOut; }
+
+
+ /**
+ * This test the cards of the player; searches for the result
+ *
+ * Used by @ref sortedResult() and in one player games
+ * @return The result (10 = the best, 0 = nothing)
+ **/
+ PokerHandType testHand() { return m_hand.analyze(); }
+
+
+ protected:
+
+ /**
+ * This sorts the result generated by @ref testHand() a little bit to be used in games with more than one player
+ * @return The points of the hand (a royal flush is e.g. 0, a best card is 500 + the best card)
+ **/
+ int sortedResult();
+
+
+ private:
+ // Basic data:
+ QString m_name; // The name of the player.
+ bool m_isHuman; // True if the player is human.
+
+ // The hand itself
+ PokerHand m_hand;
+
+ // The financial situation
+ int m_money;
+ int currentBet;
+
+ // True if we are out of the game (have folded).
+ bool isOut;
+
+ // Properties of the game.
+ // FIXME: Move this to the game itself.
+ // FIXME: Add a pointer to the poker game object.
+ int minBet;
+ int maxBet;
+
+ // Extra stuff
+ KRandomSequence random;
+};
+
+#endif