RayGin!
DEMO v. 1.00

__________________________________________________

RayGin's REAL-TIME 3D ray casting engine stretches the performance
envelope of the PalmPilot. Running at TWENTY frames per second,
RayGin allows heart-pounding gameplay without sacrificing full first
person immersion with limp two dimensional or static graphics!

__________________________________________________

Get the full registered version!

- Thirteen Heart-Pumping Levels!
- Three Weapons!
- Three Enemies!
- And of course The Boss: The most vitriolic bastard you'll meet all day!


Order RayGin Online: http://www2.viaweb.com/pilotgearsw/steveminns.html
Order by Phone: 817.461.3480
Order by FAX: 817.461.3482

__________________________________________________

Installation:
-------------
Be sure to delete any previous version of RayGin before installing version 1.0!
__________________________________________________

In this readme:

1) How to play RayGin!
2) Software License
3) Release History\Known Bugs
4) How to reset the Pilot

__________________________________________________

If you have any questions, bug reports or comments about RayGin feel
free to send me some email at minns@interlog.com

RayGin is ©1998-1999, Steve Minns. All rights reserved.

==================================================

1) How to play RayGin!

The player is controlled with the six keys at the bottom of the Pilot.
The two keys on the left turn the player left and right(b), and
the two keys in the middle(a) move the player forward and backward.
The two keys on the right are for firing(d) and changing weapons(c).
You can also toggle the title screen by tapping the display.

Pick up items by running over them.
There are currently six different items(f) you can pick up. If it doesn't
move, pick it up. If it moves, kill it.

There are three different enemies(e), each with different strengths and
weaknesses, plus the Boss of course. Kill them all.
Enemies can carry any of the objects or weapons, so if you can't find that
key, you may just have to kill that huge, mean, guard that you have been
avoiding in order to get it. Yes, the bad guys are smart enough to open doors.

Miscellaneous Items:
--------------------
- Health
- Ammunition
- Rage
- Keys

Weapons:
--------
- Pistol
- Rifle
- Chaingun

Enemies:
--------
- Peon: Not too bright. Easy to kill.
- Sprint: Fast. Deadly. Emaciated and hard to shoot.
- Guard: Big. Mean. Slow and fat. Easy to shoot, but hard to kill.
- The Boss: The most vitriolic bastard you'll meet all day.

The gauges on the right show how much ammunition(h), health(i) and rage(j)
that you currently have. The display on the left shows which weapons(a)
and special items(b) you have picked up. You start the game with only a pistol.
The player's face(m) at the bottom of the screen shows when the player has
been shot(g), as well as his general rage level.

Search each level for the elevator(n) to get to the next level. Some doors
are locked, and you will need to find a key before you can open the door.
The map(k) in the bottom right hand corner tracks your progress in real time.

Picking up a weapon increases the amount of ammunition that you can carry,
as well as the value of each box of bullets picked up. The player also sucks
the life force out of the first guard killed, doubling the player's health,
as well as the value of any health picked up. These multipliers(c) are shown
beside the current weapon(l).

Rage:
-----
Each time you kill something, your rage level gets a little boost, but returns
to normal with time. Shoot enough enemies in quick enough succession and your
rage level will peak, and the player will go berserk. This state lasts for
several seconds, during which time the player is invincible.

You can also become enraged by picking up rage (a diamond shaped item).
This will immediately make the player go berserk.

Returning to a Completed Level:
-------------------------------
Once you have completed a level, you can go back and redo the previous level(f),
or go forward to any previously completed level(d) by tapping the level controls
on the display. You can also restart the current level(e), or restart the
entire game(g).

Enjoy!

==================================================
2) Software License

RayGin v.1.00
License Agreement

General Notes:
--------------
- RayGin is commercial software. If you are playing it, you must have paid
for it. Besides giving you that warm fuzzy feeling, paying for RayGin gives
me the incentive to continue creating bleeding-edge, envelope-stretching,
heart-pumping games for the PalmPilot!

- While every attempt has been made to clear up any bugs, it is still possible
that RayGin may contain bugs which may cause incorrect functionality either
in RayGin or in the System software. You should understand that you are
proceeding at your own risk. Backup your Pilot before running RayGin.

- Over all, enjoy! And visit the RayGin website often for the latest versions
and up-to-date information!

