Android Open Source - FourRowSolitaire Ace Pile






From Project

Back to project page FourRowSolitaire.

License

The source code is released under:

GNU General Public License

If you think the Android project FourRowSolitaire listed in this page is inappropriate, such as containing malicious code/tools or violating the copyright, please email info at java2s dot com, thanks.

Java Source Code

/*
 This file is a part of Four Row Solitaire
/*from w w  w  .j  a v a 2  s. co  m*/
 Copyright (C) 2010-2014 by Matt Stephen, Todor Balabanov, Konstantin Tsanov, Ventsislav Medarov, Vanya Gyaurova, Plamena Popova, Hristiana Kalcheva, Yana Genova

 Four Row Solitaire 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 3 of the License, or
 (at your option) any later version.

 Four Row Solitaire 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 FourRowSolitaire.  If not, see <http://www.gnu.org/licenses/>.
 */

package eu.veldsoft.four.row.solitaire;

import java.util.Vector;

/**
 * Class: AcePile
 * 
 * Description: The AcePile class manages one of the four foundation stacks.
 * 
 * @author Matt Stephen
 */
class AcePile extends CardStack {

  /**
   * Stack of cards.
   */
  private Vector<Card> cards = new Vector<Card>();

  /**
   * Pile suit.
   */
  private CardSuit suit;

  /**
   * Sets the pile's suit to be equal to the argument suit. Can be Spades,
   * Clubs, Hearts or Diamonds
   * 
   * @param suit
   *            Suit to be used for the ace pile.
   * 
   * @author Todor Balabanov
   */
  public AcePile(CardSuit suit) {
    this.suit = suit;
  }

  /**
   * Returns the pile's suit.
   * 
   * @return suit The pile's suit.
   * 
   * @author Todor Balabanov
   */
  public Vector<Card> getCards() {
    return cards;
  }

  /**
   * Returns the pile's suit.
   * 
   * @return suit The pile's suit.
   * 
   * @author Todor Balabanov
   */
  public CardSuit getSuit() {
    return suit;
  }

  /**
   * For starting the game.
   * 
   * Used to add a card to a stack.
   * 
   * @param card
   *            Card to be added.
   * 
   * @author Todor Balabanov
   */
  public void addCard(Card card) {
    card.setFaceUp();
    cards.add(card);
  }

  /**
   * Pops the top card out of a stack.
   * 
   * @return card The popped card.
   * 
   * @author Todor Balabanov
   */
  public synchronized Card pop() {
    Card card = peek();
    cards.remove(cards.size() - 1);

    return card;
  }

  /**
   * Pops the top card out of a stack if possible. If not - returns null.
   * 
   * @return Card or null.
   * 
   * @author Todor Balabanov
   */
  public synchronized Card peek() {
    if (cards.isEmpty()) {
      return null;
    }

    return cards.lastElement();
  }

  /**
   * Checks if a stack is empty (has no cards inside).
   * 
   * @return True or false, based on if the stack is empty or not.
   */
  public boolean isEmpty() {
    return cards.size() == 0;
  }

  /**
   * Returns the stack's length.
   * 
   * @return Stack's length.
   * 
   * @author Todor Balabanov
   */
  public int length() {
    return cards.size();
  }

  /**
   * Searches the stack for a specific card and returns its location in the
   * stack.
   * 
   * @param card
   *            The card to be matched.
   * 
   * @return The location of the card or -1 if the card can't be found within
   *         the stack.
   * 
   * @author Todor Balabanov
   */
  public synchronized int search(Card card) {
    int i = cards.lastIndexOf(card);

    if (i >= 0) {
      return cards.size() - i;
    }

    return -1;
  }

  /**
   * Returns the card located at a specified location within the stack.
   * 
   * @param index
   *            Location within the stack.
   * 
   * @return The card at this location. Or null if the index is greater than
   *         the stack's size.
   * 
   * @author Todor Balabanov
   */
  public Card getCardAtLocation(int index) {
    if (index < cards.size()) {
      return cards.get(index);
    }

    return null;
  }

