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