
Whack-A-Mole for OS/2!
----------------------
This is my OS/2 interpretation of a carnival game called Whack-A-Mole.
The original was a board with some holes in it.  Mechanical "Moles" 
would briefly stick their heads out from a random hole.  The player
had to whack the mole with a mallet before it returned to its hole.
I have taken license with some of the features.  Rather than being
limited to four or five holes, these moles have the freedom to
appear anywhere on your screen, even on top of one another.  If you
are opposed to whacking moles, and have the appropriate bitmaps handy,
whack Bob Dole, your boss, or Barney the Dinosaur instead.  Whack-A-Mole
is SHAREWARE.  Please read the registration information in this document.

Thanks for trying Whack-A-Mole!

New in Version 1.10!
-------------------
- New levels!  You can now choose from 23 different speeds at which to
  play Whack-A-Mole.  I'd like to thank Gary Dennis and George Seikel
  for their suggestions.

- New convenience options!  Automagically save all, some, or none of
  your options when you exit the game.  Again, Gary Dennis gave me a
  push here.  Thanks!

- A new sound effect!  ROADKILL.WAV is still the default, but I've also
  included SQUISH22.WAV.  Thanks to Jaime Cruz for this one.

Installation
------------
New Install - Simply copy the executable and dll to whichever directory
you want, create an object for it on your desktop, and start banging away.
The first time it runs, Whack-A-Mole will create a file called Whack.ini
in the same directory as the executable.  A high score file, whack.hsc will
also be created.

!!!! NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE !!!!
Upgrade - Please delete your whack.ini file before upgrading to version
1.10.

The Controls
------------
Number of Moles:  This control will let you adjust the number of moles
                  in a game, from ten up to 1000.  The default is 22.

Speed:  This control lets you adjust the frequency at which moles
        appear.  Note that the speed control has no effect on the new
        Surprise! level.

Restore Defaults:  This control restores the default number of moles
                   and default speed.

Start Game: I think this one is self explanatory.

Stop Game:  Ditto.

Settings...:    This brings up the Settings notebook.  The notebook
                currently has three pages.
    Notebook Page 1:    This page contains bitmap options and a preview
                        of the currently loaded bitmap.  The name of the
                        current bitmap is displayed at the top.  Buttons
                        allow you to change the bitmap or restore the
                        default bitmap.
    Notebook Page 2:    This page contains sound effect options.  The name
                        of the current sound effect is displayed at the
                        top.  Buttons allow you to change and try out
                        sound effects, and restore the default effect.  A
                        checkbox allows you to disable the sound.

                        If you don't have multimedia installed or don't
                        have a sound card, the options on this page will
                        be disabled.  If you have multimedia AND a sound
                        card supported by OS/2, and the options are
                        disabled, it's a bug.  Please let me know about
                        it.
    Notebook Page 3:    This page contains the settings for level of play
                        and for choosing the things that are saved to your
                        ini file when you exit the program.  The play levels
                        are:
                            Hey, I'm Serious! - This is the default play
                            level.  It's exactly what was in previous
                            versions.

                            Child's Play - For young children, just learning
                            to use a mouse, this level pops 'em up slower
                            and leaves 'em up longer.

                            Surprise! - Who knows when it'll pop up?  Other
                            than that it'll be sometime between one minute
                            and one half hour since the last one, I don't
                            even know when.

                        The Save On Exit options are:
                            Bitmap Setting - Save the current bitmap setting
                            whenever you exit the program.

                            .WAV Setting - Save the current sound effect setting
                            whenever you exit the program.

                            Speed Setting - Save the current speed setting
                            whenever you exit the program.

                            Level Setting - Save the current play level setting
                            whenever you exit the program.

                            Mole Count Setting - Save the current number of moles
                            whenever you exit the program.

                In addition to the notebook pages, the Settings dialog has
                three buttons.  Defaults, Save, and Done.  Defaults will
                restore the default values for bitmap, sound, and play level.
                Save will save the current options, and Done will dismiss the
                notebook.

High Scores:    Displays the 10 best scores achieved.  In the high
                scores dialog box, you have the option to clear the
                high scores.  I placed this button far from the Ok
                button to make it more difficult to hit by accident.
                The high score dialog is context sensitive.  It shows
                only the high scores achieved at the current level of
                play.  Likewise, the CLEAR button will only clear the
                scores for the present level of play.

About Whack-A-Mole: Displays the support and copyright information for
                    Whack-A-Mole.

Quit:   Another one that needs no explanation.


The Play
--------
Simply adjust the above-mentioned controls as desired, and hit the
start game button.  As moles appear in random locations on the screen,
you must whack them as quickly as possible.  The titlebar of the main
window will keep track of the number of moles created thus far in the
game.  If you don't want to play all the way to the end, simply whack
the moles covering the Stop Game or Quit button, and click on said
button.  All the moles will disappear, and the game will be over.


