Source/Stack.h
author Jens Alfke <jens@mooseyard.com>
Sun Mar 16 15:06:47 2008 -0700 (2008-03-16)
changeset 7 428a194e3e59
child 21 2eb229411d73
permissions -rw-r--r--
Game class now tracks board state and moves, as strings, and can step through its history.
Fixed another bug in Go (you could drag your captured stones back to the board!)
jens@0
     1
/*  This code is based on Apple's "GeekGameBoard" sample code, version 1.0.
jens@0
     2
    http://developer.apple.com/samplecode/GeekGameBoard/
jens@0
     3
    Copyright © 2007 Apple Inc. Copyright © 2008 Jens Alfke. All Rights Reserved.
jens@0
     4
jens@0
     5
    Redistribution and use in source and binary forms, with or without modification, are permitted
jens@0
     6
    provided that the following conditions are met:
jens@0
     7
jens@0
     8
    * Redistributions of source code must retain the above copyright notice, this list of conditions
jens@0
     9
      and the following disclaimer.
jens@0
    10
    * Redistributions in binary form must reproduce the above copyright notice, this list of
jens@0
    11
      conditions and the following disclaimer in the documentation and/or other materials provided
jens@0
    12
      with the distribution.
jens@0
    13
jens@0
    14
    THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR
jens@0
    15
    IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND 
jens@0
    16
    FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRI-
jens@0
    17
    BUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
jens@0
    18
    (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR 
jens@0
    19
    PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN 
jens@0
    20
    CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF 
jens@0
    21
    THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
jens@0
    22
*/
jens@0
    23
#import "Bit.h"
jens@0
    24
#import "BitHolder.h"
jens@0
    25
jens@0
    26
jens@0
    27
/** A holder for multiple Bits that lines them up in stacks or rows.
jens@0
    28
    For example, this is used in solitaire card games for each pile in the "tableau". */
jens@0
    29
@interface Stack : BitHolder
jens@0
    30
{
jens@0
    31
    CGPoint _startPos;                      // see properties below for descriptions
jens@0
    32
    CGSize _spacing;       
jens@0
    33
    CGSize _wrapSpacing;   
jens@0
    34
    int _wrapInterval;     
jens@0
    35
    NSMutableArray *_bits; 
jens@0
    36
    BOOL _dragAsStacks;    
jens@0
    37
}
jens@0
    38
jens@0
    39
- (id) initWithStartPos: (CGPoint)startPos spacing: (CGSize)spacing;
jens@0
    40
jens@0
    41
- (id) initWithStartPos: (CGPoint)startPos spacing: (CGSize)spacing
jens@0
    42
           wrapInterval: (int)wrapInterval wrapSpacing: (CGSize)wrapSpacing;
jens@0
    43
jens@0
    44
@property CGPoint startPos;                 // Position where first Bit should go
jens@0
    45
@property CGSize spacing;                   // Spacing between successive Bits
jens@0
    46
@property CGSize wrapSpacing;               // Spacing between wrapped-around sub-piles
jens@0
    47
@property int wrapInterval;                 // How many Bits to add before wrapping
jens@0
    48
@property BOOL dragAsStacks;                // If set to YES, dragging a Bit drags a DraggedStack
jens@0
    49
@property (readonly) NSArray *bits;         // The Bits, in order
jens@0
    50
@property (readonly) Bit *topBit;           // The topmost Bit (last item in self.bits)
jens@0
    51
jens@0
    52
/** Adds a Bit to the end */
jens@0
    53
- (void) addBit: (Bit*)bit;
jens@0
    54
jens@0
    55
@end
jens@0
    56
jens@0
    57
jens@0
    58
/** A subset of a Stack, dragged out of it if its dragAsStacks flag is set.
jens@0
    59
    This is used in typical card solitaire games.
jens@0
    60
    A DraggedStack exists only during a drag; afterwards, its Cards
jens@0
    61
    are incorporated into the destination Stack. */
jens@0
    62
@interface DraggedStack : Bit
jens@0
    63
jens@0
    64
- (id) initWithBits: (NSArray*)bits;
jens@0
    65
jens@0
    66
@property (readonly) NSArray *bits;
jens@0
    67
jens@0
    68
@end