Todd M. Lewis                                   Todd_Lewis@unc.edu
2601 Piedmont Drive                                 (919) 776-7386
Sanford, NC 27330-9437
USA

The "card package" contains C source code for incorporating playing
card images into Intuition programs.  Three complete sets of card
images are provided.  One set has horizontal cards, the others have
vertical cards.  Though some are small (they were designed so that
52 cards could be shown at the same time on a Workbench screen),
attention to detail has not been spared.  All the face cards are
unique.  The Jack of Spades, the Jack of Hearts, and the King of
Diamonds are all "one-eyed" like they are supposed to be.  A joker
image is included, as well as the images of the back of a card, a
blank card, and black card image.

The programming interface is straight-forward.  No initialization
is necessary (except for opening the intuition.library and the
graphics.library).  A blind type is defined (CardID_t) for
representing cards.  Four suits are defined for "normal" cards
(SUIT_SPADES, SUIT_HEARTS, SUIT_CLUBS, and SUIT_DIAMONDS) plus an
additional suit for the special images (SUIT_SPECIAL).  Functions
are provided for translating a (suit,rank) pair to a CardID
(CardID()) and back (CardSuit() and CardRank()).  These functions
provide error checking for invalid CardIDs and impossible
(suit,rank) combinations.  Functions are provided to initialize
(CardRange()) and shuffle (Shuffle()) an array of CardIDs.  Cards
are displayed by calling ShowVCard(), ShowVBigCard(), or ShowHCard().
Defined constants give the width and height of both the horizontal
and vertical card images.

 PERMSSN    UID  GID    PACKED    SIZE  RATIO     CRC       STAMP          NAME
---------- ----------- ------- ------- ------ ---------- ------------ -------------
[generic]                  256     420  61.0% -lh5- 5fb4 Nov 18  1994 CardPkg.info
[generic]                 7121   14460  49.2% -lh5- 57f2 Nov 18  1994 CardPkg/CardHBrush
[generic]                 9515   86798  11.0% -lh5- 2ab2 Nov 20  1994 CardPkg/CardHBrush.c
[generic]                  126     172  73.3% -lh5- bc51 Nov 20  1994 CardPkg/CardHBrush.info
[generic]                 1777    4674  38.0% -lh5- dfa0 Nov 18  1994 CardPkg/CardHImages.c
[generic]                  673    1533  43.9% -lh5- 79d4 Nov 18  1994 CardPkg/CardHImages.h
[generic]                  802    2682  29.9% -lh5- 4ec0 Nov 18  1994 CardPkg/Cards.c
[generic]                 4444   15059  29.5% -lh5- 2e89 Nov 20  1994 CardPkg/Cards.doc
[generic]                  223     468  47.6% -lh5- 438c Nov 20  1994 CardPkg/Cards.doc.info
[generic]                  493    1441  34.2% -lh5- 9e54 Nov 20  1994 CardPkg/Cards.h
[generic]                15128   40210  37.6% -lh5- 656a Nov 20  1994 CardPkg/CardVBigBrush
[generic]                23137  231080  10.0% -lh5- 66f6 Nov 20  1994 CardPkg/CardVBigBrush.c
[generic]                  130     172  75.6% -lh5- ae43 Nov 20  1994 CardPkg/CardVBigBrush.info
[generic]                 1796    4747  37.8% -lh5- b72e Nov 19  1994 CardPkg/CardVBigImages.c
[generic]                  696    1592  43.7% -lh5- 60a2 Nov 19  1994 CardPkg/CardVBigImages.h
[generic]                 9505   17498  54.3% -lh5- e279 Nov 18  1994 CardPkg/CardVBrush
[generic]                12052   88736  13.6% -lh5- 7b35 Nov 20  1994 CardPkg/CardVBrush.c
[generic]                  123     172  71.5% -lh5- 7749 Nov 20  1994 CardPkg/CardVBrush.info
[generic]                 1700    4199  40.5% -lh5- b76c Nov 18  1994 CardPkg/CardVImages.c
[generic]                  662    1519  43.6% -lh5- 05a8 Nov 18  1994 CardPkg/CardVImages.h
[generic]                 9377   28736  32.6% -lh5- c17d Nov 20  1994 CardPkg/Hello_H
[generic]                 1652    4592  36.0% -lh5- 03f9 Nov 18  1994 CardPkg/Hello_H.c
[generic]                  436     618  70.6% -lh5- efb8 Nov 20  1994 CardPkg/Hello_H.info
[generic]                11213   29252  38.3% -lh5- 8c85 Nov 20  1994 CardPkg/Hello_V
[generic]                 1647    4556  36.2% -lh5- 0f11 Nov 18  1994 CardPkg/Hello_V.c
[generic]                  688     898  76.6% -lh5- 36fc Nov 20  1994 CardPkg/Hello_V.info
[generic]                16844   69376  24.3% -lh5- ca30 Nov 20  1994 CardPkg/Hello_VBig
[generic]                 1868    5154  36.2% -lh5- 12a9 Nov 20  1994 CardPkg/Hello_VBig.c
[generic]                  646    1298  49.8% -lh5- 8e2e Nov 20  1994 CardPkg/Hello_VBig.info
[generic]                  220     456  48.2% -lh5- d9f3 Nov 18  1994 CardPkg/includes.c
[generic]                  875    2718  32.2% -lh5- 4b6e Nov 20  1994 CardPkg/makefile
[generic]                  573    2041  28.1% -lh5- 1fcb Nov 20  1994 CardPkg/SMakefile
[generic]                 2536    4580  55.4% -lh5- bb61 Nov 20  1994 CardPkg/trimline
[generic]                  362     769  47.1% -lh5- d382 Nov 18  1994 CardPkg/trimline.c
---------- ----------- ------- ------- ------ ---------- ------------ -------------
 Total        34 files  139296  672676  20.7%            Nov 29  1994