Legal Information:
------------------
RAYGIN ("THE SOFTWARE") IS PROVIDED 'AS IS'. STEVE MINNS ("THE AUTHOR") MAKES
NO WARRANTIES AS TO PERFORMANCE, MERCHANTABILITY, FITNESS FOR A PARTICULAR
PURPOSE, OR ANY OTHER WARRANTIES WHETHER EXPRESSED OR IMPLIED. NO ORAL OR
WRITTEN COMMUNICATION FROM OR INFORMATION PROVIDED BY THE AUTHOR SHALL CREATE
A WARRANTY. USE THE SOFTWARE AT YOUR OWN RISK. BEFORE YOU USE THE SOFTWARE,
CAREFULLY READ THE TERMS AND CONDITIONS OF THIS AGREEMENT. BY USING THE
SOFTWARE, YOU ARE CONSENTING TO BE BOUND BY AND ARE BECOMING A PARTY TO THIS
AGREEMENT. IF YOU DO NOT AGREE TO ANY OR ALL OF THE TERMS OF THIS AGREEMENT,
DO NOT USE THE SOFTWARE. UNDER NO CIRCUMSTANCES SHALL THE AUTHOR BE LIABLE FOR
DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES RESULTING FROM
THE USE, MISUSE, OR INABILITY TO USE THE SOFTWARE, EVEN IF THE AUTHOR HAS BEEN
ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. THE AUTHOR GRANTS TO YOU A
NON-EXCLUSIVE, NON-TRANSFERABLE, NON-SUBLICENSABLE, LICENSE TO USE THIS VERSION
OF THE SOFTWARE, IN BINARY EXECUTABLE FORM. YOU MAY USE THE SOFTWARE ON A
SINGLE PLATFORM ONLY. IF YOU WANT TO USE THE SOFTWARE ON MORE THAN ONE
PLATFORM AT A TIME, YOU MUST OBTAIN SEPARATE LICENSES FOR EACH PLATFORM FROM
THE AUTHOR. TITLE, OWNERSHIP RIGHTS, AND INTELLECTUAL PROPERTY RIGHTS IN AND
TO THE SOFTWARE SHALL REMAIN WITH THE AUTHOR. THIS LICENSE IS NOT A SALE OF THE
SOFTWARE OR ANY COPY OF THE SOFTWARE. THIS LICENSE DOES NOT CONVEY TO YOU AN
INTEREST IN OR TO THE SOFTWARE, BUT ONLY A LIMITED RIGHT OF USE, REVOCABLE IN
ACCORDANCE WITH THE TERMS OF THIS AGREEMENT. YOU AGREE TO ABIDE BY THE COPYRIGHT
LAW AND ALL OTHER APPLICABLE LAWS OF CANADA AND THE UNITED STATES, INCLUDING,
BUT NOT LIMITED TO, EXPORT CONTROL LAWS. YOU MAY NOT MAKE ANY COPIES OF ALL OR
ANY PART OF THE SOFTWARE, EXCEPT FOR ARCHIVAL COPIES AS PERMITTED BY THE
CANADIAN AND UNITED STATES COPYRIGHT ACTS. ANY ARCHIVAL COPY MUST CONTAIN ALL
OF THE ORIGINAL SOFTWARE'S PROPRIETARY NOTICES. YOU ACKNOWLEDGE THAT THE
SOFTWARE IN SOURCE CODE FORM REMAINS A CONFIDENTIAL TRADE SECRET OF THE AUTHOR
AND THEREFORE YOU AGREE NOT TO MODIFY THE SOFTWARE OR ATTEMPT TO DECIPHER,
DECOMPILE, DISASSEMBLE OR REVERSE ENGINEER THE SOFTWARE (EXCEPT TO THE EXTENT
APPLICABLE LAWS SPECIFICALLY PROHIBIT SUCH RESTRICTION), OR INCORPORATE IN
WHOLE OR IN PART IN ANY OTHER PRODUCT OR CREATE DERIVATIVE WORKS BASED ON ALL
OR ANY PART OF THE SOFTWARE. YOU MAY NOT REMOVE ANY COPYRIGHT, TRADEMARK,
PROPRIETARY RIGHTS, DISCLAIMER OR WARNING NOTICE INCLUDED ON OR EMBEDDED IN ANY
PART OF THE SOFTWARE; AND YOU MAY NOT SELL, LICENSE, SUBLICENSE, RENT OR
OTHERWISE TRANSFER THE SOFTWARE. THE AUTHOR RESERVES THE RIGHT AT ANY TIME TO
ALTER PRICES, FEATURES, SPECIFICATIONS, CAPABILITIES, FUNCTIONS, LICENSING
TERMS, RELEASE DATES, GENERAL AVAILABILITY OR OTHER CHARACTERISTICS OF THE
SOFTWARE. THESE EXCLUSIONS AND LIMITATIONS MAY NOT APPLY IN ALL JURISDICTIONS.
YOU MAY HAVE ADDITIONAL RIGHTS AND SOME OF THESE LIMITATIONS MAY NOT APPLY TO
YOU.

RayGin is ©1998-1999, Steve Minns. All rights reserved.

==================================================
3) Release History\Known Bugs

Release History:
----------------
99/04/09 1.00
- Final Release!

99/03/30 0.92 alpha
- On completion, reset initial stats (just pistol, no keys etc.)
- Crash on exit to apps, launch memopad (with hard key)
- Boss Sprite

99/03/29 0.91 alpha
- Can dodge bullets
- Can go back to previously completed levels
- Fixed: level 3 final room all peons are carrying keys!!
(There should be 2 keys)
- Fixed: level 4 now has too much health after the first sprite - still
(particularly in bottom left corner)

