jens@0: /*  This code is based on Apple's "GeekGameBoard" sample code, version 1.0.
jens@0:     http://developer.apple.com/samplecode/GeekGameBoard/
jens@0:     Copyright © 2007 Apple Inc. Copyright © 2008 Jens Alfke. All Rights Reserved.
jens@0: 
jens@0:     Redistribution and use in source and binary forms, with or without modification, are permitted
jens@0:     provided that the following conditions are met:
jens@0: 
jens@0:     * Redistributions of source code must retain the above copyright notice, this list of conditions
jens@0:       and the following disclaimer.
jens@0:     * Redistributions in binary form must reproduce the above copyright notice, this list of
jens@0:       conditions and the following disclaimer in the documentation and/or other materials provided
jens@0:       with the distribution.
jens@0: 
jens@0:     THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR
jens@0:     IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND 
jens@0:     FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRI-
jens@0:     BUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
jens@0:     (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR 
jens@0:     PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN 
jens@0:     CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF 
jens@0:     THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
jens@0: */
jens@0: #import "Bit.h"
jens@0: #import "BitHolder.h"
jens@0: 
jens@0: 
jens@0: /** A holder for multiple Bits that lines them up in stacks or rows.
jens@0:     For example, this is used in solitaire card games for each pile in the "tableau". */
jens@0: @interface Stack : BitHolder
jens@0: {
jens@0:     CGPoint _startPos;                      // see properties below for descriptions
jens@0:     CGSize _spacing;       
jens@0:     CGSize _wrapSpacing;   
jens@0:     int _wrapInterval;     
jens@0:     NSMutableArray *_bits; 
jens@0:     BOOL _dragAsStacks;    
jens@0: }
jens@0: 
jens@0: - (id) initWithStartPos: (CGPoint)startPos spacing: (CGSize)spacing;
jens@0: 
jens@0: - (id) initWithStartPos: (CGPoint)startPos spacing: (CGSize)spacing
jens@0:            wrapInterval: (int)wrapInterval wrapSpacing: (CGSize)wrapSpacing;
jens@0: 
jens@0: @property CGPoint startPos;                 // Position where first Bit should go
jens@0: @property CGSize spacing;                   // Spacing between successive Bits
jens@0: @property CGSize wrapSpacing;               // Spacing between wrapped-around sub-piles
jens@0: @property int wrapInterval;                 // How many Bits to add before wrapping
jens@0: @property BOOL dragAsStacks;                // If set to YES, dragging a Bit drags a DraggedStack
jens@0: @property (readonly) NSArray *bits;         // The Bits, in order
jens@0: @property (readonly) Bit *topBit;           // The topmost Bit (last item in self.bits)
jens@0: 
jens@0: /** Adds a Bit to the end */
jens@0: - (void) addBit: (Bit*)bit;
jens@0: 
jens@0: @end
jens@0: 
jens@0: 
jens@0: /** A subset of a Stack, dragged out of it if its dragAsStacks flag is set.
jens@0:     This is used in typical card solitaire games.
jens@0:     A DraggedStack exists only during a drag; afterwards, its Cards
jens@0:     are incorporated into the destination Stack. */
jens@0: @interface DraggedStack : Bit
jens@0: 
jens@0: - (id) initWithBits: (NSArray*)bits;
jens@0: 
jens@0: @property (readonly) NSArray *bits;
jens@0: 
jens@0: @end