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: 
jens@0: 
jens@0: /* A card of some type (playing card, Community Chest, money, ...)
jens@0:    Has an identifying serial number (could be in the range 1..52 for playing cards).
jens@0:    Can be face-up or down. */
jens@0: @interface Card : Bit 
jens@0: {
jens@0:     @private
jens@0:     int _serialNumber;
jens@1:     GGBLayer *_front, *_back;
jens@0:     BOOL _faceUp;
jens@0: }
jens@0: 
jens@0: /** The range of serialNumbers used for this type of card. Used when instantiating Decks.
jens@0:     Abstract; must be overridden. */
jens@0: + (NSRange) serialNumberRange;
jens@0: 
jens@4: + (CGSize) cardSize;
jens@4: + (void) setCardSize: (CGSize)size;
jens@4: 
jens@0: - (id) initWithSerialNumber: (int)serial position: (CGPoint)pos;
jens@0: 
jens@0: @property (readonly) int serialNumber;
jens@0: 
jens@0: /** Cards can be face-up or face-down, of course. */
jens@0: @property BOOL faceUp;
jens@0: 
jens@0: 
jens@0: //protected -- for subclasses only:
jens@0: 
jens@0: /** Creates the sub-layer that displays the front side of the card.
jens@0:     Subclasses should probably call the superclass method, configure the layer it returns
jens@0:     (based on the card's serialNumber) and then return that layer. */
jens@1: - (GGBLayer*) createFront;
jens@0: 
jens@0: /** Creates the sub-layer that displays the back side of the card.
jens@0:     Subclasses should probably call the superclass method, configure the layer it returns and
jens@0:     return that layer. */
jens@1: - (GGBLayer*) createBack;
jens@0: 
jens@0: @end