Source/Card.h
author Jens Alfke <jens@mooseyard.com>
Fri Mar 07 11:43:02 2008 -0800 (2008-03-07)
changeset 0 e9f7ba4718e1
child 1 3eb7be1dd7b6
permissions -rw-r--r--
Initial check-in into Mercurial. Branched from 1.0 release of Apple's sample code. No longer requires garbage collection. Fixed some memory leaks of CG objects. Fixed a bug when advancing to the 8th row in the Checkers game.
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
/** Hardcoded dimensions of a Card */
jens@0
    27
#define kCardWidth  100
jens@0
    28
#define kCardHeight 150
jens@0
    29
jens@0
    30
jens@0
    31
/* A card of some type (playing card, Community Chest, money, ...)
jens@0
    32
   Has an identifying serial number (could be in the range 1..52 for playing cards).
jens@0
    33
   Can be face-up or down. */
jens@0
    34
@interface Card : Bit 
jens@0
    35
{
jens@0
    36
    @private
jens@0
    37
    int _serialNumber;
jens@0
    38
    CALayer *_front, *_back;
jens@0
    39
    BOOL _faceUp;
jens@0
    40
}
jens@0
    41
jens@0
    42
/** The range of serialNumbers used for this type of card. Used when instantiating Decks.
jens@0
    43
    Abstract; must be overridden. */
jens@0
    44
+ (NSRange) serialNumberRange;
jens@0
    45
jens@0
    46
- (id) initWithSerialNumber: (int)serial position: (CGPoint)pos;
jens@0
    47
jens@0
    48
@property (readonly) int serialNumber;
jens@0
    49
jens@0
    50
/** Cards can be face-up or face-down, of course. */
jens@0
    51
@property BOOL faceUp;
jens@0
    52
jens@0
    53
jens@0
    54
//protected -- for subclasses only:
jens@0
    55
jens@0
    56
/** Creates the sub-layer that displays the front side of the card.
jens@0
    57
    Subclasses should probably call the superclass method, configure the layer it returns
jens@0
    58
    (based on the card's serialNumber) and then return that layer. */
jens@0
    59
- (CALayer*) createFront;
jens@0
    60
jens@0
    61
/** Creates the sub-layer that displays the back side of the card.
jens@0
    62
    Subclasses should probably call the superclass method, configure the layer it returns and
jens@0
    63
    return that layer. */
jens@0
    64
- (CALayer*) createBack;
jens@0
    65
jens@0
    66
@end