GitHub - alex-w/spacecrafter: Spacecrafter sources

Branches Tags

Name		Name	Last commit message	Last commit date
Latest commit History 3,281 Commits
cmake		cmake
data		data
doc		doc
include		include
iniparser		iniparser
lib		lib
planetsephems		planetsephems
shaders		shaders
src		src
util		util
www		www
.gitignore		.gitignore
.gitmodules		.gitmodules
AUTHORS		AUTHORS
CMakeLists.txt		CMakeLists.txt
COPYING		COPYING
INSTALL		INSTALL
LICENSE		LICENSE
README		README
TRADEMARKS		TRADEMARKS
debug.bat		debug.bat
install_dependancies_mageia.sh		install_dependancies_mageia.sh
install_dependancies_ubuntu.sh		install_dependancies_ubuntu.sh
install_src.bat		install_src.bat
install_src.sh		install_src.sh

Repository files navigation

SPACECRAFTER 2024

http://www.lss-planetariums.info/spacecrafter

SpaceCrafter comes with ABSOLUTELY NO WARRANTY. See the LICENSE file for details.

For the SpaceCrafter User Guide see the "doc" directory.

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

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

--------------------------------------------------------------------------------
1. INTRODUCTION
--------------------------------------------------------------------------------
SpaceCrafter is free open source (GPL) astronomy and Earth science simulation
and visualization software which renders realistic views around our solar
system in real time with openGL. It is available for Linux/Unix.

SpaceCrafter was branched from Nightshade 11.12.1 in January, 2012. Our focus is
on planetarium and simulator use and to provide updates in the future.
Desktop use and Spherical mirror is no more supported.

Nightshade was branched from Stellarium 0.8.2 in August, 2006. Their focus was
on planetarium and simulator use, although desktop use is also supported.
http://www.nightshadesoftware.org

Note that the '`' (back tick) key is the equivalent of the shift button on a
Digitarium (R) planetarium system remote control.

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

--------------------------------------------------------------------------------
3. REQUIREMENT
--------------------------------------------------------------------------------
Linux environment (preferably Ubuntu)
A Vulkan acceleration video card (WITH CURRENT DRIVERS!) and a good CPU.

--------------------------------------------------------------------------------
4. QUICK START
--------------------------------------------------------------------------------
Navigation :
Use the direction keys or drag with the mouse to move the point of view.
Use page up and page down keys or mouse wheel to zoom in and out.
Use left mouse button to select an object, right button to select no object.

Zooming on nebulas or planets is very interesting....
Use J, K and L to increment/decrement time speed.
See documentation on the website for other functions.

--------------------------------------------------------------------------------
5. CONFIGURATION
--------------------------------------------------------------------------------
The most useful configuration options can be set from within the program.

You can however change it by hand in the file $HOME/.spacecrafter/config.ini on
a Linux system.

--------------------------------------------------------------------------------
6. TROUBLESHOOTING
--------------------------------------------------------------------------------
Runtime diagnostic information is output to the console while spacecrafter is
running. The information can be useful to debug certain Stratoscript calls.
On Windows platforms this information is output to two files, stdout.txt and
stderr.txt in Spacecrafter's root directory. Windows7 and Vista users must run
Spacecrafter as administrator to enable this diagnostic output.

--------------------------------------------------------------------------------
7. THANKS
--------------------------------------------------------------------------------

++ Special thanks to ++

Fabien Chereau for starting the Stellarium project on which Spacecrafter
is based.

Johannes Gajdosik for his work on planets computation and projection.

Lionel Ruiz for patches and feedback.

Johan Meuris for his stuning drawings of the constellations.

Matthew Gates for his huge work on the (Stellarium) User Guide.

Tony Furr for his work on the Graphical User Interface.

Valery Lainey for his L1 and MarsSat ephemeris and his prompt an kind help
with any question concerning planetary/satellite ephemeris.

++ Thanks to ++

Axel Mellinger who gave authorisation to use his impressive
milky way panorama.
Jesse Jones for his callback library.
The celestia project team for many code parts (GPL license).
The libnova team for their planet calculation algorithms (GPL license).
All the SDL team for their remarkable work.
Cedric 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-Francois 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.
Antje Buchholz for her translation help and logistic support :)

--------------------------------------------------------------------------------
8. NOTE
--------------------------------------------------------------------------------
This program is free, but if you have nothing to do with your
money, just go there and do something usefull with it :
http://www.darksky.org/

