
				  ## ### ### #   #   ### ###  #  # # # #
                  #   #  ##  #   #   ### ##   #  # # ###
                 ##   #  ### ### ### # # # #  #  ### # #

                By Fabien Chéreau : stellarium (at) free.fr
                    Info : http://stellarium.free.fr

Stellarium comes with ABSOLUTELY NO WARRANTY.  See the COPYING file for details.

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

1. INTRODUCTION                  6. THANKS
2. INSTALLATION INSTRUCTIONS     7. NOTE
3. REQUIREMENT                   8. FULL REFERENCES & CREDITS
4. QUICK START                   9. LICENSE
5. CONFIGURATION

--------------------------------------------------------------------------------
1. INTRODUCTION
--------------------------------------------------------------------------------
Stellarium is a free software available for Windows, Linux/Unix and MacOSX. It
renders 3D photo-realistic skies in real time.
With stellarium, you really see what you can see with your eyes, binoculars or
a small telescope.

--------------------------------------------------------------------------------
2. INSTALLATION INSTRUCTIONS
--------------------------------------------------------------------------------
Please see the INSTALL file.

--------------------------------------------------------------------------------
3. REQUIREMENT
--------------------------------------------------------------------------------
Windows or linux/POSIX or CYGWIN or MACOSX environement
A 3d openGL acceleration card and a good CPU.

--------------------------------------------------------------------------------
4. QUICK START
--------------------------------------------------------------------------------
Navigation :
Use the direction keys to move the point of view.
Use page up and page down keys to zoom in and out.
Use left mouse button to select an object, right button to select no object and
middle mouse button or SPACE to center on the selected object.
Zooming on nebulas or planets is very interesting....
Use J, K and L to increment/decrement time speed.
Press the H key for more help.

--------------------------------------------------------------------------------
5. CONFIGURATION
--------------------------------------------------------------------------------
From version 0.6.0 the most useful configuration options can be set from within
the program.
You can however change it by hand in the file located in config/config.ini on
Windows/MacOSX and in $HOME/.stellarium/ on a unix system.

--------------------------------------------------------------------------------
6. THANKS
--------------------------------------------------------------------------------

	++ Special thanks to ++
	
	Rob Spearman (Digitalis Education) for his help and financial support. 
	Have a look at http://digitaliseducation.com if you want to buy a 
	planetarium projector running stellarium!

	Johan Meuris for his stuning drawings of the constellations.
	
	++ Thanks to ++
	
	Fumio Yamamoto for his MacOSX package, patches and documentation.
	Axel Mellinger who gave me the authorisation to use his impressive
	    milky way panorama.
	Jesse Jones for his callback library.
	The celestia project team from which I borrowed many code parts.
	The libnova team for their planet calculation algorithms.
	All the SDL team for their remarquable work.
	All the sourceforge team for hosting my project.
	Cédric Delfosse for his precious help on debian port.
	The GEPI team from the Observatoire Astronomique de Paris for 
		the great Hipparcos catalog.
    Brad Schaefer for his sky rendering algorithm.
    Sylvain Ferey for his optimisation of the grids drawing.
    Ben Wyatt (ben (at) wyatt100.freeserve.co.uk) for the Glpng library.
    Jean-François Tremblay for his porting on MacOSX.
	Vincent Caron for his parser bugfix and Linux compatibility bugfixes.
	Nick Porcino for his planet function.
    Tangui Morlier for his help on Linux System.
	Bill Gray (projectpluto.com) and Mark Huss (mark (at) mhuss.com) for all
	    the astro libraries.
    Chris Laurel (claurel (at) shatters.net) who makes Celestia.
	Yuuki Ninomiya (gm (at) debian.or.jp) for the parsecfg file.

	And... All the people who sent me mails and bug reports!


--------------------------------------------------------------------------------
7. NOTE
--------------------------------------------------------------------------------
    This program is free, but if you have nothing to do with your
    money, just go there and do something usefull with it :
    https://www.greenpeace.com/forms/gpicontr.html


