home *** CD-ROM | disk | FTP | other *** search
/ Sunny 1,000 Collection / SUNNY1000.iso / Files / Dos / Casino / OSMO112.ZIP / OSMOSIS.DOC < prev    next >
Text File  |  1992-01-27  |  24KB  |  595 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.                                     Osmosis
  10.  
  11.                                   Version 1.12
  12.  
  13.                               Copyright 1991-92 By
  14.                                    Randy Rasa
  15.                                   18215 Troost
  16.                                 Olathe, KS 66062
  17.  
  18.  
  19.  
  20.      What Is It?     ___________
  21.  
  22.         Osmosis, also known as "Treasure Trove", is a solitaire card game
  23.         that requires skillful play and a good portion of luck, but rewards
  24.         as an enjoyable and addictive diversion.  When played with actual
  25.         cards, it requires a lot of dealing and shuffling, but this
  26.         computer version makes the game simple and fast.
  27.  
  28.  
  29.      Program Requirements     ____________________
  30.  
  31.         Osmosis requires 256K of memory, EGA or higher graphics capability,
  32.         and a Microsoft-compatible mouse.  If you are not sure you have the
  33.         right hardware, just run the program.  If there's a problem, the
  34.         program will let you know.
  35.  
  36.         In addition to the program file (OSMOSIS.EXE), the game requires
  37.         that the card definition files (CARDS.CD1 and CARDS.CD2) be in the
  38.         current directory.  These files contain the bit-maps for each
  39.         cardface in the deck.
  40.  
  41.  
  42.      Using The Mouse     _______________
  43.  
  44.         The mouse pointer will appear as a white arrow with black edges.
  45.         In general, the left button is used to select the object being
  46.         pointed to (a card or an on-screen button).
  47.  
  48.         If you have a three-button mouse, the middle button will blank the
  49.         screen.  This can also be accomplished by pressing the left and
  50.         right buttons simultaneously.
  51.  
  52.  
  53.      How To Play     ___________
  54.  
  55.         Osmosis uses a standard 52-card deck (no jokers).  To begin the
  56.         game the deck is shuffled, then four piles of four cards each are
  57.         dealt at the left.  The piles form the reserve, and the top card of
  58.         each is available for play.
  59.  
  60.         One card is dealt to the right of the first reserve, forming the
  61.         first foundation.  As the other cards of the same rank become
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.      Osmosis Documentation                                           Page 2
  72.  
  73.  
  74.         available, they may be played in a column below the first
  75.         foundation, forming the other three foundations.
  76.  
  77.         Cards are dealt from the deck three at a time, with only the top
  78.         card available for play to the foundations.
  79.  
  80.         Foundations are built in suit, regardless of order.  On the first
  81.         foundation, any card of the same suit may built as soon as it
  82.         becomes available.  On each lower foundation, a card may be built
  83.         only if a card of the same rank has been built on the foundation
  84.         above it.
  85.  
  86.         For example, if the first foundation card is a three of hearts,
  87.         then any heart can be played on the first foundation as soon as it
  88.         becomes available, say, for illustration, the seven and nine.  Now
  89.         suppose the second foundation is  the three of clubs.  If the seven
  90.         or nine of clubs become available, they can be played on the second
  91.         foundation, but no other club can be played until the corresponding
  92.         heart has been built.
  93.  
  94.         When all cards have been dealt from the deck, you may redeal as
  95.         often as you like, until either the game is won (by moving all
  96.         cards to the foundations) or lost (no more moves can be made.
  97.  
  98.         When the "peek" option is enabled, the reserves will be spread out
  99.         so that all of their cards can be seen.  This allows you to spot
  100.         any potential blocks before beginning the game.  The situation to
  101.         look out for is two cards of the same rank in the same reserve
  102.         pile, especially is the lower card is of the first foundation suit.
  103.         If this is the case then the game is hopeless, at least as far as
  104.         winning, though you can still play it and perhaps even reach a
  105.         respectable score.
  106.  
  107.         Note: to deal cards from the deck, simply click on the card back.
  108.         When the deck is exhausted, click it again to gather the cards back
  109.         up in preparation for a redeal.
  110.  
  111.  
  112.      Buttons     _______
  113.  
  114.         Along the right side of the screen are a number of "buttons", which
  115.         may be selected by pointing and clicking with the mouse.  The
  116.         buttons are:
  117.  
  118.            Options: This button brings up the options menu, which you can
  119.               use to set your preferences for the following:
  120.  
  121.               Sound: Select "Off" to disable the beeps, clicks, and various
  122.                  other noises the program makes.  Select "On" to enable the
  123.                  sounds.
  124.  
  125.               Peek: When this is set "On" the reserve piles will be spread
  126.                  out so that all cards can be seen, thus helping you spot
  127.                  and perhaps avoid blocks.
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.      Osmosis Documentation                                           Page 3
  138.  
  139.  
  140.  
  141.               Session Statistics: When this option is set to "On", the
  142.                  program will keep track of your statistics (games played,
  143.                  games won, change in average score) throughout the game
  144.                  and then display them when you quit.  (Note: During play,
  145.                  you can also display the session statistics by clicking on
  146.                  the score box.)
  147.  
  148.               Darken Filled Foundations: When this option is set to "On", a
  149.                  filled foundation will be "darkened", otherwise, if it is
  150.                  set "Off", the foundation will be overwritten by the word
  151.                  "COMPLETE".  Either way, the purpose is to show that all
  152.                  necessary cards have been moved to that foundation.  Which
  153.                  method you want to use is up to you.
  154.  
  155.               Move Alert: When this option is turned on, the program will
  156.                  alert you to any available moves by displaying a message
  157.                  above the deck saying "Move Possible".  Note that this is
  158.                  only an information message -- you are not required to
  159.                  make a move when one is available.  The lay of the cards
  160.                  in the reserve piles may make some available moves ill-
  161.                  advised; use your own judgement.
  162.  
  163.               Background Color: Click on the up-arrow and down-arrow to
  164.                  step through the available background colors, until you
  165.                  find one that suits your tastes.
  166.  
  167.               Card Back: Click on the card back to bring up a dialog box
  168.                  which will show you all the available card backs and allow
  169.                  you to choose one.
  170.  
  171.               Once you've set things to your liking, you may click on the
  172.               "OK" button to save your preferences to disk, or on the
  173.               "Cancel" button to exit the Options menu without changing
  174.               anything.
  175.  
  176.            Help: This button will bring up several pages of help screens,
  177.               which you can view by clicking on the "Next" or "Prev"
  178.               buttons to move from page to page.  When you are finished
  179.               reading the help, click on the "Done" button to exit.
  180.  
  181.            New Game: This button will end the current game, update your
  182.               statistics, and start a new game.  Note that the stats will
  183.               only be updated if you have a score greater than one.  This
  184.               allows you to evaluate the layout of the cards and, if you
  185.               don't like what you see, to begin a new game without having
  186.               it count against you.
  187.  
  188.            Quit: Click on this button to exit the program.  If you have a
  189.               score greater than one, your statistics will be updated and
  190.               displayed briefly before returning you to DOS.  Another way
  191.               to exit the game is to press the "Abort" key (F10).  If you
  192.               press F10 (and select the "Exit This Program" option in the
  193.               pop-up dialog box or press F10 again), the program will quit
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.      Osmosis Documentation                                           Page 4
  204.  
  205.  
  206.               to DOS without saving the data file (and thus not giving you
  207.               a low score if you have to quit the program in the middle of
  208.               a game).  Of course you realize this is cheating, don't you?
  209.  
  210.  
  211.      Running Under Windows     _____________________
  212.  
  213.         This program will run properly under Microsoft Windows in real and
  214.         standard modes, but appears to have trouble with 386 Enhanced mode.
  215.         The program exhibits two problems when running in this mode:
  216.  
  217.            1. The mouse coordinates are shifted eight pixels down and to
  218.               the right.  This causes clicks on the upper left corner of an
  219.               object to be ignored, and clicks slightly below or to the
  220.               right of an object to be misinterpreted.
  221.  
  222.            2. The sound is sort of short and stuttering.  Eventually, after
  223.               you lose a game and the "lose" sound is played, the game
  224.               slows down to where it is unplayable.
  225.  
  226.         I have tried using a PIF file and experimenting with all the
  227.         available settings, but with no success.  However, I am not an
  228.         expert on Windows, so if anyone can figure this out, please let me
  229.         know.  In the meantime, here are three alternatives if you want to
  230.         play this game under Windows:
  231.  
  232.            1. Run Windows in real or standard mode.
  233.  
  234.            2. Turn the sound off in the "Options" menu.  You'll still have
  235.               the mouse problem, but at least the program will run at full
  236.               speed.
  237.  
  238.            2. Run the program with the new "/W" (Windows Compatability)
  239.               command-line option.  This option simply shifts the mouse
  240.               coordinates back to where they should be and uses a different
  241.               "lose" sound that doesn't appear to cause problems.
  242.  
  243.         I recognize that none of these are optimal solutions, and I hope to
  244.         improve the situation in the future.
  245.  
  246.  
  247.      Command-Line Options     ____________________
  248.  
  249.         /NC -- "No Cheat" option disables the F10 (abort) key.  Use this if
  250.                you find yourself unable to resist temptation.
  251.  
  252.         /LCD -- This option may improve the screen display on monochrome
  253.                 LCD displays.  This option simply changes a few color
  254.                 combinations to improve contrast on LCDs.
  255.  
  256.         /Rxxxxxx -- This option is used to convert a shareware version of
  257.                     the program to a registered version.  Refer to "A Note
  258.                     To Registered Users" at the end of this document for
  259.                     more information.
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.      Osmosis Documentation                                           Page 5
  270.  
  271.  
  272.  
  273.         /SW -- This option is used to convert a registered version to a
  274.                shareware version.
  275.  
  276.         /W -- This option forces the program to run in "Windows
  277.                Compatability" mode.  Refer to the "Running Under Windows"
  278.                section of this document for more details.
  279.  
  280.         filename.ext -- This option is for alternate data files (see
  281.                         discussion below).
  282.  
  283.  
  284.      Statistics     __________
  285.  
  286.         Osmosis keeps track of the score (the number of cards you've played
  287.         to the foundations), the total number of games you've played, the
  288.         number of games you've won (expressed as both a number and a
  289.         percentage), and your average score.  At the end of each game, the
  290.         statistics are written to disk, either in the default OSMOSIS.DAT
  291.         or in the data file specified on the command line.  The data file
  292.         also contains the preferences you set in the options menu.
  293.  
  294.         To specify a data file on the command line, start up Osmosis with
  295.         the following syntax:
  296.  
  297.                                OSMOSIS filename.ext
  298.  
  299.         This allows several different people to use the same copy of
  300.         Osmosis on the same machine, yet keep separate statistics for each
  301.         person.  For example, suppose three people (Tom, Dick, and Harry)
  302.         played the game at various times on the same machine.  They could
  303.         each easily keep personalized data files, containing their scores
  304.         and preferences.  Tom would use his data file by typing:
  305.  
  306.                                   OSMOSIS TOM.DAT
  307.  
  308.         Likewise, Dick and Harry could have data files called DICK.DAT and
  309.         HARRY.DAT.  Note that the "DAT" extension could be "SCR" or "HGH",
  310.         or whatever, as long as it is three letters or less.
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.      Osmosis Documentation                                           Page 6
  336.  
  337.  
  338.      Legalese     ________
  339.  
  340.         Osmosis is shareware.  As such, you can play it, copy it, and give
  341.         it away as you wish.  In fact, you are encouraged to distribute the
  342.         program to friends, family, and strangers alike.  This includes
  343.         distribution via electronic bulletin board systems (BBS), user's
  344.         groups, and disk-distribution services.  All that I ask is that the
  345.         program remain unaltered, and be distributed in an archive
  346.         consisting of:
  347.  
  348.            OSMOSIS.EXE ............. the program
  349.            OSMOSIS.DOC ............. documentation
  350.            CARDS.CD1 ............... card definition file #1
  351.            CARDS.CD2 ............... card definition file #2
  352.  
  353.  
  354.      Registration     ____________
  355.  
  356.         Osmosis is shareware.  If you enjoy the game, please support it.
  357.         There are three registration packages available:
  358.  
  359.            1. Basic Registration ................................... $5.00
  360.  
  361.               This minimum registration will get you the latest registered
  362.               (no shareware "beg" message) version of Osmosis on a diskette
  363.               of your choice, along with a registration code good for all
  364.               future updates.
  365.  
  366.            2. Package Deal #1 ..................................... $10.00
  367.  
  368.               This package consists of the latest registered version of
  369.               Osmosis, plus shareware versions of my other programs, along
  370.               with a menu program to tie them all together.  Note that all
  371.               of the additional programs are unregistered versions (with
  372.               shareware "beg" screens).  You will also receive a
  373.               registration code good for all future updates of Osmosis.
  374.  
  375.            3. Package Deal #2 ..................................... $15.00
  376.  
  377.               This package consists of the latest registered versions of
  378.               Osmosis, plus registered versions of my other programs, along
  379.               with a menu program to tie them all together.  Note that all
  380.               of the additional programs are fully registered versions (no
  381.               shareware "beg" screens).  You will also receive registration
  382.               codes good for all future updates of Osmosis and the programs
  383.               included with your registration.
  384.  
  385.         Basic registration is available on a 5.25", 360K disk or on a
  386.         3.50", 720K disk.  The package deals are available on two 360K
  387.         disks (with the programs ZIPped (with the PKZIP compression
  388.         program) to pack as much as possible onto each disk), one 720K disk
  389.         (ZIPped), or one 5.25", 1.2M disk.  If you do not have access to
  390.         PKZIP, you'll need to order the package deals on a 1.2M disk.
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.      Osmosis Documentation                                           Page 7
  402.  
  403.  
  404.         No matter what option you choose, you'll be getting a lot of
  405.         quality software for just a little dough.  Please consider
  406.         registering.
  407.  
  408.         The programs that you will get with the package deals are:
  409.  
  410.            Midnight Oil: An EGA solitaire card game, otherwise known as La
  411.               Belle Lucie and Three Shuffles and a Draw.  In this game the
  412.               deck is dealt into seventeen fans of three cards each.  Cards
  413.               are moved from the fans to four foundations, which are then
  414.               built up in suit from Ace to King.  Midnight Oil is one of
  415.               the best solitaires, affording great opportunity for skillful
  416.               play.  The game keeps statistics in a disk file, and has a
  417.               special auto mode that makes the game especially easy to
  418.               play.
  419.  
  420.            Monte Carlo: An EGA-based solitaire card game in which you try
  421.               to remove pairs of cards from a 5 x 5 matrix.  This easy-to-
  422.               play game offers hours of relaxing fun.  It keeps statistics
  423.               in much the same way as Osmosis, has selectable card designs,
  424.               and a "hint" button that makes the game especially easy to
  425.               learn.
  426.  
  427.            Calculation: This EGA-based solitaire card game is a real brain-
  428.               teaser in which you build up four foundations, each in a
  429.               different sequence.  It requires skill and logical thinking
  430.               to win, but on-screen assistance makes learning and playing
  431.               the game a snap.  It keeps a statistic file like Osmosis and
  432.               has selectable card designs.
  433.  
  434.            Idiot's Delight: An EGA version of "Aces Up", a simple but
  435.               addictive game of luck and skill.  This is one of those games
  436.               that leave you saying "just one more game" time after time
  437.               after time.  As in my other EGA games, it keeps a statistic
  438.               file and offers selectable card backs.
  439.  
  440.            Royal Cotillion: This is a two-deck EGA solitaire in which you
  441.               must build up eight foundations in suit by twos.  It offers
  442.               good opportunity for skillful play, a pleasing layout, and
  443.               hours of engrossing fun.  It keeps a statistics file, has
  444.               selectable card backs, and a time-saving auto mode.
  445.  
  446.            Concentration: An EGA graphics version of the classic memory-
  447.               stretching solitaire.  It keeps a statistics file, features
  448.               selectable card backs, and offers a unique multi-player mode.
  449.  
  450.  
  451.         You can print the registration form from the initial shareware
  452.         screen.  Simply select the "Print Registration Form" button, then
  453.         select a destination, either to a printer or a file.  If you elect
  454.         to send the form to a printer, make sure it is on-line and ready.
  455.         The form should print on any standard 80-column printer.  If you
  456.         want to save the form to a file, the file "OSMOSIS.FRM" will be
  457.         created in the current directory.  You can then print out the
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.      Osmosis Documentation                                           Page 8
  468.  
  469.  
  470.         registration form by entering the following command from the DOS
  471.         prompt (with your printer connected and ready):
  472.  
  473.                                COPY OSMOSIS.FRM PRN
  474.  
  475.         Then just fill out the form and send it, along with cash, check or
  476.         money order, to:
  477.  
  478.                                     Randy Rasa
  479.                                    18215 Troost
  480.                                  Olathe, KS 66062
  481.  
  482.  
  483.      Revision History     ________________
  484.  
  485.  
  486.         1.00  01-03-91  First Public Release.
  487.         1.01  01-11-90  Added "Session Statistics" option.
  488.                         Cosmetic changes.
  489.         1.02  02-15-91  More Cosmetic changes.
  490.         1.03  03-12-91  Added registration procedure.
  491.         1.04  03-23-91  Modified registration procedure.
  492.         1.05  04-23-91  Added option to print registration form.
  493.                         Changed card definition filenames to CARDS.CD*.
  494.         1.06  05-17-91  Fixed problem with equipment test.
  495.         1.07  06-27-91  Added Abort (F10) feature.
  496.                         The program now exits to DOS after running the
  497.                          registration procedure, and the program date and
  498.                          time are set correctly.
  499.         1.08  07-31-91  Added /LCD command-line switch.
  500.                         Added /M command-line switch.
  501.                         Darken foundations as they're filled.
  502.         1.09  09-02-91  Rewrote mouse initialization routine.
  503.                         Removed /M command-line switch.
  504.         1.10  10-28-91  Overwrite completed foundation with "COMPLETE"
  505.                          instead of darkening it.
  506.                         Added dialog box to select card back.
  507.                         Improved parsing of command-line arguments.
  508.                         Modified the "abort" sequence so that pressing F10
  509.                          once will bring up the abort dialog box, and
  510.                          pressing F10 again will exit the program.
  511.         1.11 11-24-91   Added "Darken Filled Foundations" option to allow
  512.                          the user to select whether a completed foundation
  513.                          is darkened or overwritten by the word "COMPLETE".
  514.                         Added "Move Alert" option.
  515.                         When "peeking" is disabled, cards in reserve piles
  516.                          now display slightly spread, so the number of
  517.                          cards in the pile can be seen.
  518.                         Increased number of available card backs to seven.
  519.         1.12 01-27-92   Added "/NC" (No Cheat) command-line option.
  520.                         Added "/W" (Windows Compatability) command-line
  521.                          option.
  522.  
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.  
  533.      Osmosis Documentation                                           Page 9
  534.  
  535.  
  536.      A Note To Registered Users     __________________________
  537.  
  538.         The registration procedure allows previously-registered users to
  539.         update to the new registered version of the program by entering a
  540.         special 'registration code' that was included as part of your
  541.         order.  Run the shareware version of the program with the "/R"
  542.         command-line switch, followed by the registration code, like this:
  543.  
  544.            OSMOSIS /Rxxxxxx
  545.  
  546.         You would, of course use the proper registration code in place of
  547.         the "xxxxxx".  Note also that there should be no space between the
  548.         "R" and the registration code.  After running the program with /R
  549.         switch and the proper code, you'll have a brand-spanking new
  550.         registered version of the program.  What this essentially amounts
  551.         to is unlimited, free updates with each registration.
  552.  
  553.  
  554.         The registration procedure comes with the following limitations:
  555.  
  556.            1. The name your EXE file must be OSMOSIS.EXE.
  557.  
  558.            2. You cannot perform the registration procedure on a compressed
  559.               version (ie: an EXE file processed with PKLite, Diet, or
  560.               LZEXE).  The EXE file may be compressed after the
  561.               registration procedure, but not before.
  562.  
  563.            3. Please do not distribute registered versions of the program.
  564.  
  565.            4. Since the registration procedure is a new feature, there are
  566.               a number of people who have registered earlier versions that
  567.               won't be able to take advantage of it just yet.  But if you
  568.               send me a self-addressed stamped envelope, I'll be happy to
  569.               send you the registration code.
  570.  
  571.  
  572.         Note: You can also change the program back to the shareware version
  573.               by using the "/SW" command-line switch.  This function is
  574.               subject to the same limitations as with the registration
  575.               procedure (ie: the program must be properly named and
  576.               uncompressed).  Please use this option to "un-register" the
  577.               program if you wish to pass it along to anyone.  Also, please
  578.               include all of the files listed under the "Legalese" section
  579.               of this document.  Thanks.
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.  
  592.  
  593.  
  594.  
  595.