home *** CD-ROM | disk | FTP | other *** search
/ Freelog 47 / Freelog047.iso / Palm / BlackJack / BJBlackJack301.txt < prev   
Text File  |  2000-03-28  |  14KB  |  367 lines
  1. BJ's BlackJack version 3.01 README.TXT
  2. *************************************************
  3. Author: Bradley Tinder (bradley.tinder@ti.com)  *
  4. Web: http://home.earthlink.net/~bjzers/palm.htm *
  5. *************************************************
  6. Released:03/28/2000
  7.  
  8. Intro
  9. *****
  10. Hi, and thanks for downloading BJ's BlackJack version 3.01!
  11. Wow, the last couple of months have been insane! I'm sorry
  12. this release took so long to develop, but there are a lot
  13. of requested features, with a few added ones! I hope this
  14. version does much better than the last 2. :)
  15.  
  16. Thanks to everyone who has downloaded the older versions of
  17. this game, and making it one of the more popular PalmOS apps
  18. out there!
  19.  
  20. Check out what's new below:
  21.  
  22.  
  23.  
  24. What's new?
  25. ***********
  26. 3.01  03/28/2000
  27.     Bugs fixed:
  28.     -- Fixed secret cheat bug that allowed a player to
  29.     play with a bet of $0. Thanks to Valentin Rodriguez
  30.     for the bug report.
  31.     -- Fixed Dealer Suicide Soft 17 bug. :) Thanks to
  32.     all the players who reported this one quickly!
  33.  
  34. 3.00  03/21/2000
  35.     Bugs fixed:
  36.  
  37.     -- Fixed system crash if exiting program while
  38.     Insurance dialog is displayed.
  39.     -- Fixed Fatal error when dealing more than 6 cards
  40.     for dealer and player.
  41.     -- Improved the way the Dealer's name was being handled. Poor
  42.     programming by me caused garbage to appear for the Dealer's name,
  43.     this has been (hopefully) fixed.
  44.     -- Doh! Game was re-shuffling the deck when you came back into
  45.     the application!    
  46.  
  47.     Core Routines:
  48.     -- New support for calculating score. Next version will improve on
  49.     the double down feature. For now you may double down on anything.
  50.     See below for reason why.
  51.     -- Minimal code support added for multiple splits and double down on splits.
  52.     Next release might have something going in this direction. I will have to do
  53.     some major re-coding of many internal routines to handle this. If anyone
  54.     has some good sample BlackJack code that I can look at for reference, it would
  55.     definately help!!
  56.     
  57.     Improvements:
  58.     -- Added preferences screen.
  59.         ** Multiple Decks, Dealer hits on Soft 17, Animation speed, Deck
  60.         Penetration, Score Display On/Off.
  61.     -- Added Sound Off/On Toggle in the Menu bar.
  62.         ** Icon is displayed to indicate sound status in bottom left corner.
  63.     -- Added extra score if you have an Ace (or Aces!) (min/max score).
  64.     -- Last player name is entered by default when starting a new
  65.     game.
  66.     -- Added a graffiti shift indicator for the New Game screen. (doesn't work right!)
  67.     -- Removed several dialog boxes, now displays most results on screen.
  68.         ** Some dialog boxes had to stay for certain events.        
  69.     -- By popular request, player can now double down on ANYTHING, except
  70.     when your hand is split. I like this rule, you as a player should know 
  71.     when to double down and when not to.
  72.     Again, several casinos probably don't allow this, but I like to leave
  73.     that decision to the player. Plus it can improve your money payout.
  74.     Next version will allow the player to decide which rules to follow, and
  75.     have improved double down support.
  76.         
  77. 2.01    12/16/1999
  78.     -- Fixed an obscure double down bug that Laura found
  79.     at the laundromat last night. DOH! She's good
  80.     at finding them.
  81.  
  82.     -- Put an additional check for money before dealing
  83.     and changing bet amounts. If player has less than $5, 
  84.     and tried to change their bet, they would get stuck in
  85.     the change bet screen. Big thanks to IWolf for the bug
  86.     report.
  87.  
  88. 2.00    12/15/1999
  89.  
  90.     Graphical changes:
  91.     ******************
  92.     Cards now have a real backing! Yeah, yeah, the drawing
  93.     sucks, but its better than that generic pattern! Probably
  94.     for the next version, I might actually try and create real
  95.     card faces too. 
  96.  
  97.     Animation for deals! This was a real pain to work out in
  98.     the code, and probably is buggy somewhat. See the Known
  99.     Bugs section below for some weird drawing issues that there
  100.     might be. Version 3.0 will allow user to define dealing speed,
  101.     its kind of fast right now.
  102.  
  103.     Dealer's name should be redrawn correctly now. Thanks to
  104.     all who sent email regarding this annoying graphical bug.
  105.     
  106.     Another graphical bug fixed, there was a report of the
  107.     dealer's face down card not being redrawn correctly when
  108.     he/she flipped it over for the user to see. This has been
  109.     fixed. 
  110.  
  111.     Moved the New Game button up into the menu bar. I did this to
  112.     implement a status line in the next version. 
  113.  
  114.     Redid the Action menu, adding the Split button and changing
  115.     the layout. 
  116.  
  117.     Core routines:
  118.     **************
  119.     Double down core routine has been improved. Player can now
  120.     only double down on a 9,10,or 11 off of your first 2 cards
  121.     dealt.
  122.  
  123.     Insurance!!! Player now can set insurance if the dealer is
  124.     showing an Ace on his/her up card off the initial deal. If
  125.     they have BlackJack, you win 2:1 on your Insurance bet, which
  126.     is half of your original bet.
  127.     Example: I bet $25. Dealer has an Ace up, and offers insurance.
  128.     I take it, so my Insurance bet is $12. Dealer ends up winning
  129.     with BlackJack, so I get $24, but lose my original bet of $25 because
  130.     the dealer had BlackJack, so I end up losing a total of $1. The program
  131.     can't handle cents yet, so $1 is not a huge loss for this. It works
  132.     out fine when you bet increments that can easily be divided by 2. :)
  133.     
  134.     Splitting is now allowed. I set some certain limits on the splitting,
  135.     basically just to add support for it, I'll enhance more in future versions.
  136.     Multiple splits are not allowed at this time. The code to handle splitting
  137.     might be buggy, so please send me any bug reports if the splitting doesn't
  138.     work right. I tested it with every possible variant of the split, and
  139.     it worked perfectly.
  140.     
  141.     Many minor core routines have been optimized for failsafe operation.
  142.  
  143.     Program has been compiled with the -O2 flag in GCC for a more optimized
  144.     .PRC file.
  145.  
  146. 1.1    11/24/1999
  147.     
  148.     More bugs fixed! Thanks to everyone for helping
  149.     me out finding these! Even the Gremlins didn't find
  150.     them. Keep those bug reports coming in if you find
  151.     any!
  152.  
  153.     NOTE: Delete your old version before installing this
  154.     one!!!!!
  155.  
  156.     Bugs fixed in this release:
  157.  
  158.     -- Fixed dealer's hidden card being displayed
  159.     when returning to the game after leaving. Thanks
  160.     to George Gibb for finding this "easter egg". :)
  161.  
  162.     -- When starting a new game, the previous player's
  163.     name wasn't being cleared. This has been fixed.
  164.  
  165.     -- Fixed major cash bug when cash got over $32K, it
  166.     would reset to -$32K! Should be ok now.
  167.  
  168.     -- Player now cannot Deal a new hand when their bet
  169.     is higher than their cash, this could lead to negative
  170.     money! Thanks to Tom Carter for finding this bug.
  171.  
  172.     -- Player's cash and bet are reset to $0 when starting
  173.     a new game.
  174.  
  175.  
  176. 1.05 11/23/1999 - Bug fix release. This release fixes 
  177. issues with drawing white space characters on PalmOS 3.3
  178. release devices. It appears 3Com replaced the numeric
  179. space character with the Euro symbol in the font set
  180. for 3.3! Not good. I redid the clear field code to fix
  181. this issue. Also cleaned up some minor graphical bugs.
  182. Thanks to all who reported this issue. I don't have the
  183. update for 3.3 yet, mostly because of all the warnings
  184. that 3Com placed on the upgrade, but I guess I should
  185. do it so I can catch issues like this. ;)
  186.  
  187. 1.00 11/19/1999 - First release.
  188.  
  189.  
  190.  
  191. Known (or possible) Bugs
  192. ************************
  193. -- The graffiti shift indicator on the New Game setup
  194. page, doesn't work correctly. Need to see some sample
  195. code on how to do this properly. Not a major bug, but
  196. kind of annoying.
  197.  
  198. -- I've done extensive testing on the multiple deck
  199. features, and everything seems to be working out, the
  200. new deck gauge might be hokey though. It seemed to
  201. work fine for the 2 hours I spent testing the game.
  202.  
  203. -- I've also tested the Dealer name bug issue. I did
  204. a Hard Reset on my Palm, and reloaded the game from backup
  205. and the Dealer name stayed perfect! I hope this works for
  206. everyone else too, but if not, send me email.
  207.  
  208.  
  209. How to play
  210. ***********
  211.  
  212. BlackJack is a simple game actually, its otherwise known
  213. as 21, and the basic concept of the game is to beat
  214. the dealer's hand without going over the total score
  215. for the hand of 21. 
  216.  
  217. Aces are worth either 1 or 11 points depending on wether
  218. the 1 or 11 helps you get close to 21. Thus the only
  219. way to achieve a "BlackJack" is to have a Face card or 10
  220. and an Ace on the draw. 
  221.  
  222. Face cards are worth 10, all other cards are worth their
  223. face value.
  224.  
  225. You may also "Double-Down" on any deal, thus, you double
  226. your bet. This situation works well when you have a total
  227. score of 11, and you double down and get a 10, thus you
  228. are a sure win to get double your money! 
  229.  
  230. Insurance is defined within the program, if the dealer has
  231. an Ace showing, tap the Information icon in the upper right
  232. hand corner of the dialog box that pops up for help with
  233. insurance. 90% of the time, insurance is a bad bet, however.
  234.  
  235. You may split pairs on the initial deal 1 time only. For example,
  236. if I have a Jack and a Queen, I could split them into 2 seperate
  237. hands. Then the dealer will deal a card for the 1st hand, and I'll
  238. play it until I stand or bust, then the dealer will deal a card for 
  239. the 2nd hand, and I play it until I stand or bust. After I'm done
  240. with my plays, the game plays out the dealer's hand, then checks
  241. both splits vs. the dealer's score. You can easily double your money
  242. using splits, but use them wisely. Splitting Aces is usually the best
  243. bet, splitting a 20 is not a good bet.
  244.  
  245.  
  246. Installation
  247. ************
  248.  
  249. 1. Unzip the .prc file into the C:\Palm\add-on directory.
  250. Change the drive letter if applicable to your setup.
  251.  
  252. 2. Load the Palm Install tool and Add the file to your
  253. sync queue.
  254.  
  255. 3. Sync your Pilot and the program will install into
  256. the Unfiled category.
  257.  
  258. If you are updating your previous version of the game,
  259. please make sure to Delete your old version before syncing
  260. the new version, as unpredictable results could happen!
  261. If you don't delete your previous version and HotSync the
  262. new version, *please* don't send me email complaining about bugs.
  263. You've been warned!
  264.  
  265. Instructions for play
  266. *********************
  267.  
  268. When you first start the program after installing on
  269. your Palm, you will be shown the About box. You will
  270. continue on to the Player Name entry dialog. Enter your
  271. name and click on what your initial cash will be.
  272. You will then be taken to the Betting screen. Go ahead
  273. and select your bet. After all that, you will be taken
  274. to the main screen, the "Table". You might want to set
  275. your preferences for game play. Tap on the Menu button
  276. or equivalent, then tap the Preferences menu item.
  277. You can get help with all of the preferences by tapping
  278. the I icon in the upper right hand corner. After setting
  279. your preferences, click OK to be taken back to the main
  280. table. Click on Change to change your bet, or Deal to deal 
  281. a new hand.
  282.  
  283. After dealing your initial 2 cards, a popup menu will appear
  284. with 4 options, Hit, Stand, Double (double down) or Split. Choose
  285. the appropiate selection based on your hand and play away.
  286.  
  287. If you run out of cash, Tap on the Menu, and the New Game menu item 
  288. to start over.
  289.  
  290. You may not double down if you don't have the cash to cover
  291. the bet, and only on the initial deal.
  292.  
  293. Dealer swaps out after 5 shuffles.
  294.  
  295. Future Features (for version 3.xx or 4.00):
  296. *******************************************
  297.  
  298. -- More graphical improvements. Real card faces rather than
  299. Palm generated faces, maybe the ability for the user to
  300. upload his/her own card face decks.
  301.  
  302. -- Surrender option.
  303.  
  304. -- Multi-Player via Infared (Palm III and higher devices only).
  305.    I might ditch this because I want to be able to support as
  306.    many Palm devices as I can, write me if you'd like to see it,
  307.    and if you have some sample source code of IR stuff.
  308.  
  309. -- High Roller Scoreboard.
  310.    
  311. -- Multple splits, multiple double downs on splits.
  312.     
  313. -- Improve the Double Down routine.
  314.  
  315.  
  316. Thanks
  317. ******
  318.  
  319. Thanks mostly to 3COM, for developing and releasing such a neat
  320. product. 
  321.  
  322. Thanks to Laura, for beta-testing my game and giving me ideas
  323. to make the game more fun.
  324.  
  325. Thanks to the FSF and GNU team for converting GCC for the
  326. Pilot, without it, I wouldn't be developing Palm software!
  327.  
  328. BIG thanks to all the folks who have sent me mail with ideas,
  329. suggestions, bug reports, or just general kudos for this game.
  330. Your support and encouragement have made me improve on this game
  331. and make it better!
  332.  
  333. Much kudos to the folks at ZDNet, palmgear.com, handango.com,
  334. and all Software archives that have help distribute this game.
  335.  
  336. Oh, and thanks to ABC News for featuring BJ's BlackJack in one
  337. of their articles! 
  338.  
  339. Special thanks to my cat, B.J., of whom the name for this game
  340. originates. You too, Freckles!
  341.  
  342. Donations?
  343. **********
  344. I've tried several shareware BlackJack games for the Palm, and
  345. some were really cool, but some really sucked. I didn't think the
  346. authors could justify charging shareware fees for a program
  347. that didn't live up to its price. I created BJ's BlackJack with
  348. the sole intention of making a free BlackJack game for all PalmOS
  349. owners, where the focus was on the game, not worrying about how
  350. many days you've had the program without registering. So, my policy
  351. is this: If you think this game is actually worth anything,
  352. drop me a line, and I'll give you an address to send a donation to.
  353. The most I will ask for is, say, $10.  
  354. Another great donation would be some web space, and the ability to
  355. have my own domain (I'll register with InterNIC if someone provides
  356. a machine).
  357.  
  358. I'll also give you beta or release candidate future versions of the game 
  359. for feedback.
  360.  
  361. Any money received will be put towards upgrading my existing compiler 
  362. and tools to improve the gameplay and also start work on Color applications!
  363.  
  364. The most important thing for you the user in playing this game is to have
  365. fun! I've had fun creating it, so I hope it brings you the same joy!
  366.  
  367. -- Bradley Tinder, 03/28/2000