
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.1.0 released 11.11.2011

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

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

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.exe' will start the game.
  (For the Spanish language version, please use 
  Spanish-SpaceTime-Quest.exe to start the game.)

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
  the file SpaceTimeQuest from the command line. If it starts, but
  no window appears, you might want to try again several times.


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
   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.

This 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.

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 
  ---