  /**
   * Verifies that the card is a part of a valid stack.
   * 
   * @param index
   *            Index of the card to be verified.
   * 
   * @return true or false
   * 
   * @author Todor Balabanov
   */
  boolean isValidCard(int index) {
    if (index >= cards.size()) {
      return false;
    }

    for (int i = index; i < cards.size() - 1; i++) {
      /*
       * Cards are not opposite colors or decreasing in value correctly.
       */
      if (cards.get(i).getColor() == cards.get(i + 1).getColor()
          || cards.get(i).getRank()
              .isLessByOneThan(cards.get(i + 1).getRank()) == false) {
        return false;
      }
    }

    return true;
  }

  /**
   * Searches the stack for a specific card. Creates a new temporary stack.
   * Clones the cards from the end towards the beginning of the stack into the
   * temp stack. Stops after it reaches the specific card.
   * 
   * @param card
   *            Card to look for.
   * 
   * @return Stack of cards.
   * 
   * @author Todor Balabanov
   */
  public CardStack getStack(Card card) {
    CardStack temp = new AcePile(getSuit());
    int index = search(card);

    for (int i = 0; i < index; i++) {
      temp.push(getCardAtLocation(cards.size() - i - 1).clone());
      getCardAtLocation(cards.size() - i - 1).highlight();
    }

    return temp;
  }

  /**
   * Searches the stack for a specified location, creates a temporary stack,
   * Clones the cards from the end towards the begining of the stack, stops
   * when it reaches the specified location.
   * 
   * @param numCards
   *            Index.
   * 
   * @return Stack of cards.
   * 
   * @author Todor Balabanov
   */
  public CardStack getStack(int numCards) {
    CardStack temp = new AcePile(getSuit());
    int index = length() - numCards;

    for (int i = length(); i > index; i--) {
      temp.push(getCardAtLocation(cards.size() - i - 1).clone());
      getCardAtLocation(cards.size() - i - 1).highlight();
    }

    return temp;
  }

  /**
   * Pushes a card onto the foundation stack if possible.
   * 
   * @param card
   *            Card to be pushed to the ace pile.
   * 
   * @return card The card that was pushed into the ace pile.
   * 
   * @author Todor Balabanov
   */
  public Card push(Card card) {
    card.setFaceUp();
    if (isValidMove(card) == false) {
      return null;
    }
    super.push(card);
    return (card);
  }

  /**
   * Checks if its possible to put a certain card on top of a foundation pile.
   * 
   * @param card
   *            Card to be checked.
   * 
   * @return true or false
   * 
   * @author Todor Balabanov
   */
  @Override
  public boolean isValidMove(Card card) {
    if (card.getSuit().equals(suit) == false) {
      return false;
    }

    if (isEmpty() && card.getRank().equals(CardRank.ACE)) {
      return true;
    } else if (card.getRank().isLessByOneThan(peek().getRank())) {
      return true;
    }

    return false;
  }

  /**
   * If trying to move an entire stack of two or more cards on top of one of
   * the foundation piles returns false.
   * 
   * @param stack
   *            Stack of cards.
   * 
   * @return false Always returns false because of the order of the cards.
   * 
   * @author Todor Balabanov
   */
  public boolean isValidMove(CardStack stack) {
    return false;
  }

  /**
   * Checks if an ace pile is full.
   * 
   * @return true or false.
   * 
   * @author Todor Balabanov
   */
  public boolean isFull() {
    if (isEmpty() == true || length() != 13) {
      return (false);
    }

    for (int i = 0; i < cards.size() - 1; i++) {
      if (cards.get(i).getColor() != cards.get(i + 1).getColor()) {
        return (false);
      }

      if (cards.get(i).getRank()
          .isLessByOneThan(cards.get(i + 1).getRank()) == true) {
        return (false);
      }
    }

    return (true);
  }

