Source/Card.h
author Jens Alfke <jens@mooseyard.com>
Mon Jul 21 17:32:21 2008 -0700 (2008-07-21)
changeset 21 2eb229411d73
parent 1 3eb7be1dd7b6
permissions -rw-r--r--
* Added API to Stack for removing bits.
* GoGame correctly saves/restores number of captured pieces.
* Improved positioning of captured-piece Stacks in GoGame.
* New Go piece icons.
* Added "Warn" function to GGBUtils.
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
jens@0
    25
jens@0
    26
/* A card of some type (playing card, Community Chest, money, ...)
jens@0
    27
   Has an identifying serial number (could be in the range 1..52 for playing cards).
jens@0
    28
   Can be face-up or down. */
jens@0
    29
@interface Card : Bit 
jens@0
    30
{
jens@0
    31
    @private
jens@0
    32
    int _serialNumber;
jens@1
    33
    GGBLayer *_front, *_back;
jens@0
    34
    BOOL _faceUp;
jens@0
    35
}
jens@0
    36
jens@0
    37
/** The range of serialNumbers used for this type of card. Used when instantiating Decks.
jens@0
    38
    Abstract; must be overridden. */
jens@0
    39
+ (NSRange) serialNumberRange;
jens@0
    40
jens@4
    41
+ (CGSize) cardSize;
jens@4
    42
+ (void) setCardSize: (CGSize)size;
jens@4
    43
jens@0
    44
- (id) initWithSerialNumber: (int)serial position: (CGPoint)pos;
jens@0
    45
jens@0
    46
@property (readonly) int serialNumber;
jens@0
    47
jens@0
    48
/** Cards can be face-up or face-down, of course. */
jens@0
    49
@property BOOL faceUp;
jens@0
    50
jens@0
    51
jens@0
    52
//protected -- for subclasses only:
jens@0
    53
jens@0
    54
/** Creates the sub-layer that displays the front side of the card.
jens@0
    55
    Subclasses should probably call the superclass method, configure the layer it returns
jens@0
    56
    (based on the card's serialNumber) and then return that layer. */
jens@1
    57
- (GGBLayer*) createFront;
jens@0
    58
jens@0
    59
/** Creates the sub-layer that displays the back side of the card.
jens@0
    60
    Subclasses should probably call the superclass method, configure the layer it returns and
jens@0
    61
    return that layer. */
jens@1
    62
- (GGBLayer*) createBack;
jens@0
    63
jens@0
    64
@end