99/03/23 0.85 alpha
- Level 3: only two peons carrying keys
- Rage decay at the perfect level

99/03/18 0.84 alpha
- Level 6: no longer allowed to keep unused key
- Level 10 dialog fixed
- only get x2 health from guard: never x4

99/03/17 0.83 alpha
- Need health multiplier. Multiple Guards and higher levels are impossible to
beat without it.
- Allow the player to go back to previously completed levels, and restart game.

99/03/10 0.78 alpha
- Fixed automatic selection of new weapon
- Fixed display of multipliers
- Make rage work, expecially when killing enemies
- Allow static sprites to stay awake longer to optimize case where they're
too far away to actually be visible
- Fixed: Face on splash and level screen too fast
- Fixed: Level 4: big room sucks.
- Fixed: Level 6 does not end! (Finish it)

99/03/07 0.76 alpha
- Removed DrawFPS
- Picking up a weapon DOUBLES the amount of ammo that you can carry, as well
as the value of bullets picked up. (Rifle = x2, Chaingun = x4) ...Health too?
Also maxes ammo.
- Change splash screen to show where to buy RayGin
- Display 'Congratulations!' text after completing the last level.
- Fixed: Prevent key click when moving player
- Fixed level 5
- When picking up a weapon, automatically select the new weapon
- Created release package: readme.htm:
- Fixed: pressing the 'Apps' button twice sends game into weird state running
'under' the apps form.

99/03/01 0.69 alpha
- ALL actors can now fire
- Fixed bug: some actors disappear when falling asleep
- Added a transition screen when changing levels/dying

99/02/25 0.66 alpha
- Enemies can now fire back! Implemented more AI.
- Enemies cause less damage per attack
- Added Visual cues for: actor aiming/firing

99/02/16 0.61 alpha
- Fixed wall draw problem when very close to corner of wall
- Fixed spore on the screen when an actor is killed
- Fixed dynamic sprites falling asleep too soon/disappearing/never appearing
(you can now get the rifle on level 3...)
- Increased number of active sprites
- Disabled sound completely for now

99/02/11 0.59 alpha
- Reports the version on the splash screen (also changed the version format)
- Preserve last saved position between games
- Made level 2 easier (Peons are easier to kill)
- Added sound infrastructure
- Release as .zip so that it doesn't confuse browsers
Note: On the PalmPilot Professional with OS 3 upgrade:
There have been a few reports of version 0.59 crashing, and causing a
"boot loop" (where you keep seeing the "Welcome to PalmPilot" message over
and over again).
You should be able to fix this with a Warm Reset which will not delete all
of the data on your Pilot, like a hard reset will:
Press the reset button while holding the UP button.
Thanks to Rob Gallop and Rick Pasetto for reporting this bug!

99/02/03 alpha
- Level 2 is easier, but possibly still too hard!
- 'Fine' control. Particularly for aiming. Accelerate based on how long you
hold down a key.
- Picking up rage works

99/02/01 alpha
- Added Face animation for pain and anger

99/01/28 alpha
- Fixed nasty bug: Killing an actor in a doorway does bad things:
--- turns dropped objects into other objects, teleport pads etc.
--- can cause RayGin to crash

99/01/27 alpha
- Locked doors are now locked
- Level 2 has sprites
- Available weapons/keys windows clear when the player dies and returns to
beginning of the level

99/01/25 alpha
- Fixed the Personal 512k bug! Many thanks to Graham Whaley, Matthias
Steppuhn and Guido Berhörster for helping to find the fix and to James Davis,
Tim Escobedo, Guido Berhörster, Chris Wilkinson and Roger Brownlie for
finding this bug!
- Added Double buffer to remove wall flicker
- Peons are a bit harder to kill
- Moved some memory around: ds much smaller now

99/01/21 alpha
- Elevators now actually move the player between levels
- First three maps done
- Saves preferences at the beginning of each level

99/01/18 alpha
- Just getting back into it
- Fixed Invalid Handle caused by large data seg
- Added Map Load infrastructure

98/09/11 alpha
- First external alpha release

Known Bugs:
-----------
There are no known bugs in this release.

==================================================
4) How to reset the Pilot

There are several different ways to reset the Pilot. Some are more destructive
than others.

If RayGin caused the crash, you should delete it immediately after resetting
your Pilot WITHOUT running it first. (Running it may prevent you from deleting
it).

Soft Reset:
-----------
Use a paperclip to press the reset button, located in the small hole on the
back of the Pilot.

Warm Reset:
-----------
Press the reset button while holding the UP button.
Performing a warm reset bypasses any system "extensions" that you have
installed. This will sometimes also resolve issues with errant programs that
cause the "boot loop" where you keep seeing the "Welcome to PalmPilot" message
over and over again.

Hard Reset:
-----------
Press the reset button while holding the green power button. You will be
prompted for verification.

IMPORTANT NOTE:
This WILL delete everything installed on your PalmPilot. You should use
this reset only as a last resort.

==================================================

RayGin is ©1998-1999, Steve Minns. All rights reserved.

Less Information

More Information »