Squarez v0.8.1 for 3.xx kernel and PSP Slim
Copyright 2005 GlobWare.com
http://globware.com
globware@hotmail.com
Updated: 10/10/2008

Squarez is FREEWARE.

-------------------------------------------------------------------------------
Installation:
-------------------------------------------------------------------------------

Copy the SQUAREZ folder into X:\PSP\GAME\

The sound folder must be called "sound" and reside in the main working
directory.

-------------------------------------------------------------------------------
About Squarez
-------------------------------------------------------------------------------

Squarez is a simple action game utilizing the PSP's analog stick.

Based on a game called Ball by Nicolay Edin and Axel Hammarback, which was 
inspired by a game called Eskiv made by Jean-Francois Geyelin.

* Includes background artwork by pochi taken from http://pochistyle.pspwire.net

-------------------------------------------------------------------------------
Instructions
-------------------------------------------------------------------------------

Commands:

ANALOG STICK = Control Blue Player Square
START = Exit to Main Menu while in Game

Arcade/Bomber/Custom Mode Commands:
X = Turbo Speed
O = Slow Speed
Square = Drop Grenade
Triangle = Enable Rage

Hidden Commands:

LEFT D-PAD = Prev Song (0 = No Song)
RIGHT D-PAD = Next Song
UP D-PAD = Next Background 
DOWN D-PAD = Prev Background (0 = No background, use background color setting)

