+---------------------------------+
| Project 0 2X                    |
| A 2D scrolling shooter for GP2X |
+---------------------------------+

Contents:
001.....History
002.....Information
003.....Controls
004.....Mechanics
005.....Known bugs / To Do
006.....Credits

###############
001.....History
###############

2006-04-25

Justin Holmes has joined the project team as a pixel artist for stage backgrounds
(and any other artwork I request of him, right? :) Justin will also be the project's
audio engineer. Welcome aboard!

2006-04-03

Began Project 0 2X as a modification of the GP2X demo program found at the link below:
http://wiki.gp2x.org/wiki/Source_code_to_a_Demo_Program
Project 0 was supposed to be a temporary name since it's my first time
programming for GP2X, so it was supposed to be a pre-first-project. But I kept
going at it and this is the result. I hope the name hasn't been taken already...

###################
002.....Information
###################

Please note that SDL libraries must be installed on your GP2X in order
to play this game.

Simply extract the archive anywhere on your SD card, and select proj0.gpe to run.

Scoring mechanics inspired by DonPachi (Cave - 1995)
Graphics inspired by DoDonPachi (Cave - 1996) and Ketsui kizuna jigokutachi (Cave - 2002)

Regarding source code:
This application uses SDL, so under the GPL you are entitled to the source code. The code
is quite ugly so I have not hosted it publicly; However, you are free to send me e-mail
and I will try to reply quickly and send you an archive of the files used. My e-mail can be
found near the end of this file in the Credits section.
Of course I make no claim that the code is any good; I am actually a bit inexperienced at
programming! Good luck with your modifications!

################
003.....Controls
################

Select:             Insert coin (Title screen & Continue screen)
Start:              Start game (Title screen)
                    Continue game (Continue screen)
			        Pause/Unpause game (Gameplay)
B:                  Toggle control rotation (Title screen)
L:                  Decrease volume (Gameplay)
R:                  Increase volume (Gameplay)
Y + CLICK:          Exit to Title Screen (Gameplay)
L + CLICK:          Quit to GP2X menu (Title Screen)
Directional stick:  Player movement (Gameplay)
A, Vol-:            Shoot (Gameplay)
                    Decrement timer (Continue screen)
X, Vol+:            Bomb (Gameplay)

Normal control mode:
This control mode allows you to control the game while holding your GP2X in a rotated position.

Rotated control mode:
This control is designed for use with a TV-out cable. Using this control setup, you can play the
game on a rotated television set while holding the GP2X normally.

#################
004.....Mechanics
#################

Basics:

You are given 3 lives per credit. The hitbox on your ship is very small, but a single hit
will cause you to lose one life. Your score is reset and the ones place digit is
incremented (up to 9) when you continue. So, try not to continue, it looks really bad :)
You have approximately 3 seconds of invincibility whenever you respawn, during which you
cannot be harmed by airborne enemies or enemy bullets. Any onscreen enemy bullets are
also cleared whenever you lose a life.

Enemies come in two flavours: Air and Land/Water.
Your ship can fly over land/Water-based enemies without harm, but you will lose one life
if your ship comes into contact with an airborne enemy.

Scoring:

During the stage, destroying an enemy fills up the Hit Gauge in the upper left corner. The
gauge depletes when enemies are not being attacked or destroyed. Continually destroying enemies
before the gauge fully depletes adds to your Chain Combo. Each enemy destroyed increases your score
by a base value multiplied by the current Chain Combo.
For example, destroying seven enemies worth 20 points each yields 20+20+20+20+20+20+20 = 140 points.
However, chaining these seven enemies yields 20+40+60+80+100+120+140 = 560 points.
When your Hit Gauge is depleted, your Chain Combo is reset to 0.

During boss battles, your Chain Combo begins from 0 and is slowly increased as long as your Hit Gauge
is not empty. When the Hit Gauge is empty, your Chain Combo slowly decreases instead of resetting to 0.
A player death during boss battle does not reset the Chain Combo.

Bosses consist of a main body in addition to other destroyable parts. When a part is destroyed, your score
is increased by its base point value multiplied by the current Boss Chain Combo. Similarly, when the boss
itself is destroyed, your score is increased by the base point value multiplied by the Boss Chain Combo.
Also, when the main body is destroyed, any remaining boss parts are also destroyed, but only the destruction
bonus of the main body is added to your score.

Bombs:

You are given two bombs per life. Using a bomb grants you immediate temporary invincibility and
clears the screen of bullets. A bomb is actually 4 larger missiles that each explodes into a lingering
blast that damages enemies that come into contact with the blast. Finally, you cannot fire a bomb
when any missiles or other bomb blasts are still active.
However, enemies destroyed by the blast do not increase your Chain Combo or increase your
Hit Gauge. Additionally, enemies destroyed by the blast only increase your score by their base
point value.
Likewise, damaging a boss with a bomb does not increase your Hit Gauge or Boss Chain Combo. Destroying
a boss or boss part with a bomb also adds only the base point value to your score.
Score mechanics for regular bullets are still in effect even when a bomb is active, so it is still possible
to maintain Chain Combos even if you use a bomb.

##########################
005.....Known Bugs / To Do
##########################

Bugs:
- Bomb blasts sometimes appear in the corner of the screen instead of at the point of impact.
  Suspected cause is the order of handling events; Possibly resetting missile location before
  initialising blast.
- Using TV-out causes upper side of screen to be truncated.
  
To Do:
- Volume display
- Background music
- High score / Max chain save
- Life extend
- More stages

###############
006.....Credits
###############

Program was (heavily) modified from Charles Merriam's GP2X demo program, found at the link below:
http://wiki.gp2x.org/wiki/Source_code_to_a_Demo_Program

Explosion textures were generated using free explosion generator:
http://www.geocities.com/starlinesinc/

All other code by Geoffrey Tien.
Sprite artwork by Geoffrey Tien & Justin Holmes.
Background art by Justin Holmes.
Readme file by Geoffrey Tien.

If you like what you've played so far, please consider donating a dollar or two to my Paypal account!
gctienNOSPAM@NOSPAMshaw.ca Remove the two "NOSPAM"s ;) 

# END OF FILE #