|
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@21
|
50 |
@property NSUInteger numberOfBits; // Number of bits (can be used to remove bits, but not add)
|
|
jens@0
|
51 |
@property (readonly) Bit *topBit; // The topmost Bit (last item in self.bits)
|
|
jens@0
|
52 |
|
|
jens@0
|
53 |
/** Adds a Bit to the end */
|
|
jens@0
|
54 |
- (void) addBit: (Bit*)bit;
|
|
jens@0
|
55 |
|
|
jens@21
|
56 |
- (void) removeBit: (Bit*)bit;
|
|
jens@21
|
57 |
|
|
jens@0
|
58 |
@end
|
|
jens@0
|
59 |
|
|
jens@0
|
60 |
|
|
jens@0
|
61 |
/** A subset of a Stack, dragged out of it if its dragAsStacks flag is set.
|
|
jens@0
|
62 |
This is used in typical card solitaire games.
|
|
jens@0
|
63 |
A DraggedStack exists only during a drag; afterwards, its Cards
|
|
jens@0
|
64 |
are incorporated into the destination Stack. */
|
|
jens@0
|
65 |
@interface DraggedStack : Bit
|
|
jens@0
|
66 |
|
|
jens@0
|
67 |
- (id) initWithBits: (NSArray*)bits;
|
|
jens@0
|
68 |
|
|
jens@0
|
69 |
@property (readonly) NSArray *bits;
|
|
jens@0
|
70 |
|
|
jens@0
|
71 |
@end
|