L1 = Pause Game (Can change Themes from here quickly.  For custom games this
contains the menu area for custom settings, scripting and games list.

SELECT = Screenshot (dumped to root ms0:/squarez.x.tga)

Exiting from Squarez with save your High Scores. (You can now save from the
main menu)

Your save game file will be saved to your game directory in a file called
squarez.cfg.

-------------------------------------------------------------------------------
Game Instructions
-------------------------------------------------------------------------------

The object of Squarez is to move your blue square over green squares.  When you
collect a green square an enemy red square will appear.  If you crash into a
red square your game will be over.  However, if you get the yellow powerup
square, your blue square will turn purple and a counter will appear.  While in
this mode you can destroy enemy red squares by crashing into them.  When your
timer turns red you'll have less than 10 counts before you turn back to normal.
Your score is determined by the number of green squares you collected.


Classic Mode
Original game as described above.  

Arcade Mode
Includes bomb and freeze powerups which decay after a specified amount of time.
Ability to use turbo and slow speeds.

Survival Mode
No powerups at all will appear.  Just collect as many green squares as 
possible.

Bomber Mode
Similar to survival with grenades and blockers. (shrapnal kills).  All pills
will begin with a timer, if you get the pill quick enough you will be awarded
2 grenades.  If you get it before the timer if up you get 1 grenade.  After
the timer disappears you just collect the green pill.  Grenade powerups will
appear which award 8 grenades.  Don't waste your grenades because they become
increasing important later in the game when multiple enemies appear per pill.

Custom Mode
Allows you to create and play Squarez using you own rules.

Timed Mode
All game modes playable in 3:00,2:00 and 1:00 time limits.

-------------------------------------------------------------------------------
Options
-------------------------------------------------------------------------------
(This area is mainly for testing analog speeds.  Future versions will not allow
such a wide selection of speeds since it can make the game easier by slowing
down the players square)

Analog Desensitivity - Dumb name, but since higher numbers currently slow down
your square...

Turbo Adjust - When pressing the X turbo button, this will increase your speed
by adjust amount.  Higher numbers will increase speed.  Currently if you
select a very slow sensivitity and a high turbo your square will be 
uncontrollable! So you'll need to test different settings to get comfortable.
The defaults are always a good starting place.

Slow Adjust - When pressing O slow button, this will slow down your speed.
The higher the number the more you will slow down.

Particle Effects - Off/On (when enemies are destroyed)

Sound F/X - Off/On

Music - Off/On

High Score Lists - Off/On - when on top 10 lists are kept with ability to enter
initials.  Off is older method where it keeps 1 high score and doesn't prompt
for initials. (internally all scores are kept, just 1 is shown)

Beginner Help System - Off/On - displays messages describing different bombs.
(More to be added to this system for new players)

Screenshot Counter: (0-999) The next counter to be used for a screenshot. 
ex: squarez.x.tga

Adjust Color - Adjust Color menu where you color customize many areas of the
game.  See Customizing Squarez section.

Themes - Here you can changes you themes and edit theme settings.

Default Settings - Reset back to default settings

Exit - Save you settings and exit

-------------------------------------------------------------------------------
Sound
-------------------------------------------------------------------------------

You can change/modify the .wav files to add your own sound f/x and music.
Currently only 2 songs are allowed and should be named pattern01.wav and
pattern02.wav and must exist in the sound folder.

Largest tested file was 2.8 megs.  Users have tested up to 6 meg files.

Wav files should be in 16 bit, 22hz or 44hz and PCM format.  Check settings of 
included wavs to make sure your format is correct or else your PSP will
usually freeze up and turn off after a few seconds.  Sometimes Squarez will
load but screen images become distorted.  You will need to remove your wav
file or save it correctly using the format explained above.

-------------------------------------------------------------------------------
Customizing Squarez
-------------------------------------------------------------------------------

Creating a Theme:

A theme can be completely created from within Squarez, or using a PC.  See the
include theme.txt file found in each theme folder.  The first time you start
Squarez the theme.txt file will be imported and converted to theme.sqz.  You
do not need to include your theme.txt file if you include the theme.sqz file.

Adding sprites
Make a copy of the squarezsprites.bmp file from the default theme into your 
own theme graphics folder then modify the bmp file using an image editor.
You can add transparency effects to your sprites by drawing a 1 pixel using
the transparency color at -2 pixels (x axis) from the top left of the sprite.
Since none of my sprites use black, there isn't any transparency set for
my sprites.

Adding sound
You do not need to provide your own sound, Squarez will always revert to the
default sound directory.  If you choose to add your own sounds then you must
provide all the sounds in your own directory.  If you are not changing all
of the sounds then you must copy them from the default directory into you
own sounds directory in your theme folder.

Adding a menu background
Name your bitmap image menu.bmp and place it in your graphics folder in your
theme folder.

Adding backgrounds
Make sure you only use 24 Bit Windows BMP files using no compression and place
them in a folder called /graphics and name them such as background01.bmp,
background02.bmp etc.  Currently Squarez allows for up to 10 backgrounds.

Adjust Color Menu
If you change the background you'll likely need to change the colors of Squarez
so you can read the text properly.  Squarez uses many different text color
settings as well as transparency settings to create a faded and/or overlay
effect.

RGB settings are your standard Red, Green, Blue settings from 0-31.

NMH are my settings for:

N = No transparency - Text which I wanted to display with to fading.  Such as
selecting a menu item or most text and text msgs used in the game.

M = Medium transparency - Mainly used in menus to create a non-selected or
overlay effect.

H = High transparency - When creating a dimly lit effect.  Or a light overlay.


Background Color - simply stated, changing the color of the background.  No
transparency settings.

Text Color - all standard text such as Title screen, menus, "High Score",
"Score" etc.
N-trans = Selected menu item and all text listed above.
M-trans = Non-selected menu items
H-trans = Non-selected options in menus when not active (ex: off/on settings)

Text Color (ALT) - used as an alternate color similar to the text color.  See
stats area for this effect.  stat name is the alt and the value is text color.
Currently
N-trans = all text

Important Text - things import for the user to know.  In-game msgs, "New High
Score","Bomber Mode Unlocked" and when timers are <= 10 count.
N-trans = all text listed above

Warning Text - fairly important msgs. Bomber mode timers, powerup timer when
<= 20.
N-trans = all text listed above

Special Text - "Enemies Slowed","Bonus Life"
N-trans = all text listed above

Timer Text - Only when timer is > 10 and for bomb timers only.  Timed mode
games use Warning Text for > 10 and Important Text for <= 10.

Log Text - Text displayed in lower left corner such as Loading background etc.
N-trans = all text listed above

-------------------------------------------------------------------------------
Custom Games
-------------------------------------------------------------------------------
Squarez now allows you to create your own rules.  Currently around 75% of the
game settings can be customized.  I hope to allow every single settings in
the future.

You can create a custom game within the PSP.  You cannot add scripting to your
custom game within the PSP currently.  You will need to edit the custom game
text file using any text editor then startup Squarez again.

Most of the settings of when things spawn are controlled by a players score.
Setting enemy spawn to 1, spawns an enemy every time a player collects a pill.
Setting a spawn to 10 will only generate the enemy every 10 pills.  Set to 0
to disable generating the enemy.

For bombs, set the bombspawn then for each type of bomb, set to 0 to turn 
them off and 1 to turn them on. Same goes for ALLOWTURBO,ALLOWRAGE...

-------------------------------------------------------------------------------
Scripting
-------------------------------------------------------------------------------

See included CustomGameHelp.txt file for Custom game settings and all about
scripting.

Also, visit the GlobWare.com website forums for more information.

-------------------------------------------------------------------------------
Features
-------------------------------------------------------------------------------

* Classic, Arcade, Survival, Bomber & Custom Modes each with 3:00,2:00 & 1:00 
timed modes allowing for 20 possible modes.  Bomber mode is unlockable after 
scoring 150 in arcade mode.
* Option area to select analog desensitivity, turbo adjust and slow adjust.
* 6 powerup bombs (random bomb appears every 10 points)
* Enemy Blockers (will randomly stop and change directions, appears every 15
  points,resists powerup and immune to nuke bomb)
* Sound F/X and Music (currently only 2 patterns/songs)
* Custom Themes featuring menu & background images and custom color settings.
* Simple scripting for custom games.

-------------------------------------------------------------------------------
Revision Changes
-------------------------------------------------------------------------------
Version 0.8.1 Slim
 * Fixed so it works on the 3.xx/4.xx kernel

Version 0.8.1
 * Quick fix for people having problems locating default theme folder.

Version 0.8
 * Added Bomb Blockers which explode after a few seconds.  Shrapnal will kill
   you.
 * Added Enemy Hives which spawns generator babies very quickly.
 * Added Rage!  Kill enemies quickly when in powerup mode to gain rage.  Then 
   press Triangle to unleash your rage, in this mode you can destroy anything!
 * Added Rage Powerup.  Gives full rage, but if you miss the powerup it 
   explodes. (shrapnal kills anything)
 * Added Custom mode.  This allows you to create and play Squarez with your 
   own rules.  Simple text files so people can easily share custom games.
 * Added scripting to Squarez in all game modes.  Currently only a few 
   commands exist, but this will allow you to create unique pre-planned
   events. Currently scripting must be done on a PC using a text editor and
   saved to your memory stick.
 * Added Themes which include custom menu background, up to 10 game backgrounds,
   custom sprites, custom sounds and color/text settings.  This will allow
   people to create and share their own custom theme packs.  Sound is not
   required.  Default sounds will be used.  Up to 10 themes allowed.
 * Added a Screenshot viewer.
 * Updated the instructions screen and included a control layout help image.


Version 0.7.5
 * Added ability to load up to 10 background images. (place in /background)
 * Added Adjust Color settings to Options Menu where you can customize all the
   text colors and background color.
 * Added Log text to lower left corner for displaying info about changing 
   songs, backgrounds etc.
 * Added Help Menu System option which currently just turns on/off msgs.
 
Version 0.7
 * Added new bomber mode which is unlockable by scoring 150 in arcade mode.
 * Added 3:00,2:00 & 1:00 timed modes to all 4 games allowing for 16 games.
 * Added Top 10 High Score lists and ability to enter initials for all 16 game
   modes and an option to turn off the lists and revert to older method.
 * Player powerup timer with now turn yellow when counter is <= 20.
 * Added powerup bar timer to lower right hand corner of screen.
 * Added 2 new enemy blockers, smart blockers and generator blockers.
 * Added player grenades to arcade and bomber modes.  Press square to drop a 
   grenade.  Grenade inventory displayed on lower right side of screen.
 * Added bonus life powerups every 125 points.  Displayed on lower right side
   of screen near grenades.  After death, press Square to use a life, and
   square again to enter the game. (you will be in ghost mode before entering)
 * Added 49 stats from Total Running Time to Grenades Exploded, game timers and
   game played counters for all games displayable from the main menu.
 * Ability to load up to 10 patterns.  Must be named pattern01.wav,
   pattern02.wav, pattern03.wav...

Version 0.6
 * Added Sound F/X and Music
 * Added Sound F/X Off/On option
 * Added Music Off/On option

Version 0.5
 * Added true particle effects for bombs and when enemies are destroyed.
 * Added Enemy Blockers to Arcade Mode which resist the players powerup.
 * Nuke bomb nerfed so Enemy Blockers are immune.  Better balance for Nuke.
 * Added Instructions option to menu for new players.

Version 0.4
 * Added particle effects to enemies when they are destroyed.
 * Particle effects can be set on/off in options - saved to .cfg file
 * Added screenshot counter to .cfg and options so screenshots will no longer
   get overwritten.
 * Added 3 new bomb powerups using particle effects to Arcade mode.
 * Added L1 for Pause.
 * Added moving squares to splash/menu, options and credits screens for fun.

Version 0.3
 * Fixed bug to increase framerate to 60 FPS
 * Added Classic, Arcade and Survival Modes
 * Option area to select analog desensitivity, turbo adjust and slow adjust.

Version 0.2
 * Draw Player before enemies to see which enemy killed the player when dead.
 * Added Bomb and Freeze Bomb which are on a 10 point timer.
 * Fixed bug where green square collision detection didn't account for larger
   purple sized player.

Version 0.1
 * First public beta release.

-------------------------------------------------------------------------------
Known Errors
-------------------------------------------------------------------------------

 * some static noises when playing certain sound f/x.

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

If you have any comments, suggestions or bugs, then email globware@hotmail.com
or check out http://globware.com for any updates or fixes.

THIS SOFTWARE PROGRAM MAY BE DISTRIBUTED FOR FREE. THIS PROGRAM CAN NOT BE
SOLD WITHOUT PERMISSION FROM THE AUTHOR/GLOBWARE.COM

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