           -= The Ur-Quan Masters 2X 1.1 =-
	         (based on UQM 0.6.2)

         Ported to GP2X by Senor Quack (Dan Silsby)
               dansilsby <AT> gmail <DOT> com

                     Jan. 15, 2008

      Welcome to one of the greatest games ever made!

This is the definitive port of The Ur-Quan Masters to the 
GP2X.  It is quite stable (no crashes have ever been
reported by users so far and your author has neither ever 
had a crash.)  It runs at full speed in every situation at
200mhz, but you must enable the RAM tweak through GMenu2X's 
launcher to achieve this.  UQM2X is a very bandwidth-
hungry game and probably always will be, because all graphics
work is done at 32bpp internally.  TV-Out mode might require 
a slight overclock.

If you have saved games from either my previous versions of
this port or the ports by foehammer or loki666,
you can copy them into the save folder of this version.

Notice:  UQM2X now uses v0.6.2, not v0.6.3 of UQM.
  This was because joystick controls are broken in 0.6.3.
  If you were a user of my language translation pack, you 
  must download the latest version of it; previous versions 
  won't work.

IMPROVEMENTS IN VERSION 1.1 OVER 1.0:
-------------------------------------
     (released Jan 15, 2008)

* USB joystick support for 1 or 2 players, out of the box.
  Since the main UQM port's control configuration is not 
  complete yet, I spent a week writing a custom control 
  configurator.  You can customize all controls for the GP2X
  and USB Joysticks 1 & 2.  Launch "uqm2xcfg.gpe" to use it.  
  UQM2X now has better joystick support than any other port.  
  In fact, it has better joystick support than the native PC 
  version itself. Joystick controls are preset for two 
  Logitech Dual Action controllers.  

* Altered some bilinear sprite-scaling code to work properly
  with 16bpp surfaces.  Bilinear scaling is now used for 
  all sprite scaling.  As a result, smooth-scaling mode is 
  now full-speed and is the new default for melee fights.  
  This includes fights in the single-player game.

* Adjustable TV-Out support.  Game now detects TV-Out mode
  and adjusts screen resolution appropriately for PAL/NTSC.
  At the main menu, you can adjust the screen centering by
  holding the R-trigger button and moving the stick/DPAD.

* Mapped control for searching for star names via the starmap:
  press B in the starmap to bring up a prompt.

* Mapped control for quitting super-melee mode: SELECT is the
  default.

* Diagonal controls are fixed.

* Further speed improvements to planetary lander:
  Smoother than ever, but RAM tweak in GMenu2X  MUST be enabled 
  to see the improvements.    

* Full-screen blits are now handled by a custom ARM ASM routine.
  TV-Out mode does now allow this, however, so a slight 
  overclock when using TV Out might be necessary for
  smoothness if you play the single-player game.  Melees are
  always full-speed no matter what.

* Squidge's MMU hack is now loaded to speed up blits.

* Internal sound mixing is now entirely done with integer math.

* Options in the setup menu that don't work with the GP2X 
  version are not saved.  This includes control re-configuration.


INSTALLATION:
-------------
Extract the .ZIP file into any folder on your SD. Extract
using full pathnames so all subfolders are created 
properly.  Note that this version allows installation anywhere
on the SD, which is an improvement over previous ports.

I *highly* recommended you download the alien voice acting 
package, as it adds a lot to the game. Download 
the file "uqm-0.6.0-voice.uqm" from this website:

http://sc2.sourceforge.net/downloads.php

and place the voice file into the content\packages folder.

If you already have the 0.5.0 version of this file from
the old Foehammer port, copy it over and rename it, it 
hasn't changed since 0.5.0.

If you have saved games from older ports of this game, 
copy them into the save\ folder.  They seem to be
compatible.

WHAT IF I ACCIDENTALLY SCREW UP THE CONFIGURATION?
--------------------------------------------------

There is a back of the main configuration, uqm.cfg.bak, which you 
can copy over a faulty uqm.cfg.

Additionally, you can reset the controls to their
defaults using my UQM2XCFG utility.


CONTROLS:
---------
   
Same as Foehammer's port, with a few extras:

A: 	Primary Fire / Menu Select
Y: 	Secondary Fire
B:  	Lander return, Starmap search
R/L:  	Zoom starmap in and out
CLICK:  Search for star name in star map
START:	Menu/Cancel
SELECT:	Exit Super Melee or main game
R:	Thrust
VOL+/-: Master volume


USB JOYSTICKS:
--------------

Launch uqm2xcfg.gpe and you can configure up to two external 
joysticks.  Back inside the main game, you may adjust which
controllers Players 1 and 2 will use.  You can then play Super
Melee with a friend!  You may use the GP2X for one of the
controllers if you have only one USB joystick.  You may also
play the entire single player game, with all functionality,
using just one USB joystick.

HELP FOR NEWBIES:
----------------

The UQM wiki has this help for users new to the game:

http://uqm.stack.nl/wiki/Non-Spoiler_Hints

http://uqm.stack.nl/wiki/First_Things_To_Do


KNOWN PROBLEMS:
---------------

*  After finishing Super Melee, the user must press a
   button to continue, but no prompt is given.  This is
   a bug in UQM itself, not my port.  It might someday
   be fixed by the core team.

OLDER VERSION HISTORY:
----------------------

Version 1.0

* GCC4 automatic compiler profiling has been applied to both
  the game and the integrated libTremor .OGG decoding library.
* Some sprite handling code has been rewritten to be faster
  on ARM architectures.
* 3DO .OGG music files have been re-encoded and downsampled to
  22050hz.  The GP2X's output isn't very high quality; no one
  will notice the difference.  .MODs already were 22050hz.
* The above three things allow usage of the planetary lander
  at full 24fps speed in almost all cases.  No overclocking
  or RAM tweak should be needed.
* Volume buttons work.  You can set the intial mixer volume
  using GMenu2X if you prefer to start the volume lower.  The
  program will respect the setting.  Volume buttons can then
  be used in-game.  Sound settings in configuration menu can
  be used to adjust the relative volume of music/speech/
  samples.
* The game can now be installed anywhere you like on the SD.

Beta 1

*  Smaller memory footprint.  Should help increase 
   program stability.
*  Large amount of previously unused compiler
   optimizations have been applied.
*  Integration of ARM ASM memory handling routines.
*  Lowered default sound sample rate to 22050hz.
*  The above three additions enable smoother use of the 
   planetary lander.  I no longer overclock UQM, all I
   enable is the advanced RAM timings from GMenu2X and
   it is quite playable at 200mhz.
*  Fixed text scrolling when using 3DO voice package.
*  Added sync() on exit to avoid loss of save data.
*  No crashes have been reported by testers
