Space Time Quest
-----------------

This is a strategy game in which the player has to use a limited 
budget to design a gravitational wave detector. Copyright by 
Daniel Brown, Paul Fulda, Ludovico Carbone and Andreas Freise, 
2010 onwards.

The game webpage: http://www.gwoptics.org/processing/space_time_quest/
Ebook with related science information: http://www.gwoptics.org/ebook/
Online high score: http://www.gwoptics.org/stq_highscore

Version 1.2 released 01.08.2012

Installation
-----------------

Mac OS X:
  The zip file for the OS X version includes and application bundle 
  `SpaceTimeQuest.app', just double-click the file to start the game.

Windows:
  The Windows version comes as a zip file, unzipping it will create 
  a new folder called `SpaceTimeQuest': double-clicking the file 
  `spacetimequest-setup.exe' will install the game.
  
  To play the game from the start menu goto:  
  
       gwoptics.org > Space-Time Quest 1.2
  
  and select your language choice

Linux:
  Unfortunately the Linux version does not run on many machines which
  is probably related to our use of OpenGL. The Linux version is
  provided in case you want to try but we cannot support it at the
  moment. For installation, unzip the downloaded file and start
  e.g. the file SpaceTimeQuest-English from the command line. If it 
  starts, but no window appears, you might want to try again several 
  times.

In order to run the game you must have a 32bit version of Java 1.5 
(or higher) installed and an OpenGL capable computer.


Advanced Usage
----------------

Space Time Quest allows a few parameters so be set via command line
arguments. For this you must start the game in a terminal window,
going into the game folder and typing:

Mac OS X:  open -a "SpaceTimeQuest.app" --args parameter1=value parameter2=value ...
Windows:   spacetimequest.exe parameter1=value parameter2=value ...
Linux:     ./SpaceTimeQuest parameter1=value parameter2=value ...

Currently the following settings are possible:

1. parameter: language, possible values: English, Spanish, Catalan
   and Chinese
   This parameter overwrites the default language settings
   (yes, in fact, you can download the default version and switch
   to a different language using this parameter). More versions
   in different languages are being prepared.

2. parameter: present, possible values: 0,1
   When started with present=1 the game will start in full screen
   mode (this is in fact Processing's `present mode), hiding the
   background and other applications. We recommend to manually
   set the screen resolution to a appropriate value (i.e. 800x600
   or slightly higher) before starting the game.

   On Mac OS X this mode often leaves the dock and the menu bar 
   visible. It is possible to auto-hide those whenever SpaceTimeQuest 
   is started, however you need to edit one file with a text editor:
   Control-click on the SpaceTimeQuest.app, choose `Show Package
   Contents' from the pop-up menu, and then navigate into the Contents 
   folder. Then open the file Info.plist with a text editor and add
   the following key-value pair to the list:
  
   <key>LSUIPresentationMode</key>
   <integer>4</integer> 

   The value 4 suppresses menu bar and dock, however, they become
   visible when the mouse hovers over them. Alternatively you might
   want to set the value to 3 which completely hides dock and menu
   bar while Space Time Quest is running (this might be best when
   running the game at a fair or exhibition).

   Alternatively open the file with the Property Editor (default for
   this file type) and add the key `Application UI Presentation mode' 
   and type in `4' or '3' in the value field. This is just an 
   alternative editing method to achieve the same as above.

3. parameter: tag, values: user-defined word
   This parameter allows to set a so-called `event tag'. This tag
   will be transmitted to the online high score page. It is
   then possible to only show the score with the same tag, for example
   http://www.gwoptics.org/stq_highscore?tag=UIBfrikis shows only
   the scores from a science event hosted by our Spanish 
   colleagues at the Universidad de las Islas Baleares.


Copyright notice
----------------

Space Time Quest Copyright (C) 2010 onwards by Daniel Brown, Paul 
Fulda, Ludovico Carbone and Andreas Freise.

- The binary version for Windows (the SOFTWARE) has been created with 
  Excelsior JET http://www.ExcelsiorJET.com/.
  The SOFTWARE is provided free of charge, You may make copies of 
  the SOFTWARE as you wish; give exact copies of the original 
  SOFTWARE to anyone; and distribute the SOFTWARE in its unmodified 
  form via electronic means.

  You may not charge any fees for the copy or use of the SOFTWARE
	itself. You must not represent in any way that you are selling the 
  SOFTWARE itself. Your distribution of the SOFTWARE will not entitle
	you to any compensation. You must distribute a copy of this
	Copyright Notice with any copy of the SOFTWARE and anyone to whom 
  you distribute the SOFTWARE is subject this Copyright Notice.

  THE SOFTWARE AND ANY RELATED DOCUMENTATION IS PROVIDED "AS IS"
	WITHOUT  WARRANTY OF ANY KIND; without even the implied warranty 
  of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
  THE ENTIRE RISK ARISING OUT OF USE OR PERFORMANCE OF THE SOFTWARE 
  REMAINS WITH YOU.

- The source code of Space Time Quest is covered by a GPL 2 
  license:

  The 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 2
  of the License, 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., 51 Franklin Street, Fifth Floor, Boston, 
  MA  02110-1301, USA.


Acknowledgement and further Copyright statements
------------------------------------------------

The code of this game is available under the GPL open source 
license, see above, but the included graphics and other 
media as well as used libraries libraries are covered by 
separate copyright licenses.

The Spanish translation has been provided by
Sara Gil Casanova, the Catalan version is by
Alex Va Viuales and the Chinese translation 
was performed by Mengyao Wang.

Space Time Quest has been build with Processing
and includes the Processing core libraries.
http://www.processing.org/

It uses a number of contributed Processing libraries:

- `GUI for Processing' by Peter Lager
  http://www.lagers.org.uk/g4p/index.html
  http://gui4processing.googlecode.com/svn/trunk/
  covered by a LGPL license:

  ---
  Copyright (c) 2008-09 Peter Lager

  This library is free software; you can redistribute it and/or
  modify it under the terms of the GNU Lesser General Public
  License as published by the Free Software Foundation; either
  version 2.1 of the License, or (at your option) any later version.

  This library 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
  Lesser General Public License for more details.

  You should have received a copy of the GNU Lesser General
  Public License along with this library; if not, write to the
  Free Software Foundation, Inc., 59 Temple Place, Suite 330,
  Boston, MA  02111-1307  USA
  ---

- Scientific plotting library `gwoptics' by Daniel Brown and Andreas Freise
  http://www.gwoptics.org/processing/gwoptics_p5lib/
	file: gwoptics.jar
  covered by a LGPL license:
  ---
  Copyright notice
  
  This file is part of the Processing library `gwoptics' 
  http://www.gwoptics.org/processing/gwoptics_p5lib/
  
  Copyright (C) 2009 onwards Daniel Brown and Andreas Freise
  
  This library is free software; you can redistribute it and/or modify it under 
  the terms of the GNU Lesser General Public License version 2.1 as published 
  by the Free Software Foundation.
  
  This library 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 Lesser General Public License for more details.
  
  You should have received a copy of the GNU Lesser General Public License along with 
  this library; if not, write to the Free Software Foundation, Inc., 59 Temple Place, 
  Suite 330, Boston, MA 02111-1307 USA
