
This program is free software; you can redistribute it and/or modify it
under the terms of the GNU General Public License as published by the
Free Software Foundation; either version 1, or (at your option) any
later version.  This program is distributed in the hope that it will be
useful, but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
General Public License for more details.  You should have received a
copy of the GNU General Public License along with this program; if not,
write to the Free Software Foundation, Inc., 675 Mass Ave, Cambridge, MA
02139, USA. See the file COPYING included in this distribution for more
information. 

Just some quick notes about Hyperoids:

See the about dialog box in the system menu for information on who
originally authored this game (Edward Hutchins eah1@cec1.wustl.edu), and
how it made it here. 

All I have done is to make some aesthetic changes and to make some
things easier (you get an extra ship every 33,333 points) and some
things more difficult (the bad ships bullets each are much heavier than
your ship, so if you're hit by one, well, you'll see...). If you have
any questions of me, or want to contact me for any reason, please feel
free to email me at rjc@infograph.com, or on CIS at 71722,3175.

The source code is incredibly clean and easy to experiement with (a
testament to Edwards abilities). 

Note that the Hyperoid window is resizable, and you can even minimize
it and play while its an icon (if you have real good eyes).

By default, the following keys make things happen:

Tab            Shield
SpaceBar       Fire
Up Arrow       Go backward
Down Arrow     Go forward 
Left Arrow     Spin left
Right Arrow    Spin Right
S Key          Smart Bombs
ESC            Boss Key (minimize to Program Manager Help Icon)


Many configuration items can be overridden using by adding/editing the
HYPEROID.INI file. What follows is a listing of the sections and keys
which can be added to this file to affect things:

Section [Hyperoid]

DrawDelay=n milliseconds between redraws
X=left window position
Y=top window position
W=width of window
H=height of window
Mono=0 or 1 (0 for color, 1 for old asteroids look)
Hi=hiscore


The next section allows you to define the RGB values of each of the
colors Hyperoids uses. The default values are shown.

Section [Palette]
Black=0,0,0
DkGrey=128,128,128
Grey=192,192,192
White=255,255,255
DkRed=128,0,0
Red=255,0,0
DkGreen=0,128,0
Green=0,255,0
DkBlue=0,0,128
Blue=0,0,255
DkYellow=128,128,0
Yellow=255,255,0
DkCyan=0,128,128
Cyan=0,255,255
DkMagenta=128,0,128
Magenta=255,0,255


This section lets you redefine the keys you use to perform actions in
hyperoids. Each key needs to be set to the decimal value of a valid
Windows virtual keycode (see the list at the end of the document). The
defaults are shown.

Section [Keys]

Shield=9					; TAB Key
Clockwise=37			; Left Arrow Key
CtrClockwise=39		; Right Arrow Key
Thrust=40				; Down Arrow Key
RevThrust=38			; Up Arrow key
Fire=32					; SpaceBar
Bomb=83					; S Key


Here is a relitively complete list of virtual keycodes. Note that the
values given are in hex and must be converted to decimal before using
in the HYPEROID.INI file:

VK_BACK           08 BACKSPACE key 
VK_TAB            09 TAB key 
VK_CLEAR          0C CLEAR key 
VK_RETURN         0D ENTER key 
VK_SHIFT          10 SHIFT key 
VK_CONTROL        11 CTRL key 
VK_MENU           12 ALT key 
VK_PAUSE          13 PAUSE key 
VK_CAPITAL        14 CAPS LOCK key 
VK_ESCAPE         1B ESC key 
VK_SPACE          20 SPACEBAR 
VK_PRIOR          21 PAGE UP key 
VK_NEXT           22 PAGE DOWN key 
VK_END            23 END key 
VK_HOME           24 HOME key 
VK_LEFT           25 LEFT ARROW key 
VK_UP             26 UP ARROW key 
VK_RIGHT          27 RIGHT ARROW key 
VK_DOWN           28 DOWN ARROW key 
VK_SELECT         29 SELECT key 
VK_EXECUTE        2B EXECUTE key 
VK_SNAPSHOT       2C PRINT SCREEN key for Windows 3.0 and later 
VK_INSERT         2D INS key 
VK_DELETE         2E DEL key 
VK_HELP           2F HELP key 

VK_0              30 0 key 
VK_1              31 1 key 
VK_2              32 2 key 
VK_3              33 3 key 
VK_4              34 4 key 
VK_5              35 5 key 
VK_6              36 6 key 
VK_7              37 7 key 
VK_8              38 8 key 
VK_9              39 9 key 
VK_A              41 A key 
VK_B              42 B key 
VK_C              43 C key 
VK_D              44 D key 
VK_E              45 E key 
VK_F              46 F key 
VK_G              47 G key 
VK_H              48 H key 
VK_I              49 I key 
VK_J              4A J key 
VK_K              4B K key 
VK_L              4C L key 
VK_M              4D M key 
VK_N              4E N key 
VK_O              4F O key 
VK_P              50 P key 
VK_Q              51 Q key 
VK_R              52 R key 
VK_S              53 S key 
VK_T              54 T key 
VK_U              55 U key 
VK_V              56 V key 
VK_W              57 W key 
VK_X              58 X key 
VK_Y              59 Y key 
VK_Z              5A Z key 

VK_NUMPAD0        60 Numeric keypad 0 key 
VK_NUMPAD1        61 Numeric keypad 1 key 
VK_NUMPAD2        62 Numeric keypad 2 key 
VK_NUMPAD3        63 Numeric keypad 3 key 
VK_NUMPAD4        64 Numeric keypad 4 key 
VK_NUMPAD5        65 Numeric keypad 5 key 
VK_NUMPAD6        66 Numeric keypad 6 key 
VK_NUMPAD7        67 Numeric keypad 7 key 
VK_NUMPAD8        68 Numeric keypad 8 key 
VK_NUMPAD9        69 Numeric keypad 9 key 

VK_MULTIPLY       6A Multiply key 
VK_ADD            6B Add key 
VK_SEPARATOR      6C Separator key 
VK_SUBTRACT       6D Subtract key 
VK_DECIMAL        6E Decimal key 
VK_DIVIDE         6F Divide key 

VK_F1             70 F1 key 
VK_F2             71 F2 key 
VK_F3             72 F3 key 
VK_F4             73 F4 key 
VK_F5             74 F5 key 
VK_F6             75 F6 key 
VK_F7             76 F7 key 
VK_F8             77 F8 key 
VK_F9             78 F9 key 
VK_F10            79 F10 key 
VK_F11            7A F11 key 
VK_F12            7B F12 key 
VK_F13            7C F13 key 
VK_F14            7D F14 key 
VK_F15            7E F15 key 
VK_F16            7F F16 key 
VK_F17            80H F17 key 
VK_F18            81H F18 key 
VK_F19            82H F19 key 
VK_F20            83H F20 key 
VK_F21            84H F21 key 
VK_F22            85H F22 key 
VK_F23            86H F23 key 
VK_F24            87H F24 key 

VK_NUMLOCK        90 NUM LOCK key 
VK_SCROLL         91 SCROLL LOCK key 