--------------------------------------------------------------------------------
9. 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
See section 10.2 for full license. (Removed in 10.10.1).
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 license)
2.5 Other pieces of code and ideas are from Celestia too (GPL license).
2.6 Callback library by Jess Jones, see section 10.4 for full license.
2.7 Several implementations of IMCCE theories for planet and satellite
movement by Johannes Gajdosik (MIT-style license,
see the corresponding files for the license text)
2.8 Julian <-> Calendar date conversion algorithms adapted from
Javascript by Steve Glennie-Smith.

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 IMCCE and partly from Celestia.
3.3 Polynesian constellations are based on diagrams from the Polynesian
Voyaging Society
3.4 Chinese constellations are based on diagrams from the Hong Kong Space Museum
3.5 Egyptian constellations are based on the work of Juan Antonio Belmonte,
Instituto de Astrofisica de Canarias

4. Graphics
4.1 All graphics are copyrighted by Digitalis Education Solutions, Inc. (GPLv3+)
unless otherwise mentioned below :
4.2 The Earth texture is a NASA Blue Marble image (public domain)
4.3 The night Earth texture and Earth cloud textures are from the
NASA Visible Earth team, http://visibleearth.nasa.gov/
For all non-private uses, NASA's Terms Of Use are as follows:
1. The imagery is free of licensing fees
2. NASA requires that they be provided a credit as the owners of the imagery
4.4 Planet textures are either from Stellarium (http://stellarium.org)
or Celestia (both GPLv2+)
4.6 The fullsky milky way panorama is copyright 2000 Axel Mellinger.
Further information and more pictures available from
http://home.arcor-online.de/axel.mellinger/
License: permission given to "Modify and redistribute this image if proper
credit to the original image is given."
4.7 Most Messier nebula photos from the Grasslands Observatory :
"Images courtesy of Tim Hunter and James McGaha, Grasslands Observatory
at http://www.3towers.com."
License: permission given to "use the image freely" (including right to
modify and redistribute) "as long as it is credited."
4.8 M31 and Rosetta photos come from Herm Perez :
http://home.att.net/~hermperez/default.htm
License: "Feel free to use these images, if you use them in a commercial
setting please attribute the source."
4.9 Pleiades photo courtesy Tim Puckett. Other nebula photos credited in
the data/nebula_textures.fab file. "HST" credited images are public
domain images from the Hubble Space Telescope:

"Material credited to STScI on this site [hubblesite.org] was created, authored,
and/or prepared for NASA under Contract NAS5-26555. Unless otherwise
specifically stated, no claim to copyright is being asserted by STScI
and it may be freely used as in the public domain in accordance with NASA's
contract. However, it is requested that in any subsequent use of this work NASA
and STScI be given appropriate acknowledgement. STScI further requests voluntary
reporting of all use, derivative creation, and other alteration of this work.
Such reporting should be sent to [email protected]."

STScI is operated by the Association of Universities for research in Astronomy,
Inc. under a contract with the National Aeronautics and Space Administration.
4.11 Western and Inuit constellation art, GUI buttons created by Johan Meuris (Jomejome)
(jomejome at users.sourceforge.net ) http://users.pandora.be/jomejom/
License: released under the Free Art License
(http://artlibre.org/licence.php/lalgb.html)
4.12 Western and Inuit constellation art coloring by Erasmo Sesena
4.13 Hindu constellation art courtesy Vikas Nautiyal <vikas_nautiyal at hotmail.com>
4.14 Hevelius sky culture created by Mark Crossley. Images courtesy of U.S. Naval
Observatory and the Space Telescope Science Institute. Some images also
from Wikipedia.

--------------------------------------------------------------------------------
10. LICENSE
--------------------------------------------------------------------------------

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 3
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 LICENSE file for more information regarding the GNU General
Public License.

Spacecrafter is a free project of the LSS TEAM

Nightshade is a registered trademark and StratoScript is a trademark
of Digitalis Education Solutions, Inc. See the TRADEMARKS file for
trademark usage requirements.

--------------------------------------------------------------------------------
11. APPENDIX
--------------------------------------------------------------------------------
1. Full credits for image 4.2 :
Author: Reto Stockli, NASA Earth Observatory, rstockli (at) climate.gsfc.nasa.gov
Address of correspondance:
Reto Stockli
ETH/IAC (NFS Klima) & NASA/GSFC Code 913 (SSAI)
University Irchel
Building 25 Room J53
Winterthurerstrasse 190
8057 Zurich, Switzerland
Phone: +41 (0)1 635 5209
Fax: +41 (0)1 362 5197
Email: rstockli (at) 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)

License :
"Any and all materials published on the Earth Observatory are freely available
for re-publication or re-use, except where copyright is indicated."

2. License for the GLpng library
/*
* PNG loader library for OpenGL v1.45 (10/07/00)
* by Ben Wyatt [email protected]
* Using LibPNG 1.0.2 and ZLib 1.1.3
*
* This software is provided 'as-is', without any express or implied warranty.
* In no event will the author be held liable for any damages arising from the
* use of this software.
*
* Permission is hereby granted to use, copy, modify, and distribute this
* source code, or portions hereof, for any purpose, without fee, subject to
* the following restrictions:
*
* 1. The origin of this source code must not be misrepresented. You must not
* claim that you wrote the original software. If you use this software in
* a product, an acknowledgment in the product documentation would be
* appreciated but is not required.
* 2. Altered versions must be plainly marked as such and must not be
* misrepresented as being the original source.
* 3. This notice must not be removed or altered from any source distribution.
*/

3. License for the JPL planets images (http://www.jpl.nasa.gov/images/policy/index.cfm)
---
Unless otherwise noted, images and video on JPL public web sites (public sites
ending with a jpl.nasa.gov address) may be used for any purpose without prior
permission, subject to the special cases noted below. Publishers who wish to
have authorization may print this page and retain it for their records; JPL
does not issue image permissions on an image by image basis.
By electing to download the material from this web site the user agrees:
1. that Caltech makes no representations or warranties with respect to
ownership of copyrights in the images, and does not represent others who may
claim to be authors or owners of copyright of any of the images, and makes no
warranties as to the quality of the images. Caltech shall not be responsible
for any loss or expenses resulting from the use of the images, and you
release and hold Caltech harmless from all liability arising from such use.
2. to use a credit line in connection with images. Unless otherwise noted in
the caption information for an image, the credit line should be "Courtesy
NASA/JPL-Caltech."
3. that the endorsement of any product or service by Caltech, JPL or NASA must
not be claimed or implied.
Special Cases:
* Prior written approval must be obtained to use the NASA insignia logo (the
blue "meatball" insignia), the NASA logotype (the red "worm" logo) and the
NASA seal. These images may not be used by persons who are not NASA employees
or on products (including Web pages) that are not NASA sponsored. In
addition, no image may be used to explicitly or implicitly suggest
endorsement by NASA, JPL or Caltech of commercial goods or services. Requests
to use NASA logos may be directed to Bert Ulrich, Public Services Division,
NASA Headquarters, Code POS, Washington, DC 20546, telephone (202) 358-1713,
fax (202) 358-4331, email [email protected].
* Prior written approval must be obtained to use the JPL logo (stylized JPL
letters in red or other colors). Requests to use the JPL logo may be directed
to the Television/Imaging Team Leader, Media Relations Office, Mail Stop
186-120, Jet Propulsion Laboratory, Pasadena CA 91109, telephone (818)
354-5011, fax (818) 354-4537.
* If an image includes an identifiable person, using the image for commercial
purposes may infringe that person's right of privacy or publicity, and
permission should be obtained from the person. NASA and JPL generally do not
permit likenesses of current employees to appear on commercial products. For
more information, consult the NASA and JPL points of contact listed above.
* JPL/Caltech contractors and vendors who wish to use JPL images in
advertising or public relation materials should direct requests to the
Television/Imaging Team Leader, Media Relations Office, Mail Stop 186-120,
Jet Propulsion Laboratory, Pasadena CA 91109, telephone (818) 354-5011, fax
(818) 354-4537.
* Some image and video materials on JPL public web sites are owned by
organizations other than JPL or NASA. These owners have agreed to make their
images and video available for journalistic, educational and personal uses,
but restrictions are placed on commercial uses. To obtain permission for
commercial use, contact the copyright owner listed in each image caption.
Ownership of images and video by parties other than JPL and NASA is noted in
the caption material with each image.
---

4. License for the callback library by Jesse Jones :
(C) Copyright Jesse Jones 2000. Permission to copy, use, modify, sell
and distribute this software is granted provided this copyright
notice appears in all copies. This software is provided "as is" without
express or implied warranty, and with no claim as to its suitability for
any purpose.