--------------------------------------------------------------------------------
8. FULL REFERENCES & CREDITS
--------------------------------------------------------------------------------
1. Technical Articles
	1.1 The tone reproductor class
		The class mainly performs a fast implementation of the algorithm from
		the	paper [1], with more accurate values from [2]. The blue shift
		formula is taken from [3] and combined with the Scotopic vision
		formula from [4].
  		[1] "Tone Reproduction for Realistic Images", Tumblin and Rushmeier,
			IEEE Computer Graphics & Application, November 1993
  		[2] "Tone Reproduction and Physically Based Spectral Rendering",
			Devlin, Chalmers, Wilkie and Purgathofer in EUROGRAPHICS 2002
	  	[3] "Night Rendering", H. Wann Jensen, S. Premoze, P. Shirley,
			W.B. Thompson, J.A. Ferwerda, M.M. Stark
  		[4] "A Visibility Matching Tone Reproduction Operator for High Dynamic
			Range Scenes", G.W. Larson, H. Rushmeier, C. Piatko
	1.2 The skylight class
		The class is a fast implementation of the algorithm from the article
		"A Practical Analytic Model for Daylight" by A. J. Preetham, Peter
		Shirley and Brian Smits.
	1.3 The skybright class
		The class is a fast reimplementation of the VISLIMIT.BAS basic source
		code from Brad Schaefer's article on pages 57-60,  May 1998 _Sky &
		Telescope_,	"To the Visual Limits". The basic sources are available on
		the Sky and Telescope web site.
	1.4 Object luminance algorithm from GPL delphi program by Jan Hollan, 1999 (C)
		N.Copernicus Observatory and Planetarium in Brno.
		See http://svetlo.astro.cz/compute/lum.php

2. Included source code
	2.1 glpng PNG loader library for OpenGL v1.45 (10/07/00)
		by Ben Wyatt ben (at) wyatt100.freeserve.co.uk
	2.2 Iniparser library Copyright (c) 2000 by Nicolas Devillard.
	2.3 The stellastro and stellplanet libraries are mainly subsets of the
		libnova library (GPL) by Liam Girdwood (liam (at) nova-ioe.org)
	2.4 The orbit.cpp/h and solve.h files are directly borrowed from
		Celestia (Chris Laurel). (GPL)
	2.5 Other pieces of code and ideas are from Celestia too.

3. Data
	3.1 The Hipparcos star catalog
		From ESA (European Space Agency) and the Hipparcos mission.
		ref. ESA, 1997, The Hipparcos and Tycho Catalogues, ESA SP-1200
	3.2 The solar system data mainly comes from Celestia.

4. Graphics
	4.1 All graphics are copyrighted by Fabien Chéreau except the ones
		mentioned below :
    4.2 The Earth texture was created by NASA (Reto St¨ckli, NASA Earth 
		Observatory) using data from the MODIS instrument aboard the 
		Terra satellite. See section 4.2 in chapter	6 (NOTES) for full 
		credits.
	4.3 Mars texture map is from James Hastings-Trew's collection,
		http://gw.marketingden.com/planet
	4.4 Moon texture map is Courtesy USGS Astrogeology Research Program,
		http://astrogeology.usgs.gov. (Public Domain, DFSG-free)
  	4.5 All other planet maps from David Seal's site: http://maps.jpl.nasa.gov/
	4.6 The snowy landscape textures are from the GPL game tuxracer.
	4.7 The fullsky milky way panorama is created by Axel Mellinger, University
		of Potsdam, Germany. Further information and more pictures available from
		http://home.arcor-online.de/axel.mellinger/
	4.8 All messiers nebula pictures except m31, Orion and the Pleiades from
		the Grasslands Observatory : "Images courtesy of Tim Hunter and James 
		McGaha, Grasslands Observatory at http://www.3towers.com."
	4.9 M31, Orion and the Pleiades pictures come from Herm Perez :
		http://home.att.net/~hermperez/default.htm
   4.10 Constellation art created by Johan Meuris (Jomejome) 
   		(jomejome at users.sourceforge.net ) http://users.pandora.be/jomejom/

--------------------------------------------------------------------------------
5. LICENSE
--------------------------------------------------------------------------------
   Copyright (C) 2004 Fabien Chéreau chereau (at) free.fr

   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., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.

   See the COPYING file for more information regarding the GNU General
   Public License.

--------------------------------------------------------------------------------
6 NOTES :
--------------------------------------------------------------------------------
* Full credits for image 4.2 :
Author: 
Reto St¨ckli, NASA Earth Observatory, rstockli@climate.gsfc.nasa.gov

Address of correspondance:
Reto St¨ckli               
ETH/IAC (NFS Klima) & NASA/GSFC Code 913 (SSAI)
University Irchel
Building 25 Room J53  
Winterthurerstrasse 190        
8057 Z¾rich 
Switzerland  

Phone:  +41 (0)1 635 5209     	
Fax:    +41 (0)1 362 5197
Email:  rstockli@climate.gsfc.nasa.gov

http://earthobservatory.nasa.gov
http://www.iac.ethz.ch/staff/stockli

Supervisors: 
Fritz Hasler and David Herring, NASA/Goddard Space Flight Center

Funding:
This project was realized under the SSAI subcontract 2101-01-027 (NAS5-01070)


