Skip to content

neozeed/ssystem-1.6

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ssystem-saturn

OpenGL ssystem 1.6 Feb-26-1999

What is ssystem:

ssystem is an OpenGL Solar System simulator. Visit the Sun, the

nine planets and a few major satellites (catalog based background stars are also supported) with four camera modes.

Accuracy notes:

Although ssystem is not 100% accurate I've tried to keep it as close

to reality as possible. However, ssystem's goal has always been visual appearence rather than accuracy, so you may find many bugs in positioning algorithms.

Only planets and Moon positions are within a range of real positions, 

all other satellites (even though their orbits are, more or less, accurate) are NOT in their real positions (yet).

System requeriments:

-Linux/UNIX or Windows 95/NT OS
-OpenGL library (Mesa 3.0 recommended)
-GLUT library (v3.7 or higher required)
-JPEG library (the IJG one)
-3D accelerator (NOT REQUIRED but HIGHLY RECOMENDED) tested on:
	Voodoo Graphics (linux and win95/98)
	Voodoo2		(linux and win95/98)
	Voodoo Rush	(linux and win95/98)
	Riva 128	(win95/98)
	Riva TNT	(win95/98)
	Permedia	(win95/98)

If your 3d chipset is not listed above and ssystem runs hardware

accelerated let me know.

See Makefile for compile time options.

Command line options:

-bench	

	Aborts program execution after 1000 frames, displaying
	framerate

-fullscreen [mode_string]

	Runs program in full screen mode. Under Linux/UNIX machines
	you won't be able to switch video modes so you don't have
	to supply a mode_string (in fact, ssystem will complain if
	you do so).

	Windows 95/98 version lets you choose the videomode. Just 
	add a mode string after the fullscreen keyword. Mode string
	sintax is:

		WIDTHxHEIGHT:COLOR_DEPTH@REFRESH_RATE

	Refresh rate is optional. So if you want to run ssystem at
	640x480 32 bits colordepth your command line is something like:

		ssystem -fullscreen 640x480:32

	If you want a 100 Hz refresh rate then type:

		sssytem -fullscreen 640x480:32@100


	NOTE: NOT ALL VIDEOMODES ARE SUPPORTED. ONLY A FEW ONES
	WORK ON MY COMPUTER. IF THE VIDEO MODE YOU'VE SELECTED IS 
	NOT SUPPORTED SSYSTEM USES CURRENT VIDEO MODE.

Performance:

Hardware acceleration is not required, but highly recommended for

smooth framerates. I get 83fps (running on Linux) with the "-bench" command line option on my Celery 450 and 56fps at 1024x768:32 (running on win98 with a Riva TNT card). Ssystem rocks in this video mode.

The Planets' Sphere detail (SLICES and STACKS) is the key factor in 

performance, people with slow CPUs should use lower values (see ssystem.conf file).

Keyboard bindings:

Home/End: Selects previous/next target body
SHIFT + Home/End: Selects previous/next source body in B2B camera mode
Insert: Current planet trail on/off
h : Online help
a : Atmosphere on/off
t : Texture on/off
l : Lighting on/off
f : Flat/Smooth shading model
r : Real time on/off
s : Stars on/off
S : Screenshot (in JPEG format)
m/M : Increase/Decrease star brightness
d : Demo mode on/off
n : Moves camera near current planet
c : Camera modes
o/O : Wider/Narrower FOV
p : Pause
b : Distant bodies labels on/off
B : Stars labels on/off
i : Info (HUD) on/off
j : Joystick control on/off
Page Up/Down: Increase/decrease speed
z/Z: Increase/decrease zoom factor
	(only available in B2B and orbiter camera modes)

Hold SHIFT for faster operation in the following key bindings:

+/-: Increase/Decrease time factor
Arrow keys: Rotate camera

Camera modes:

There are 4 camera modes:

-Linked: This is the default mode. Camera follows the selected body.
 'n' is very useful in this mode.

-Body to Body: This mode lets you view body X as seen from body Y.

-Orbiter: Camera moves around the select body in a circular orbit (
 completes an orbit in 0.5 local days). Try the zoom key 'z' in this
 mode.

-Free Camera: You control the camera with arrow keys/josytick/mouse.

Camera movement:

-Keyboard

When in free camera mode arrow keys rotates camera, Page Up/Down 
increase/decrease camera speed.

Linked mode is a bit different, here arrow keys are useless. You can
move the camera towards the planet by increasing speed. Once you're
near the planet program sets camera speed to zero.

-Mouse

In free camera mode you can control the camera with the mouse by left
clicking over the window (keep it pressed)  and moving the mouse.

-Joystick

As with the mouse you have to select free camera mode, then activate
joystick (j). X and Y axis control camera, buttons A and B control
acceleration. Press C or D button buttons to set camera speed to 0
(if your joystick has only two buttons you can achieve this by
pressing A and B simultaneously)

Known bugs:

Outer bodies movement is a bit jerky. Although ssystem uses double

precision floating point arithmetic, Mesa uses simple precision arithmetic internally. Tuning scales i've been able to reduce this annoying effect (only Charon is highly affected). The good news: I know how this effect can be solved; the bad news: this will requiere a total rewrite of large parts of the code so i guess it should wait for the next release :-(

If you're seeing black lines across the planets this is not a bug.

Ssystem default to "unbordered" textures (which work fine on most 3D hardware) but software-only OpenGL drivers and maybe some hardware accelerated drivers requiere bordered textures. Simply edit ssystem.conf and set border=1 (remove the # char in line 18). Some 3D hardware won't work if border is set to 1 (3Dfx).

Fullscreen modes will only work properly under drivers supporting

the current video mode (*nix) or the video mode you have supplied in the command line (win32). If you force fullscreen mode and your hardware does not support the video mode ssystem won't work (properly).

ACKNOWLEDGEMENTS:

-Brian Paul (Mesa) http://www.ssec.wisc.edu/~brianp/MesQ.html

-Daryll Strauss (Linux Glide)

-David Bucciarelli (Mesa 3dfx driver) http://www-hmw.caribel.pisa.it/fxmesa/index.shtml

-Curtis L. Olson (star catalog stuff)

-This software is based in part on the work of The Independent JPEG Group

-Galilean and Saturn satellites computed using code extracted with permission from XEphem, (c) 1997 Elwood Charles Downey http://iraf.noao.edu/~ecdowney/xephem.html

-Keith Burnett's planet positioning algorithm used with persmission. http://www.xylem.demon.co.uk/kepler/

-Nacho (beta testing)

-Kevin Kamel (US mirror)

-Rafael Barbera (v1.4 performance improvement trick)

-Aaron Worley and his orrery simulation (configuration file and many ideas) http://hirame.hiram.edu/~worleyam/hitch/index.html

-Elias Martenson (SUN Makefile)

-Andrey Zakhvatov (FreeBSD stuff)

-Mike Oliphant and Rob Clark (screenshot function)
http://www.ling.ed.ac.uk/~oliphant/pyro

-John Kilburg and Bill Spitzak (SGI Makefiles)

-Bjorn Jonsson (Io, Europa and Saturn textures)

-Larry Manley (MoonPos, PlutoPos function and VSOP87 stuff, see astrolib.c)

-Tigran A. Aivazian (bug reports and suggestions)

-Axel Groll (extensive beta testing)

-And of course, thank you :-)

NOTE:

This is my first OpenGL program and i guess it will be always in

development, so I'd really appreciate your feedback.

Constructive criticism is always welcome. :-)

Check ssytem homepage for updates and news:

		http://www1.las.es/~amil/ssystem

Raul Alonso amil@las.es