The Scoring
-----------
I had a rough time deciding how to score this, but finally decided on
the following:

Level			Whack Time		Points
------------------------------------------------------
Hey, I'm Serious!	< .5s			4*Speed
			.5s - 1s		3*Speed
			1s - 1.5s		2*Speed
			1.5s - 2s		1*Speed
			> 2s			0
Child's Play		< 1.25s			4*Speed
			1.25s - 2.5s		3*Speed
			2.5s - 3.75s		2*Speed
			3.75s - 5s		1*Speed
			> 2s			0
Surprise		< .5s			4
			.5s - 1s		3
			1s - 1.5s		2
			1.5s - 2s		1
			> 2s			0

At the end of the game, if you've made it into the top 10, you'll be
given a chance to enter your name (up to 32 characters).  The top 10
high scores will then be displayed.

------------------------------------------------------------------------

Future Plans
------------

German language support is sort of in the works, as I know a bit of
German.  If you want to see other languages, then you'll have to translate
for me.

I have already received input from testers regarding new features they
would like to see.  They said:

* Use a second bitmap, so that when you whack the mole, it changes to
  a bloody mole or something.  I actually have the bloody mole bitmap, but
  need to add the code.

* Allow the player to use different mouse cursors.

* Animate the mouse cursor, so that the mallet looks like it's swinging.

* Online help?  The game's still small, but it's growing.  If you think
  it needs online help, then email me.

Performance is a priority, so I will weigh the performance hit of any
new features before deciding to add them.  If there are any new features
that you would like to see, feel free to contact me.  I'll be much more
likely to add the features if you are a registered user ( see below ).  I
am also interested in ideas for new projects.  If there's something you
want for OS/2, contact me about it.  I'm still coming up to speed on OS/2
programming, but I'll be happy to give it a try.

Please email your suggestions and bug reports to
    erlkonig@randomc.com


Known Bugs
----------
None.  Finally.


Registration
------------
This is my first piece of shareware, and my first real bit of PM coding.
Don't cause me to become disillusioned with the shareware concept.  If
you like the game, you must register it after 14 days.  The cost is only
$5.00 US (check or money order only, for your safety), sent to:

Matthew Wagner
PsychoSemantic Software
1122 RIVA RIDGE DR
NORCROSS GA 30093

If you provide me with your email address, I will acknowledge your
registration and keep you informed of updates.  There are no missing
features or nag screens in the shareware version, so your only
motivation for registering is a clean conscience. Your registration is
valid for all future shareware releases of Whack-A-Mole.  If a large
wealthy company buys the rights from me, you're at their whim.


License and Disclaimer
----------------------
By using this software, you agree to the following terms.

Whack-A-Mole is not free.  The shareware version of Whack-A-Mole is
licensed to you to try for 14 days.  At the end of that period, you
must register the software or remove all copies from your system.
Upon registering, you are licensed to install Whack-A-Mole on as
many computers as you desire, provided only one copy will be in use at
any given time.  You may freely distribute Whack-A-Mole, provided you
distribute the entire archive, original and unmodified, including this
documentation.  You may not alter, disassemble, or otherwise reverse
engineer Whack-A-Mole.

If you are dissatisfied with Whack-A-Mole, I will be happy to refund
your registration fee.  There are no other warranties, express or implied.
The author and PsychoSemantic Software are not responsible for any damage,
direct or indirect, caused to your computer, productivity, or anything
else by this software.  This software is not warranted to be free of bugs.

This software may not be used for military purposes.  It may be used by
military personnel for nonmilitary purposes only.

History
-------
1.10	Sept 22, 1996   Added new speed levels and save options.  Reworked
                        high score file handling to better fit additional
                        speed levels.
1.01	Sept 12, 1996	Fixed path bug
1.0	Sept 2, 1996	Initial Release

About the Author
----------------
I received my BS in Mathematics from MIT in 1993, and my MS in Applied
Mathematics from the University of Arizona in 1995.  I program in C on
OS/2, MVS, AS400, and Windows NT for FormMaker Software, Inc.  I'm writing
OS/2 shareware on the side to help pay back my large college debt.


Thanks
------
A short list of those I'm indebted to.

* Andy Key, for releasing his excellent GBM source to the public domain.
* Whoever wrote BITMAP32 and published the source on the DevCon cd's.
* The guys at FormMaker software, for testing this stuff and ragging me
  when it didn't work.
* Mike Compton at FormMaker, for drawing my bitmaps.
* The authors of all the excellent OS/2 software, for setting a great
  example.
* Everyone who registers Whack-A-Mole and helps support further OS/2
  development.