  /**
   * Returns the first card from a stack.
   * 
   * @return card The first card from the stack of cards.
   * 
   * @author Todor Balabanov
   */
  public Card getBottom() {
    return cards.firstElement();
  }

  /**
   * Highlight cards according stack rules.
   * 
   * @author Todor Balabanov
   */
  void highlight(int index) {
    if (isEmpty() == false) {
      peek().highlight();
    }
  }
}




Java Source Code List

eu.veldsoft.four.row.solitaire.AboutGameActivity.java
eu.veldsoft.four.row.solitaire.AcePileLayeredPane.java
eu.veldsoft.four.row.solitaire.AcePile.java
eu.veldsoft.four.row.solitaire.AnimationSettings.java
eu.veldsoft.four.row.solitaire.BestTimesActivity.java
eu.veldsoft.four.row.solitaire.CardColor.java
eu.veldsoft.four.row.solitaire.CardComponent.java
eu.veldsoft.four.row.solitaire.CardRank.java
eu.veldsoft.four.row.solitaire.CardStackLayeredPane.java
eu.veldsoft.four.row.solitaire.CardStack.java
eu.veldsoft.four.row.solitaire.CardSuit.java
eu.veldsoft.four.row.solitaire.Card.java
eu.veldsoft.four.row.solitaire.ChangeAppearance.java
eu.veldsoft.four.row.solitaire.ChangeOptions.java
eu.veldsoft.four.row.solitaire.ColumnLayeredPane.java
eu.veldsoft.four.row.solitaire.Column.java
eu.veldsoft.four.row.solitaire.Common.java
eu.veldsoft.four.row.solitaire.DealDeckLayeredPane.java
eu.veldsoft.four.row.solitaire.DealDeck.java
eu.veldsoft.four.row.solitaire.Deck.java
eu.veldsoft.four.row.solitaire.DiscardPileLayeredPane.java
eu.veldsoft.four.row.solitaire.DiscardPile.java
eu.veldsoft.four.row.solitaire.FireworksDisplay.java
eu.veldsoft.four.row.solitaire.FourRowSolitaire.java
eu.veldsoft.four.row.solitaire.GameActivity.java
eu.veldsoft.four.row.solitaire.GameDifficulty.java
eu.veldsoft.four.row.solitaire.GameState.java
eu.veldsoft.four.row.solitaire.HelpActivity.java
eu.veldsoft.four.row.solitaire.MenuActivity.java
eu.veldsoft.four.row.solitaire.SettingsActivity.java
eu.veldsoft.four.row.solitaire.SingleCellLayeredPane.java
eu.veldsoft.four.row.solitaire.SingleCell.java
eu.veldsoft.four.row.solitaire.SolitaireBoardFrame.java
eu.veldsoft.four.row.solitaire.SolitaireBoard.java
eu.veldsoft.four.row.solitaire.SolitaireLayout.java
eu.veldsoft.four.row.solitaire.SolitairePanel.java
eu.veldsoft.four.row.solitaire.SoundsSettings.java
eu.veldsoft.four.row.solitaire.StatisticsActivity.java
eu.veldsoft.four.row.solitaire.StatisticsTab0Activity.java
eu.veldsoft.four.row.solitaire.StatisticsTab1Activity.java
eu.veldsoft.four.row.solitaire.StatisticsTab2Activity.java
eu.veldsoft.four.row.solitaire.StatisticsTab3Activity.java
eu.veldsoft.four.row.solitaire.StatisticsTab4Activity.java
eu.veldsoft.four.row.solitaire.StatisticsTab5Activity.java
eu.veldsoft.four.row.solitaire.ThroughLimit.java
eu.veldsoft.four.row.solitaire.TopTimes.java
eu.veldsoft.four.row.solitaire.WinActivity.java
eu.veldsoft.four.row.solitaire.WinScreen.java