home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload / ShartewareOverload.cdr / games / mo221.zip / MO.DOC < prev    next >
Text File  |  1991-07-08  |  23KB  |  595 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.                                   Midnight Oil
  10.  
  11.                                   Version 2.21
  12.  
  13.                               Copyright 1989-91 By
  14.                                    Randy Rasa
  15.                                   18215 Troost
  16.                                 Olathe, KS 66062
  17.  
  18.  
  19.  
  20.      What Is It?     ___________
  21.  
  22.         Midnight Oil, also known as "La Belle Lucie" and "Three Shuffles
  23.         and a Draw", is one of the few solitaire card games that offers
  24.         both challenging play and a reasonable chance to win.  It is also
  25.         highly addictive; once you get into it, you'll be "burning the
  26.         midnight oil" more often than not.
  27.  
  28.  
  29.      Program Requirements     ____________________
  30.  
  31.         Midnight Oil requires 256K of memory, EGA or higher graphics
  32.         capability, and a Microsoft-compatible mouse.  If you are not sure
  33.         you have the right hardware, just run the program.  If there's a
  34.         problem, the program will let you know.  Incidentally, the text-
  35.         mode-only version of Midnight Oil is still available on request,
  36.         for those of you without EGA graphics.
  37.  
  38.         In addition to the program file (MO.EXE), the game requires that
  39.         the card definition files (CARDS.CD1 and CARDS.CD2) be in the
  40.         current directory.  These files contain the bit-maps for each
  41.         cardface in the deck.
  42.  
  43.  
  44.      Using The Mouse     _______________
  45.  
  46.         The mouse pointer will appear as a white arrow with black edges.
  47.         In general, the left button is used to select the object being
  48.         pointed to (a card or a button), while the right button is used to
  49.         exit menus or prompts.
  50.  
  51.         If you have a three-button mouse, the middle button will blank the
  52.         screen.  This can also be accomplished by pressing the left and
  53.         right buttons simultaneously.
  54.  
  55.      How To Play     ___________
  56.  
  57.         Midnight Oil uses a standard 52-card deck (no jokers).  To begin
  58.         the game the deck is shuffled, then dealt face-up, one card at a
  59.         time, into seventeen piles of three cards each.  The last card is
  60.         placed by itself as an eighteenth pile.  These piles are also known
  61.         as "fans".
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.      Midnight Oil Documentation                                      Page 2
  72.  
  73.  
  74.  
  75.         The object of the game is to move all of the cards from the
  76.         eighteen fans into four new piles, arranged by suit, in order from
  77.         Ace (low) to King (high).  These four destination piles are known
  78.         as the "foundations".  Only the top card of each fan is available
  79.         for play.
  80.  
  81.         In addition to moving cards from fans to foundations, cards can
  82.         also be moved from one fan to another, building down in suit.  In
  83.         this way submerged cards can be freed up for play to the
  84.         foundations or to other fans.  Once a fan becomes empty (which will
  85.         be represented my a dashed line where the fan was), no moves can be
  86.         made to that fan.
  87.  
  88.         When you have made all the moves you can, from the fans to the
  89.         foundations and from fan to fan, the remaining cards in all the
  90.         fans may be reshuffled and re-dealt in the same manner as at the
  91.         beginning of the game (three cards to a fan).  In all, the deck may
  92.         be shuffled three times (once to begin the game, and twice more
  93.         during the game).
  94.  
  95.         At some point during the game, you may draw one submerged card from
  96.         a fan and play it on any valid foundation or fan.  It is generally
  97.         better to save this draw for as long as possible.
  98.  
  99.  
  100.      Buttons     _______
  101.  
  102.         Along the right side of the screen are a number of "buttons", which
  103.         may be selected by pointing and clicking with the mouse.  The
  104.         buttons are:
  105.  
  106.            Shuffle: This button will initiate a shuffling of the deck, in
  107.               which all of the cards in the fans are picked up, shuffled,
  108.               and then re-dealt.  If no shuffles are left, the program will
  109.               display the message "No shuffles left".
  110.  
  111.            Draw: When you select this button, you will be asked to select a
  112.               pile (fan) to draw from.  When you select a fan, it will be
  113.               displayed in the lower right corner of the screen, and you
  114.               will be allowed to select one card from that fan to draw.  If
  115.               you change your mind and decide that you don't want to draw a
  116.               card after all, press the right button to exit draw mode.  If
  117.               you select a card, it will be removed from the fan and
  118.               displayed in the lower right corner of the screen, and you
  119.               will be prompted to select a destination.  Point to the
  120.               desired fan or foundation and press the left mouse button to
  121.               move the drawn card to the selected fan or foundation.
  122.  
  123.            Peek: This is similar to a draw, in that an entire fan will be
  124.               displayed in the lower left corner of the screen, but you are
  125.               only allowed to look, not touch.  To exit peek mode press the
  126.               right mouse button twice.
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.      Midnight Oil Documentation                                      Page 3
  138.  
  139.  
  140.            Options: This button brings up the options menu, which you can
  141.               use to set your preferences for the following:
  142.  
  143.               Sound: Select "Off" to disable the beeps, clicks, and various
  144.                  other noises the program makes.  Select "On" to enable the
  145.                  sounds.
  146.  
  147.               Auto Mode: When this is set to "On", the program will attempt
  148.                  to move cards from the fans to the foundations
  149.                  automatically.  This will relieve you from having to worry
  150.                  about missing obvious moves, so that you can concentrate
  151.                  on strategy.  When this is set to "Off", the game is
  152.                  essentially in manual mode, and you will need to make all
  153.                  moves to the foundations by yourself.  This option is
  154.                  provided for those traditional-minded souls who might
  155.                  consider auto mode to be cheating.
  156.  
  157.               Auto Speed: This allows you to adjust how fast the cards are
  158.                  played in auto mode.  Click on the left and right arrows
  159.                  to move the pointer along the scale from "Slower" to
  160.                  "Faster".  At the fastest setting, cards are moved as fast
  161.                  as possible (a blur of action).  The slowest setting is
  162.                  "single-step" mode, in which you will be prompted before
  163.                  each automatic move.  You will need to experiment to find
  164.                  an acceptable setting for your computer.
  165.  
  166.               Session Statistics: When this option is set to "On", the
  167.                  program will keep track of your statistics (games played,
  168.                  games won, change in average score) throughout the game
  169.                  and then display them when you quit.  (Note: During play,
  170.                  you can also display the session statistics by clicking on
  171.                  the score box.)
  172.  
  173.               Trefoil Option: 'Trefoil' is the name of a variation of
  174.                  Midnight Oil in which all the aces are placed on the
  175.                  appropriate foundations at the start of the game.  This is
  176.                  supposed to make the game a little easier to win, since
  177.                  there are four fewer cards to move to foundations.  If you
  178.                  change the Trefoil option while a game is already in
  179.                  progress, you'll have to finish the current game before
  180.                  the change takes effect.
  181.  
  182.               Replay Option: When this option is turned "On", you will have
  183.                  the choice of whether or not you want to replay a game
  184.                  that you have lost.
  185.  
  186.               Easy Mode: When this option is set "On", then a special
  187.                  algorithm will be used when shuffling the deck.
  188.                  Essentially, it will prevent lower cards of a particular
  189.                  suit from being buried by higher cards of the same suit.
  190.                  This will have the effect of removing most of the
  191.                  potential blocks in the game.  in this mode you will still
  192.                  not win every game, but it's the closest thing I've seen
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.      Midnight Oil Documentation                                      Page 4
  204.  
  205.  
  206.                  to a sure thing.  This mode is set as the default the
  207.                  first time the program is run.
  208.  
  209.               Background Color: Click on the up-arrow and down-arrow to
  210.                  step through the available background colors, until you
  211.                  find one that suits your tastes.
  212.  
  213.               Once you've set things to your liking, you may click on the
  214.               "OK" button to save your preferences to disk, or on the
  215.               "Cancel" button to exit the Options menu without changing
  216.               anything.
  217.  
  218.            Undo: This button allows you to undo the last inter-fan move,
  219.               that is, the last move from one fan to another.  You cannot
  220.               undo moves to the foundation, a shuffle, or a draw.
  221.  
  222.            Help: This button will bring up several pages of help screens,
  223.               which you can view by clicking on the "Next" or "Prev"
  224.               buttons to move from page to page.  When you are finished
  225.               reading the help, click on the "Done" button to exit.
  226.  
  227.            New Game: This button will end the current game, update your
  228.               statistics, and start a new game.  Note that the stats will
  229.               only be updated if you have a score greater than zero.  This
  230.               allows you to evaluate the layout of the cards and, if you
  231.               don't like what you see, to begin a new game without having
  232.               it count against you.
  233.  
  234.            Quit: Click on this button to exit the program.  If you have a
  235.               score greater than zero, your statistics will be updated and
  236.               displayed briefly before returning you to DOS.  Another way
  237.               to exit the game is to press the "Abort" key (F10).  If you
  238.               press F10 (and select the "Exit This Program" option in the
  239.               pop-up dialog box), the program will quit to DOS without
  240.               saving the data file (and thus not giving you a low score if
  241.               you have to quit the program in the middle of a game).
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.      Midnight Oil Documentation                                      Page 5
  270.  
  271.  
  272.      Statistics     __________
  273.  
  274.         Midnight Oil keeps track of the score (the number of cards you've
  275.         moved to foundations) and the number of shuffles and draws you have
  276.         left during the course of the game.  Also displayed are the total
  277.         number of games you've played, the number of games you've won
  278.         (expressed as both a number and a percentage, and your average
  279.         score.  At the end of each game, the statistics are written to
  280.         disk, either in the default MO.DAT or in the data file specified on
  281.         the command line.  The data file also contains the preferences you
  282.         set in the options menu (sound on/off, auto mode on/off, and
  283.         background color).
  284.  
  285.         To specify a data file on the command line, start up Midnight Oil
  286.         with the following syntax:
  287.  
  288.                                   MO filename.ext
  289.  
  290.         This allows several different people to use the same copy of
  291.         Midnight Oil on the same machine, yet keep separate statistics for
  292.         each person.  For example, suppose three people (Tom, Dick, and
  293.         Harry) played the game at various times on the same machine.  They
  294.         could each easily keep personalized data files, containing their
  295.         scores and preferences for sound, auto mode, and background color.
  296.         Tom would use his data file by typing:
  297.  
  298.                                     MO TOM.DAT
  299.  
  300.         Likewise, Dick and Harry could have data files called DICK.DAT and
  301.         HARRY.DAT.  Note that the "DAT" extension could be "SCR" or "HGH",
  302.         or whatever, as long as it is three letters or less.
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  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.      Midnight Oil Documentation                                      Page 6
  336.  
  337.  
  338.      Legalese     ________
  339.  
  340.         Midnight Oil is shareware.  As such, you can play it, copy it, and
  341.         give it away as you wish.  In fact, you are encouraged to
  342.         distribute the program to friends, family, and strangers alike.
  343.         This includes distribution via electronic bulletin board systems
  344.         (BBS), user's groups, and disk-distribution services.  All that I
  345.         ask is that the program remain unaltered, and be distributed in an
  346.         archive consisting of:
  347.  
  348.            MO.EXE ............. the program
  349.            MO.DOC ............. documentation
  350.            CARDS.CD1 .......... card definition file #1
  351.            CARDS.CD2 .......... card definition file #2
  352.  
  353.  
  354.      Registration     ____________
  355.  
  356.         Midnight Oil is shareware.  If you enjoy the game, please support
  357.         it.  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 Midnight Oil on a
  363.               diskette of your choice, along with a registration code good
  364.               for all future updates.
  365.  
  366.            2. Package Deal #1 ..................................... $10.00
  367.  
  368.               This package consists of the latest registered version of
  369.               Midnight Oil, plus shareware versions of of my other
  370.               programs, along with a menu program to tie them all together.
  371.               Note that all of the additional programs are unregistered
  372.               versions (with shareware "beg" screens).  You will also
  373.               receive a registration code good for all future updates of
  374.               Midnight Oil.
  375.  
  376.            3. Package Deal #2 ..................................... $15.00
  377.  
  378.               This package consists of the latest registered version of
  379.               Midnight Oil, plus registered versions of my other programs,
  380.               along with a menu program to tie them all together.  Note
  381.               that all of the additional programs are fully registered
  382.               versions (no shareware "beg" screens).  You will also receive
  383.               registration codes good for all future updates of Midnight
  384.               Oil and the programs included with your registration.
  385.  
  386.         Basic registration is available on a 5.25", 360K disk or on a
  387.         3.50", 720K disk.  The package deals are available on two 360K
  388.         disks (with the programs ZIPped (with the PKZIP compression
  389.         program) to pack as much as possible onto each disk), one 720K disk
  390.         (ZIPped), or one 5.25", 1.2M disk.  If you do not have access to
  391.         PKZIP, you'll need to order the package deals on a 1.2M disk.
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.      Midnight Oil Documentation                                      Page 7
  402.  
  403.  
  404.  
  405.         No matter what option you choose, you'll be getting a lot of
  406.         quality software for just a little dough.  Please consider
  407.         registering.
  408.  
  409.         The programs that you will get with the package deals are:
  410.  
  411.            Monte Carlo: An EGA-based solitaire card game in which you try
  412.               to remove pairs of cards from a 5 x 5 matrix.  This easy-to-
  413.               play game offers hours of relaxing fun.  It keeps statistics
  414.               in much the same way as Midnight Oil, has selectable card
  415.               designs, and a "hint" button that makes the game especially
  416.               easy to learn.
  417.  
  418.            Calculation: This EGA-based solitaire card game is a real brain-
  419.               teaser in which you build up four foundations, each in a
  420.               different sequence.  It requires skill and logical thinking
  421.               to win, but on-screen assistance makes learning and playing
  422.               the game a snap.  It keeps a statistic file like Midnight Oil
  423.               and has selectable card designs.
  424.  
  425.            Osmosis: In this EGA solitaire card game you have four
  426.               foundations to build, but a card can only be played to a
  427.               lower foundation if it has also been played to an upper
  428.               foundation.  This addictive game is simple to play but
  429.               difficult to win, with success often depending as much on
  430.               luck as skill.  It keeps statistics on-disk, offers
  431.               selectable card backs and has a "peek" option to give you an
  432.               extra edge.
  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.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.      Midnight Oil Documentation                                      Page 8
  468.  
  469.  
  470.         You can print the registration form from the initial shareware
  471.         screen.  Simply select the "Print Registration Form" button, then
  472.         select a destination, either to a printer or a file.  If you elect
  473.         to send the form to a printer, make sure it is on-line and ready.
  474.         The form should print on any standard 80-column printer.  If you
  475.         want to save the form to a file, the file "MO.FRM" will be created
  476.         in the current directory.  You can then print out the registration
  477.         form by entering the following command from the DOS prompt (with
  478.         your printer connected and ready):
  479.  
  480.                                   COPY MO.FRM PRN
  481.  
  482.         Then just fill out the form and send it, along with cash, check or
  483.         money order, to:
  484.  
  485.                                     Randy Rasa
  486.                                    18215 Troost
  487.                                  Olathe, KS 66062
  488.  
  489.  
  490.  
  491.      Revision History     ________________
  492.  
  493.         1.00  11-08-89  First Public Release.  Text-based version.  Through
  494.                         the next year, the program went through about a
  495.                         dozen revisions as bugs were fixed and features
  496.                         were added ...
  497.         2.00  12-19-90  New EGA version released.
  498.         2.01  01-03-91  A few small enhancements and bug fixes.
  499.                         Documentation upgrades.
  500.         2.02  01-05-91  A few cosmetic changes.
  501.         2.10  01-11-91  Added "Session Statistics" option.
  502.                         More cosmetic changes.
  503.         2.11  02-08-91  Fixed bug in draw routine.
  504.                         More cosmetic changes.
  505.         2.12  02-24-91  Added auto mode speed adjustment.
  506.         2.13  03-12-91  Added Trefoil option.
  507.                         Added registration procedure.
  508.         2.14  03-23-91  Modified registration procedure.
  509.         2.15  04-09-91  Fixed bug in "Peek" mode.
  510.         2.16  04-23-91  Added option to print registration form.
  511.                         Changed card definition filenames to CARDS.CD*.
  512.         2.17  05-17-91  Fixed problem with equipment test.
  513.         2.20  06-14-91  Added replay option.
  514.                         Added F10 (abort) key.
  515.                         Added "Easy Mode" option.
  516.         2.21  07-08-91  The program now exits to DOS after running the
  517.                         registration procedure, and the program date and
  518.                         time are set correctly.
  519.                         Added command-line help ("MO ?").
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.  
  533.      Midnight Oil 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 an "/R"
  542.         command-line switch, followed by the registration code, like this:
  543.  
  544.            MO /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 MO.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 (as of
  565.               version 2.13), there are a number of people who have
  566.               registered earlier versions that won't be able to take
  567.               advantage of it just yet.  But if you send me a self-
  568.               addressed stamped envelope, I'll be happy to send you the
  569.               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.