Card Game Part Handler Description
==================================

     This part handler is being provided by IBM for two purposes:
1) For use in demos of OpenDoc and its capabilities, and
2) As sample source code demonstrating various programming techniques involved
in developing OpenDoc part handlers.

This part handler implements a basic card
game, which supports BlackJack, 5 Card Stud Poker, 7 Card Stud Poker, and 5 Card Draw
Poker.  Your opponent is the computer, which is reasonably smart (even bluffs
at times), but clearly is no grand master.  You are initially given $500, and
the goal is to increase that amount via wise betting.  It can be used as a
stand-alone application (as its own root part), or as a component of a larger
document (when embedded within another part handler).

Prerequisites
=======================
1) This part handler runs on the OpenDoc Version 1.1 runtime.
2) The runtimes for the Bitmap part handler and the SimplePart
(iodbitmp.dll and iodsimpl.dll) are also required.
3) To be able to display the cards,
a Cards directory must exist containing .BMP files for each card,
(contained in Cards.ZIP).  The Cards directory can be specified by a CARDBITMAPDIR
environment variable (such as SET CARDBITMAPDIR=D:\Cards), or if ODSRC is defined,
it must be in %ODSRC%\src\cardgame\cards.  If neither ODSRC nor CARDBITMAPDIR is
set, the CardGame part looks for a CARDS subdirectory of the current directory.

Design Notes
=======================
From a programming standpoint, this part handler demonstrates the
following features: Containment, Frame Negotiation, Embedded Controls, Menus,
Event Handling, Persistence, and multiple frame views
(Small Icon, Large Icon, and Frame - no Thumbnail yet).

