home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
100 Great Games for Palm OS 1
/
100PalmV1.iso
/
Cards
/
pocketjack
/
readme.txt
< prev
Wrap
Text File
|
2000-07-09
|
6KB
|
133 lines
PocketJack DocumentationPocketJack 1.2
User Manual 7Mar99
Abstract:
PalmPilot version of the standard Black Jack card game. You play against the
PalmPilot dealer.
Program requires CASL runtime module, included in this distribution.
System Requirements:
PalmPilot with OS1x, OS2x, or OS3x (OS1 not tested). Program requires CASL
runtime 2.5x, included in this distribution. Memory requirements:
CASL runtime already installedCASL runtime not already installed
14 kB+ 42 kB (= 56 kB)
To Install:
From desktop system, extract all files from pj12.zip to a folder (directory) of
your choosing. Use standard Pilot install command and specify file: pj12.prc. If
not already installed, separately specify CASL runtime. If you have PalmPilot V,
IIIx, III, Personal or Professional, specify file CASLrt_Pro.prc. If you have
PalmPilot 1000 or 5000, specify file CASLrt_5K.prc.
If you have an older version of PocketJack already installed, you can install
this newer version without having to delete the older version.
During next HotSync, program will show on your applications screen.
To Users with CASL runtime already Installed:
Determine the version of your present runtime by going to the applications
screen, and tapping the CASLrt icon. The version provided is 2.6.2.
If you have an older version, you'll need to install the supplied version. This
runtime will run all your present CASL 2x programs. If you have CASLrt version
1x, and any CASL 1x programs, the authors may have recompiled CASL 2x versions.
You can NOT have both CASLrt 1x and 2x installed on your PalmPilot.
If you have a newer version, do NOT install the supplied CASL runtime onto your
PalmPilot. If you copy an older version over, you'll lose the newer features
and/or bug fixes on which your newer CASL programs may rely. PocketJack should
run on newer runtimes.
The CASL runtime undergoes periodic updates, and no attempt is made to keep the
supplied CASL runtime up to date. For the latest version of the CASL runtime,
you can download from http://www.caslsoft.com/download/CASLrt.zip.
Object:
Get closer to 21 than Pilot without going over.
Rules:
Cards are worth their face value, except J, Q, K are worth 10, and A is worth 11
or 1. 21 in 2 cards wins double. 5 cards not over 21 wins double. 6 cards not
over 21 wins triple. Pilot hits on 16 or less.
To Play:
1) select Bet, 2) tap Hit or Stay, 3) repeat.
The Details:
To start, tap the PocketJack icon from the applications screen, as with any
other PalmPilot application. Program acts as state machine. States requiring
user interaction are shown below.
(Note - If images below are not visible and you've installed this html file on
your local drive, make sure you've installed the gif files in same folder.)
Bet 1/2/5/10/20
Opening screen is the "bet" mode. Shown is play table area (empty at start
up, last game's hands afterwords), and bet selector. Tap the bet you wish
to make.
Play, Hit
Once your bet is entered the screen transforms into the "play" mode. Two
hands are dealt in the play table, and shown are the "Hit" and "Stay"
buttons. Tap the Hit button to receive another card.
Play, Stay
Tap the Stay button for the PalmPilot to play its hand.
Bet 1/2/5/10/20
Pilot hits on 16 or less.
At game end the winner is shown and the "Wins" total is updated using the
bet. The screen is again in the "bet" mode.
To quit, tap the silk screened "Applications" button, as with any other
PalmPilot application.
Play Options:
Tapping the silk screened "Menu" button will show the top menu options: Options,
Help.
Options
Fast
Normal
Slow
Silent/Sound
Tie=-1/Tie=0
Tapping Options will show 3 speed options, a sound toggle, and what to do in a
tie toggle.
The current speed is indicated by a bullet point preceding the Fast, Normal
(default), Slow options. Tapping a speed option will change the bullet point and
speed setting.
The current sound mode is the OPPOSITE as that shown. Tapping the sound option
shown will toggle the state to that shown. The possible states are Sound
(default) and Silent. For example, if menu displays Silent, this means game is
in Sound state, and tapping menu will change state to Silent.
The tie mode works the same as sound. The possible states are Tie=0 (default)
and Tie=-1. In Tie=0 mode no one wins ties. In Tie=-1 mode the PalmPilot wins
ties.
Help
Help...
About...
Tapping Help will show Help and About options. Tapping either shows message box
with relevant information.
To Uninstall:
Use PalmPilot Memory application to delete program. There are no user/setting
databases. Same procedure will delete CASL runtime, (make sure no other programs
shown in runtime window).
Legal Stuff:
Copyright (C) March 1999, Frank O'Brien
PocketJack name, program, manual, and source code are copyrighted by Frank
O'Brien. Absolutely no warranty is given.
This program is freeware. The program and source code may be distributed as long
as there is no fee.
Source code may be changed and distributed. Distributed changes shall be
documented with name, type and date. Please also add a note to about box.
Distribution shall be under these same terms (no fee).
Bugs/Features:
The cards are from a single deck of 52 cards. After all are dealt, the deck is
reshuffled by exchanging 2 random cards, 100 times. It's not perfect. It's
possible a card in a hand, after a shuffle could reappear.
If there's something wrong or you see something that could be improved, let me
know, dianfrank@worldnet.att.net. If I get around to it I plan to add Split,
Double Down, and Insurance options, Number of Decks, Card Counter, Deck Meter,
high score database, and settings database.
Files In Distribution:
pj12.zip contains:
Program file
pj12.prc -- Pilot program file
CASL Runtime
CASLrt_Pro.prc -- CASL runtime prof/pers
CASLrt_5k.prc -- CASL runtime 5k/1k
Documentation
pj12doc.htm -- user manual (this file)
4 GIF files, pj_*.gif -- images in user manual, must be in same folder
Source Code
PJ12.csl -- main source code module
msgbox_fo.cpk -- help and about box code
deckofcards_fo.cpk -- deck of cards code
PJ11.cic -- icon file