Source/Stack.h
author Jens Alfke <jens@mooseyard.com>
Wed Jul 09 17:07:45 2008 -0700 (2008-07-09)
changeset 15 73f8c889f053
child 21 2eb229411d73
permissions -rw-r--r--
More tweaks, including a "reversed" property for Grids to show the second player's perspective without turning the pieces upside-down.
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